API de aprovisionamiento y gestión de tokens

TSP-API-OUT-v1-Provisioning-Management-oas2.yaml

POST /tokens

post

This method is used by TSH to request the creation of a new token.

Parámetros de encabezado

x-request-idstring · mín: 1 · máx: 64Requerido

Unique request identifier use to trace function calls across system

Cuerpo

issuerIdstring · mín: 10 · máx: 10Requerido

Unique Identifier of Issuer

Example: ISSUER1234

cardRefIdstring · mín: 1 · máx: 64Requerido

A unique identifier of the issuer that aims to identify the funding card.
This parameter is provided by the TSH.
Upon configuration it corresponds either to issuerCardRefId or walletCardRefId (e.g. for ApplePay, it corresponds to the FPANID in such case)

walletProviderIdstring · mín: 1 · máx: 32Opcional

Wallet Provider identifier, defined by Thales
For:

Apple Pay, the value is 'APPLE_PAY'
Samsung Pay HCE/TEE, the value is 'SPAYHCE'
Android Pay, the value is 'ANDROID_PAY'
For other wallet (such as HCE Wallet), id is provided during on-boarding phase Value always provided except for ECOM.

cipheredCardInfostring · mín: 1 · máx: 8196Opcional

TSH sends card information as JSON encrypted using the PKCS#7 encryption scheme defined in RFC 2315/5652 using following encryption parameters:

The content encryption algorithm used is AES256/CBC/PKCS7Padding using a randomly generated AES key.
The key encryption algorithm is either RSAES-PKCS1-v1_5 (RSA/NONE/PKCS1Padding) or RSA/NONE/OAEPWithSHA256AndMGF1Padding (with MGF1 using SHA-256), using the certificate provided during onboarding.
The key encryption algorithm is defined during onboarding and is by default (if ommitted) the RSA/NONE/PKCS1Padding for legacy purpose.
It is recommended to configure RSA/NONE/OAEPWithSHA256AndMGF1Padding (with MGF1 using SHA-256) for new TSPs.
The encryption result is then encoded using base64.
The public key length in the certificate can be 2048-bit or 4096-bit.

Once deciphered, the card info contains the following information:

JSON field parameter name	description	MOC	Length
fpan	The funding pan to digitize	M	Up to 19
exp	The expiry date in the format MMYY	O	4
cvv	Depending of the OEM, this value is provided or not	O	3 or 4
additionalCardInfos	Optional JSON Open format, in order to add additional card info - project dependent	O	Up to 8177

Note: If not provided, the TSP must rely on the cardRefId provided to find the funding card to digitize from its token vault.

publicKeyIdentifierstring · mín: 1 · máx: 32Opcional

Identifier of the key used to encrypt cipheredCardInfo.
Provided by TSP to Thales during onboarding.

tokenProductIdstring · mín: 1 · máx: 48Opcional

ID of the token product (Identify token domain).

As the token products are mapped to Issuer card products, the values shall be defined at the begining of the project with the TSP.

tokenRequestorIdstring · mín: 1 · máx: 48Requerido

ID of the token requestor in the format expected by the TSP

merchantGatewayIdstring · mín: 10 · máx: 10Opcional

Unique identifier of the merchant gateway.
Applicable to ECOM only.

Example: MGW_123456

tokenStorageIdstring · mín: 1 · máx: 64Opcional

Token storage unique identifier (also known as deviceId or applicationId).
Indicates the storage in which the token has been digitized.
For ApplePay, it corresponds to the device SEID.
Not applicable for ECOM.

reusedTokenIdstring · mín: 1 · máx: 48Opcional

The tokenId provided in case the Wallet Provider wants to re-use an existing token

initialStatestring · enumOpcional

Initial state of the token when created.
Default value is SUSPENDED

Example: SUSPENDEDValores posibles:

Respuestas

200

createToken response payload

application/json

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

Unique Token Identifier

400

Bad Request, Invalid request URI or header, or unsupported nonstandard parameter.
Possible error codes are 111, 112, 113, 115, 163, 164, 166, 167, 911, 921

application/json

500

Internal Server Error Retry possible

503

Service Unavailable Retry possible

post/tokens

