ECOM Transaction API

TSP-API-OUT-v1-ECOM-Transaction-oas3.yaml

POST /merchant-gateways/{merchantGatewayId}/merchants/{merchantId}/tokens/{tokenId}/transactions

post

https://TSP_PROD_DOMAIN/tsp/ecomhttps://TSP_STAGING_DOMAIN/tsp/ecom

/merchant-gateways/{merchantGatewayId}/merchants/{merchantId}/tokens/{tokenId}/transactions

Path parameters

merchantGatewayIdstring · min: 10 · max: 10Required

Merchant Gateway Identifier.

Example: MGW_123456

merchantIdstring · min: 11 · max: 11Required

Merchant Identifier (aka Token Requestor ID) generated by the scheme TSP for that merchant.

Example: 10610027312

tokenIdstring · min: 1 · max: 48Required

Unique Token Identifier

Body

application/json

transactionIdstringRequiredExample: Rrn123456789Pattern: ^[A-Za-z0-9]{1,12}$

transactionDateTimestringRequired

UTC Transaction date in 'YYYYMMDDhhmmss' format.

Example: 20260225140530Pattern: ^[0-9]{14}$

amountstringRequired

smallest unit of currency right justified with leading zeros

Example: 000000002100Pattern: ^[0-9]{12}$

currencyCodestringRequired

Currency code as per ISO 4217

Example: 978Pattern: ^[0-9]{3}$

Responses

200

Transaction Created

application/json

encryptedDatastringOptional

The payment credentials data encrypted with JWE format (https://datatracker.ietf.org/doc/html/rfc7516) using following encryption parameters:

• JWE base64url encoded string
• "alg" (Algorithm) header parameter: ECDH-ES
• "enc" (Encryption Algorithm) header parameter: A256GCM
• "kid" (Key ID) header parameter: Key identifier corresponding to EC public key of the recipient
• EC curve: P-256 The JSON object that is encrypted is defined as follows:

JSON field parameter name	description	MOC	Length
dpan	The token PAN value	M	Up to 19
exp	The token expiry date in the format MMYY	M	4
cryptogram	The payment cryptogram to use with the token for a payment	M	Up to 256

Example: {"dpan:"9580981500100002", "exp":"1222", "cryptogram": "45f8grzty7f4f5gs5s2c"}

400

Error while performing the operation

application/json

500

Internal Server Error - Not retryable

503

Unavailable - Retryable

post

/merchant-gateways/{merchantGatewayId}/merchants/{merchantId}/tokens/{tokenId}/transactions

HTTPcURLJavaScriptPython

POST /tsp/ecom/merchant-gateways/{merchantGatewayId}/merchants/{merchantId}/tokens/{tokenId}/transactions HTTP/1.1
Host: TSP_PROD_DOMAIN
Content-Type: application/json
Accept: */*
Content-Length: 116

{
  "transactionId": "Rrn123456789",
  "transactionDateTime": "20260225140530",
  "amount": "000000002100",
  "currencyCode": "978"
}

{
  "encryptedData": "text"
}