Transaction Management

Create Transaction

post

Provide all required data to the Merchant/PSP to build a transaction authorization request.

In case of network token, the token PAN, expiry date and cryptogram are provided.

In case of PCI token, the card PAN and expiry date are provided.

Parámetros de encabezado

authorizationstring · mín: 1 · máx: 512Requerido

Technical identifier pre-defined at on-boarding that identifies the API consumer. Format shall be the string 'APIKEY' followed by a space and the api key value.
Example: APIKEY c03f88fe-01ba-11e8-ba89-0ed5f89f718b

x-correlation-idstring · mín: 1 · máx: 36Requerido

Technical identifier used for troubleshooting.
It helps on customer support when needed.
Each API request must be identified with a unique correlation Id.
It correlates the response and the request and eventually a notification if any.

Cuerpo

application/json

tokenIdstring · mín: 1 · máx: 128Requerido

The token identifier.

Pattern: ^[a-zA-Z0-9_-]+$

transactionTypestring · enum · máx: 64RequeridoExample: SINGLEValores posibles:

visaSignedPayloadstring · mín: 1 · máx: 4096Opcional

Required only for Visa CTF and Visa CTF with DAF. Set with the signature (JWT) generated by Thales ETP SDK.

Respuestas

201

Created

application/json

400

Bad request - Not Retryable

application/json

401

Unauthorized - Not Retryable

404

Not Found - Not Retryable

429

Too Many Requests - Retryable

500

Internal Server Error - Not Retryable

503

Service Unavailable - Retryable

post

/transactions

HTTPcURLJavaScriptPython

POST /tsh-cof/transactions HTTP/1.1
Host: thales.api.com
authorization: text
x-correlation-id: text
Content-Type: application/json
Accept: */*
Content-Length: 143

{
  "tokenId": "COFTG-M-ce464906-cf39-4990-b4a8-c160e67c603a",
  "transactionType": "SINGLE",
  "transactionData": {
    "amount": "12.84",
    "currencyCode": "EUR"
  }
}

{
  "transactionId": "COFTG-G-e141-0303e55b-5e14-4af4-9601-b268d3dfbb65",
  "encryptedData": "eyJhbGciOiJSU0EtT...GoWAB7Ucw",
  "eci": "07",
  "cryptogramExpiryDate": "2021-09-27T17:06:09.000Z"
}

Create Transaction v2

post

Provide all required data to the Merchant/PSP to build a transaction authorisation request.

Parámetros de encabezado

authorizationstring · mín: 1 · máx: 512Requerido

Technical identifier pre-defined at on-boarding that identifies the API consumer. Format shall be the string 'APIKEY' followed by a space and the api key value.
Example: APIKEY c03f88fe-01ba-11e8-ba89-0ed5f89f718b

x-correlation-idstring · mín: 1 · máx: 36Requerido

Technical identifier used for troubleshooting.
It helps on customer support when needed.
Each API request must be identified with a unique correlation Id.
It correlates the response and the request and eventually a notification if any.

Cuerpo

application/json

tokenIdstring · mín: 1 · máx: 128Requerido

The token identifier.

Pattern: ^[a-zA-Z0-9_-]+$

transactionTypestring · enum · máx: 64Requerido

The request content depends on the transaction type.

Example: EMV_TOKENValores posibles:

Respuestas

201

Created

application/json

400

Bad request - Not Retryable

application/json

401

Unauthorized - Not Retryable

404

Not Found - Not Retryable

429

Too Many Requests - Retryable

500

Internal Server Error - Not Retryable

503

Service Unavailable - Retryable

post

/v2/transactions

HTTPcURLJavaScriptPython

POST /tsh-cof/v2/transactions HTTP/1.1
Host: thales.api.com
authorization: text
x-correlation-id: text
Content-Type: application/json
Accept: */*
Content-Length: 160

{
  "tokenId": "COFTG-M-ce464906-cf39-4990-b4a8-c160e67c603a",
  "transactionType": "EMV_TOKEN",
  "EMV_TOKEN": {
    "isRecurring": false,
    "amount": "15.55",
    "currencyCode": "EUR"
  }
}

EMV Token TransactionVisa DAFMastercard TAF FIDOMastercard TAF IAAVMastercard THALES AUTHENTICATOR

{
  "transactionId": "COFTG-G-e141-0303e55b-5e14-4af4-9601-b268d3dfbb65",
  "encryptedData": "eyJhbGciOiJSU0EtT...GoWAB7Ucw",
  "eci": "07",
  "cryptogramExpiryDate": "2021-09-27T17:06:09.000Z"
}