API
HomeEasytransac
HomeEasytransac
  1. Authentication
  • Start
    • API Domain Usage
    • Get an API key
    • Communication
  • Documentation
    • Errors
      • ApiError codes
    • Webhooks
      • PUSH Method
      • PULL Method
  • V2
    • Overview
    • Authentication
      • JWT access token - Generate
        POST
    • Endpoints
      • Open Banking
        • Open Banking - Initialize
      • SDD
        • SDD - Mandate - Create
        • SDD - Mandate - Debit
        • SDD - Mandate - Get status
      • Transaction
        • Transaction - Get status
  • V1
    • Documentation
      • Signature
    • Authentication
      • Overview
      • Security
      • PSD2 and 3DSecure
    • API - Payment
      • Recurring payments
      • Card payment
      • 1-click payment
      • SEPA Direct Debit
      • Transfer (Open Banking)
      • Payment page
      • Cancel a payment page
      • Resend the payment page
      • P2P Transfert
      • Update a subscription
      • Status
      • Refund
      • Capture
      • Cancellation
      • List of cards
      • List of IBANs
      • History
      • Payment requests
      • Card information
    • API - User
      • Add a merchant
      • Update a merchant
      • Search for a merchant
      • List of movements
      • Make a payout
      • List all payouts
      • Add a logo
      • Get the activity
      • Update activity
    • API - Document
      • Add a document
      • Get a document
      • List documents
  1. Authentication

JWT access token - Generate

Sandbox
https://api.sandbox.easytransac.com/v2
Sandbox
https://api.sandbox.easytransac.com/v2
POST
/auth
authentication
Generates a temporary JWT access token with your apiKey to be able to authenticate to the Easytransac API V2.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json
apiKey
string <password>
required
Your API key
>= 64 characters<= 64 characters
Match pattern:
^et_(live|test)_[a-z0-9]{11}-[a-z0-9]{8}-[a-z0-9]{8}-[a-z0-9]{8}-[a-z0-9]{8}-[a-z0-9]{8}$
Example
{
  "apiKey": "et_test_abcabcabc12-abcabc12-abcabc12-abcabc12-abcabc12-abcabc12"
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.sandbox.easytransac.com/v2/auth' \
--header 'Content-Type: application/json' \
--data-raw '{
    "apiKey": "et_test_abcabcabc12-abcabc12-abcabc12-abcabc12-abcabc12-abcabc12"
}'

Responses

🟢200OK
application/json
OK
Body
success
boolean 
required
Whether the action was successful
date
string <date-time>
required
Date of response (ATOM)
data
object 
required
Additional data
token
string 
required
JWT access token to use for authentication
>= 1 characters
expiresIn
integer 
required
Expiration time of the JWT access token (seconds)
>= 1
expiresDate
string <date-time>
required
Expiration date of the JWT access token (ATOM)
Example
{
  "success": true,
  "date": "2024-12-31T23:59:59+02:00",
  "data": {
    "token": "ABCabc123.ABCabc123.ABCabc123",
    "expiresIn": 300,
    "expiresDate": "2024-12-31T23:59:59+02:00"
  }
}
🟠400Bad Request
🟠401Unauthorized
Previous
Overview
Next
Open Banking - Initialize
Built with