POST /tsp/trapi/v1.0/tokens HTTP/1.1
x-request-id: text
Content-Type: application/json
Accept: */*
Content-Length: 361

{
  "issuerId": "ISSUER1234",
  "cardRefId": "text",
  "walletProviderId": "text",
  "cipheredCardInfo": "text",
  "publicKeyIdentifier": "text",
  "tokenProductId": "text",
  "tokenRequestorId": "text",
  "merchantGatewayId": "MGW_123456",
  "tokenStorageId": "text",
  "deviceInfo": {
    "deviceName": "text",
    "brand": "text",
    "model": "text",
    "type": "text"
  },
  "reusedTokenId": "text",
  "initialState": "SUSPENDED"
}

{
  "tokenId": "8ec6d4eada0c",
  "tokenInfo": {
    "exp": "1220",
    "last4": "1234"
  }
}

PUT /tokens/{tokenId}/cardInfo

put

This method is used by TSH to request the update of funding pan information of the token

Parámetros de ruta

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

Identifier of the token

Parámetros de encabezado

x-request-idstring · mín: 1 · máx: 64Requerido

Unique request identifier use to trace function calls across system

Cuerpo

issuerIdstring · mín: 10 · máx: 10Requerido

Unique Identifier of Issuer

Example: ISSUER1234

newCipheredCardInfostring · mín: 1 · máx: 8196Requerido

TSH sends new card information as JSON encrypted using the PKCS#7 encryption scheme defined in RFC 2315/5652 using following encryption parameters:

The content encryption algorithm used is AES256/CBC/PKCS7Padding using a randomly generated AES key.
The key encryption algorithm is either RSAES-PKCS1-v1_5 (RSA/NONE/PKCS1Padding) or RSA/NONE/OAEPWithSHA256AndMGF1Padding (with MGF1 using SHA-256), using the certificate provided during onboarding.
The key encryption algorithm is defined during onboarding and is by default (if ommitted) the RSA/NONE/PKCS1Padding for legacy purpose.
It is recommended to configure RSA/NONE/OAEPWithSHA256AndMGF1Padding (with MGF1 using SHA-256) for new TSPs.
The encryption result is then encoded using base64.
The public key length in the certificate can be 2048-bit or 4096-bit.

Once deciphered, the card info contains the following information:

JSON field parameter name	description	MOC	Length
newFpan	The new funding pan value to update	O	Up to 19
newExp	The new expiry date in the format MMYY	O	4
newAdditionalCardInfos	Optional JSON Open format, in order add/update/delete additional card info - project dependent	O	Up to 8177

Note: At least one of the three JSON fields needs to be provided.

publicKeyIdentifierstring · mín: 1 · máx: 32Opcional

Identifier of the key used to encrypt newCipheredCardInfo.
Provided by TSP to Thales during onboarding.

newCardRefIdstring · mín: 1 · máx: 64Opcional

Respuestas

204

successful

Sin contenido

400

Bad Request, Invalid request URI or header, or unsupported nonstandard parameter.
Possible error codes are 111, 112, 113, 119, 163, 166, 432, 911, 921

application/json

500

Internal Server Error Retry possible

503

Service Unavailable Retry possible

put/tokens/{tokenId}/cardInfo

PUT /tsp/trapi/v1.0/tokens/{tokenId}/cardInfo HTTP/1.1
x-request-id: text
Content-Type: application/json
Accept: */*
Content-Length: 105

{
  "issuerId": "ISSUER1234",
  "newCipheredCardInfo": "text",
  "publicKeyIdentifier": "text",
  "newCardRefId": "text"
}

Sin contenido

PUT /tokens/{tokenId}/state

put

This method is used by TSH to request the update of token state

Parámetros de ruta

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

Identifier of the token

Parámetros de encabezado

x-request-idstring · mín: 1 · máx: 64Requerido

Unique request identifier use to trace function calls across system

Cuerpo

issuerIdstring · mín: 10 · máx: 10Requerido

Unique Identifier of Issuer

Example: ISSUER1234

newStatestring · enumRequerido

state of the token

Valores posibles:

reasonstring · mín: 1 · máx: 16Opcional

The reason of the state update

Possible values are:

reason code	description
11001	Activation from user interaction
21001	Activation initiated by the issuer
21002	Deletion initiated by the issuer
11002	Deletion initiated by the user
21003	Suspension initiated by the issuer
11003	Suspension initiated by the user
21004	Resumption initiated by the issuer
11004	Resumption initiated by the user

Respuestas

204

successful

Sin contenido

400

Bad Request, Invalid request URI or header, or unsupported nonstandard parameter.
Possible error codes are 111, 112, 113, 119, 432, 911, 921

application/json

500

Internal Server Error Retry possible

503

Service Unavailable Retry possible

put/tokens/{tokenId}/state

PUT /tsp/trapi/v1.0/tokens/{tokenId}/state HTTP/1.1
x-request-id: text
Content-Type: application/json
Accept: */*
Content-Length: 64

{
  "issuerId": "ISSUER1234",
  "newState": "SUSPENDED",
  "reason": "text"
}

Sin contenido

GET /issuers/{issuerId}/tokens/{tokenId}/credentials

get

This method is used by TSH to request the credentials of an existing token.

Parámetros de ruta

issuerIdstring · mín: 10 · máx: 10Requerido

Identifier of the issuer

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

Identifier of the token

Parámetros de encabezado

x-request-idstring · mín: 1 · máx: 64Requerido

Unique request identifier use to trace function calls across system

Respuestas

200

getTokenCredentials response payload

application/json

encryptedDatastringRequerido

The token 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
fpan	The funding PAN value	M	Up to 19
fpanExp	The funding PAN expiry date in the format MMYY	M	4
paymentAccountReference	The payment account reference	O	29
serviceCode	The service code used in track2 data	O	3
psn	The token PAN sequence number	O	2
Example: `{"dpan:"9580981500100002", "exp":"1232", "fpan":"9680981500100003", "fpanExp":"1230", "paymentAccountReference":"23R0PAYMENTACCOUNTREFERENCEXX", "serviceCode":"123", "psn":"01"}`

400

Bad Request, Invalid request URI or header, or unsupported nonstandard parameter.
Possible error codes are 111, 112, 113, 115, 163, 164, 166, 167, 911, 921

application/json

500

Internal Server Error Retry possible

503

Service Unavailable Retry possible

get/issuers/{issuerId}/tokens/{tokenId}/credentials

GET /tsp/trapi/v1.0/issuers/{issuerId}/tokens/{tokenId}/credentials HTTP/1.1
x-request-id: text
Accept: */*

{
  "encryptedData": "text"
}

POST /tokens/{tokenId}/replenishment

post

This method is used by TSH, in case of HCE, to request replenishment of payment credentials in the mobile wallet. This API only applies to TSH Pay solution (Issuer HCE wallet).

Parámetros de ruta

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

Identifier of the token

Parámetros de encabezado

x-request-idstring · mín: 1 · máx: 64Requerido

Unique request identifier use to trace function calls across system

Cuerpo

issuerIdstring · mín: 10 · máx: 10Requerido

Unique Identifier of Issuer

Example: ISSUER1234

atcstring · mín: 4 · máx: 4Requerido

Value of the application transaction counter that will be used in the next payment transaction. The ATC is encoded as an hexa string on 4 digits.

lastRepCounterstring · máx: 5Requerido

Value of the replenishment counter for the last replenishment.

schemeTranRecordsstring · máx: 2000Opcional

Transaction records for the last transactions as specified by the payment scheme. The transaction records data is encoded in base 64.

schemeTranRecSigstring · máx: 200Opcional

Signature of the transaction records computed according to the scheme specifications and encoded in hexa.

Respuestas

200

requestReplenishment response payload

application/json

repCounterstring · máx: 5Requerido

Value of the replenishment counter for the last replenishment.

400

Bad Request, Invalid request URI or header, or unsupported nonstandard parameter.
Possible error codes are 111, 112, 119, 432, 911, 921

application/json

500

Internal Server Error Retry possible

503

Service Unavailable Retry possible

post/tokens/{tokenId}/replenishment

POST /tsp/trapi/v1.0/tokens/{tokenId}/replenishment HTTP/1.1
x-request-id: text
Content-Type: application/json
Accept: */*
Content-Length: 390

{
  "issuerId": "ISSUER1234",
  "atc": "text",
  "usageLimitsStatus": {
    "paymentCredRemaining": 1,
    "paymentRemaining": 1,
    "expiryDate": "text"
  },
  "paymentCredsStatus": [
    {
      "sukStatus": "USED_FOR_CONTACTLESS",
      "diversifier": "text",
      "timestamp": "text",
      "paymentCredAttr": {
        "type": "SUK",
        "code": "SUK_IDN",
        "channel": "CONTACTLESS",
        "dki": "text"
      }
    }
  ],
  "lastRepCounter": "text",
  "schemeTranRecords": "text",
  "schemeTranRecSig": "text"
}

{
  "repCounter": "text",
  "usageLimits": {
    "maxPayments": 1,
    "expiryDate": "text"
  },
  "paymentCredsData": [
    {
      "encPaymentCredData": {
        "encData": "text",
        "encType": "RAW",
        "rawEncParams": {
          "algo": "3DES",
          "mode": "ECB",
          "padding": "ISO_7816",
          "iv": "text",
          "aeadNonce": "text",
          "aeadMac": "text",
          "keyId": "text"
        }
      },
      "paymentCredAttr": {
        "type": "SUK",
        "code": "SUK_IDN",
        "channel": "CONTACTLESS",
        "dki": "text"
      },
      "diversifiers": [
        "text"
      ]
    }
  ]
}

PUT /tokens/{tokenId}/replenishment/status

put

This method is used by TSH, in case of HCE, to notify the TSP the replenishment of payment credentials has been completed in the mobile wallet. This API only applies to TSH Pay solution (Issuer HCE wallet).

Parámetros de ruta

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

Identifier of the token

Parámetros de encabezado

x-request-idstring · mín: 1 · máx: 64Requerido

Unique request identifier use to trace function calls across system

Cuerpo

issuerIdstring · mín: 10 · máx: 10Requerido

Unique Identifier of Issuer

Example: ISSUER1234

repCounterstring · máx: 5Requerido

Value of the replenishment counter for the last replenishment.

diversifiersstring[]Opcional

Payment credential diversifier:

For an SUK, this is an ATC which is a string of 4 hexa digits.
For an LUK, this is an "YHHHHCC" Visa CBP diversifier which is a string of 7 digits.

Respuestas

204

successful

Sin contenido

400

Bad Request, Invalid request URI or header, or unsupported nonstandard parameter.
Possible error codes are 111, 112, 119, 432, 911, 921

application/json

500

Internal Server Error Retry possible

503

Service Unavailable Retry possible

put/tokens/{tokenId}/replenishment/status

PUT /tsp/trapi/v1.0/tokens/{tokenId}/replenishment/status HTTP/1.1
x-request-id: text
Content-Type: application/json
Accept: */*
Content-Length: 88

{
  "issuerId": "ISSUER0123",
  "repCounter": "33",
  "diversifiers": [
    "0025",
    "0026",
    "0027",
    "0028"
  ]
}

Sin contenido

PUT /tokens/{tokenId}/newData/status

put

This method is used by TSH to inform the TSP about the token re-personalization result in case of token renewal.

Parámetros de ruta

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

Identifier of the token

Parámetros de encabezado

x-request-idstring · mín: 1 · máx: 64Requerido

Unique request identifier use to trace function calls across system

Cuerpo

issuerIdstring · mín: 10 · máx: 10Requerido

Unique Identifier of Issuer

Example: ISSUER1234

statusstring · enumRequeridoValores posibles:

Respuestas

204

successful

Sin contenido

400

Bad Request, Invalid request URI or header, or unsupported nonstandard parameter.
Possible error codes are 111, 112, 113, 119, 911, 921

application/json

500

Internal Server Error Retry possible

503

Service Unavailable Retry possible

put/tokens/{tokenId}/newData/status

PUT /tsp/trapi/v1.0/tokens/{tokenId}/newData/status HTTP/1.1
x-request-id: text
Content-Type: application/json
Accept: */*
Content-Length: 44

{
  "issuerId": "ISSUER0123",
  "status": "SUCCESS"
}

Sin contenido

GET /healthCheck

get

This method is used by TSH to monitor TSP health. It should be used every 30 seconds in production environment.

Parámetros de encabezado

x-request-idstring · mín: 1 · máx: 64Requerido

Unique request identifier use to trace function calls across system

Respuestas

204

successful

Sin contenido

400

Bad Request, Invalid request URI or header, or unsupported nonstandard parameter.
Possible error codes are 111, 112, 911, 921

500

Internal Server Error Retry possible

503

Service Unavailable Retry possible

get/healthCheck

GET /tsp/trapi/v1.0/healthCheck HTTP/1.1
x-request-id: text
Accept: */*

Sin contenido

POST /tokens/{tokenId}/reperso

post

This request is triggered when TSH has to repersonalize a token and requires all the data elements associated.

After this request, TSP shall recover all the existing elements and submit it to the TSH through Submit New Token Data.

TSH will callback TSP through the Notify Token Reperso Result to notify the profile has been pushed to the device with success. At this moment, TSP shall set the ATC to zero to sync with the ATC personalized in the device.

Parámetros de ruta

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

Identifier of the token

Parámetros de encabezado

x-request-idstring · mín: 1 · máx: 48Requerido

Unique request identifier use to trace function calls across system

Cuerpo

issuerIdstring · mín: 10 · máx: 10Opcional

Unique Identifier of Issuer

Example: ISSUER1234

newTokenProductIdstring · mín: 1 · máx: 48Opcional

ID of the token product (Identify token domain).

As the token products are mapped to Issuer card products, the values shall be defined at the begining of the project with the TSP.

Respuestas

204

successful

Sin contenido

400

Bad Request, Invalid request URI or header, or unsupported nonstandard parameter.
Possible error codes are 111, 112, 113, 119, 321, 432, 911, 921

application/json

500

Internal Server Error Retry possible

503

Service Unavailable Retry possible

post/tokens/{tokenId}/reperso

POST /tsp/trapi/v1.0/tokens/{tokenId}/reperso HTTP/1.1
x-request-id: text
Content-Type: application/json
Accept: */*
Content-Length: 52

{
  "issuerId": "ISSUER1234",
  "newTokenProductId": "text"
}

Sin contenido

POST /listTokens

post

This method is used by TSH to request the list of tokens associated to either a funding PAN, a card reference ID or a token PAN. In case of a search by token PAN, the list returned by TSP shall contain 1 element at most.

Parámetros de encabezado

x-request-idstring · mín: 1 · máx: 64Requerido

Unique request identifier use to trace function calls across system

Cuerpo

issuerIdstring · mín: 10 · máx: 10Requerido

Unique Identifier of Issuer

Example: ISSUER1234

cipheredCardInfostring · mín: 1 · máx: 8196Opcional

TSH sends card information as JSON encrypted using the PKCS#7 encryption scheme defined in RFC 2315/5652 using following encryption parameters:

The content encryption algorithm used is AES256/CBC/PKCS7Padding using a randomly generated AES key.
The key encryption algorithm is either RSAES-PKCS1-v1_5 (RSA/NONE/PKCS1Padding) or RSA/NONE/OAEPWithSHA256AndMGF1Padding (with MGF1 using SHA-256), using the certificate provided during onboarding.
The key encryption algorithm is defined during onboarding and is by default (if ommitted) the RSA/NONE/PKCS1Padding for legacy purpose.
It is recommended to configure RSA/NONE/OAEPWithSHA256AndMGF1Padding (with MGF1 using SHA-256) for new TSPs.
The encryption result is then encoded using base64.
The public key length in the certificate can be 2048-bit or 4096-bit.

Once deciphered, the card info contains the following information:

JSON field parameter name	description	MOC	Length
fpan	The funding pan	M	Up to 19

cipheredTokenInfostring · mín: 1 · máx: 8196Opcional

TSH sends token information as JSON encrypted using the PKCS#7 encryption scheme defined in RFC 2315/5652 using following encryption parameters:

The content encryption algorithm used is AES256/CBC/PKCS7Padding using a randomly generated AES key.
The key encryption algorithm is either RSAES-PKCS1-v1_5 (RSA/NONE/PKCS1Padding) or RSA/NONE/OAEPWithSHA256AndMGF1Padding (with MGF1 using SHA-256), using the certificate provided during onboarding.
The key encryption algorithm is defined during onboarding and is by default (if ommitted) the RSA/NONE/PKCS1Padding for legacy purpose.
It is recommended to configure RSA/NONE/OAEPWithSHA256AndMGF1Padding (with MGF1 using SHA-256) for new TSPs.
The encryption result is then encoded using base64.
The public key length in the certificate can be 2048-bit or 4096-bit.

Once deciphered, the card info contains the following information:

JSON field parameter name	description	MOC	Length
dpan	The token PAN	M	Up to 19

cardRefIdstring · mín: 1 · máx: 64Opcional

publicKeyIdentifierstring · mín: 1 · máx: 32Opcional

Identifier of the key used to encrypt cipheredCardInfo.
Provided by TSP to Thales during onboarding.

Respuestas

200

listTokens response payload

application/json

400

Bad Request, Invalid request URI or header, or unsupported nonstandard parameter.
Possible error codes are 111, 112, 113, 166, 911, 921

application/json

500

Internal Server Error Retry possible

503

Service Unavailable Retry possible

post/listTokens

POST /tsp/trapi/v1.0/listTokens HTTP/1.1
x-request-id: text
Content-Type: application/json
Accept: */*
Content-Length: 126

{
  "issuerId": "ISSUER1234",
  "cipheredCardInfo": "text",
  "cipheredTokenInfo": "text",
  "cardRefId": "text",
  "publicKeyIdentifier": "text"
}

{
  "tokenList": [
    {
      "tokenId": "text",
      "exp": "1220",
      "last4": "1234",
      "state": "SUSPENDED",
      "tokenStorageId": "text",
      "tokenRequestorId": "text",
      "walletProviderId": "text",
      "deviceInfo": {
        "deviceName": "text",
        "brand": "text",
        "model": "text",
        "type": "text"
      },
      "creationDate": "2026-08-07T15:07:32.940Z"
    }
  ]
}

POST /tokens/{tokenId}/replenish

post

This request is triggered when TSH has to replenish a token. This API only applies to Google Pay solution.

Parámetros de ruta

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

Identifier of the token

Parámetros de encabezado

x-request-idstring · mín: 1 · máx: 48Requerido

Unique request identifier use to trace function calls across system

Cuerpo

issuerIdstring · mín: 10 · máx: 10Opcional

Unique Identifier of Issuer

Example: ISSUER1234

Respuestas

200

replenishToken response payload

application/json

kekLabelstringOpcional

Label of the key used to encrypt paymentKeys

kekKcvstringOpcional

KCV of the Key Encryption Key

paymentKeysstringOpcional

String representation of JSON array of objects containing payment keys
as defined in Data Preparation section

400

Bad Request, Invalid request URI or header, or unsupported nonstandard parameter.
Possible error codes are 111, 112, 113, 119, 321, 432, 911, 921

application/json

500

Internal Server Error Retry possible

503

Service Unavailable Retry possible

post/tokens/{tokenId}/replenish

POST /tsp/trapi/v1.0/tokens/{tokenId}/replenish HTTP/1.1
x-request-id: text
Content-Type: application/json
Accept: */*
Content-Length: 25

{
  "issuerId": "ISSUER1234"
}

{
  "kekLabel": "text",
  "kekKcv": "text",
  "paymentKeys": "text"
}

PUT /tokens/{tokenId}/replenish/done

put

This method is used by TSH to inform the TSP that the token replenishment has been done. This API only applies to Google Pay solution.

Parámetros de ruta

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

Identifier of the token

Parámetros de encabezado

x-request-idstring · mín: 1 · máx: 64Requerido

Unique request identifier use to trace function calls across system

Cuerpo

issuerIdstring · mín: 10 · máx: 10Requerido

Unique Identifier of Issuer

Example: ISSUER1234

Respuestas

204

successful

Sin contenido

400

Bad Request, Invalid request URI or header, or unsupported nonstandard parameter.
Possible error codes are 111, 112, 113, 119, 911, 921

application/json

500

Internal Server Error Retry possible

503

Service Unavailable Retry possible

put/tokens/{tokenId}/replenish/done

PUT /tsp/trapi/v1.0/tokens/{tokenId}/replenish/done HTTP/1.1
x-request-id: text
Content-Type: application/json
Accept: */*
Content-Length: 25

{
  "issuerId": "ISSUER0123"
}

Sin contenido

POST /merchant-gateways/{merchantGatewayId}/merchants

post

This method is used by TSH to request the creation of a new merchant.

Parámetros de ruta

merchantGatewayIdstring · mín: 10 · máx: 10Requerido

Identifier of the merchant gateway

Parámetros de encabezado

x-request-idstring · mín: 1 · máx: 64Requerido

Unique request identifier use to trace function calls across system

Cuerpo

merchantNamestring · mín: 1 · máx: 64Requerido

An unique merchant name that is end user friendly.

Example: My MerchantPattern: ^[A-Za-z0-9-_. ]+$

Respuestas

200

createMerchant response payload

application/json

merchantIdstring · mín: 11 · máx: 11Requerido

Merchant ID generated by TSP.
It is computed as per EMVCo TRID format.

Example: 10610027312

400

Bad Request, Invalid request URI or header, or unsupported nonstandard parameter.
Possible error codes are 111, 112, 113, 115, 163, 164, 166, 167, 911, 921

application/json

500

Internal Server Error Retry possible

503

Service Unavailable Retry possible

post/merchant-gateways/{merchantGatewayId}/merchants

POST /tsp/trapi/v1.0/merchant-gateways/{merchantGatewayId}/merchants HTTP/1.1
x-request-id: text
Content-Type: application/json
Accept: */*
Content-Length: 30

{
  "merchantName": "My Merchant"
}

{
  "merchantId": "10610027312"
}

AnteriorOperaciones salientes (hacia el TSP)SiguienteAPI de intercambio de criptogramas PSD2

Última actualización hace 2 meses

¿Te fue útil?