Merchant Onboarding

Notify Merchant Update

post

Notify the token requestor about a merchant onboarding update.

In case of retryable error returned by the token requestor, the notification will be resent periodically with exponential backoff.

Autorizaciones

BasicAuth

AuthorizationstringRequerido

Parámetros de encabezado

authorizationanyRequerido

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-idanyRequerido

A unique message identifier. It eventually correlates the notification with a request if any. The goal is to help on customer support when needed.

Cuerpo

application/json

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

Identifier of the merchant provided by Thales at on-boarding.

schemestring · enum · máx: 32Requerido

The card primary scheme.

Example: VISAValores posibles:

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

The Token Requestor Identifier generated by the scheme for that merchant. In case of Mastercard Secure Card-On-File program, this field is not returned, see 'mcServiceId' instead.

Example: 40000000080

mcServiceIdstring · mín: 1 · máx: 256Opcional

Token Requestor Id for SCOF solution, equivalent to the TRID. It is assigned by Mastercard to entity for which tokens are created.

lastUpdateTimestampstring · máx: 64Opcional

Last update timestamp compliant with ISO 8601.

Example: 2017-11-13T11:012:41.165Z

Respuestas

204

No Content

400

Bad request - Not Retryable

401

Unauthorized - Not Retryable

404

Not Found - Not Retryable

429

Too Many Requests - Retryable

500

Internal Server Error - Retryable

503

Service Unavailable - Retryable

post

/notify-merchant-update

HTTPcURLJavaScriptPython

POST /tsh-cof/notify-merchant-update HTTP/1.1
Authorization: Basic username:password
authorization: null
x-correlation-id: null
Content-Type: application/json
Accept: */*
Content-Length: 199

{
  "merchantId": "text",
  "scheme": "VISA",
  "trId": "40000000080",
  "mcServiceId": "text",
  "error": {
    "errorCode": "TSP_NON_RETRYABLE_ERROR",
    "errorDetails": "text"
  },
  "lastUpdateTimestamp": "2017-11-13T11:012:41.165Z"
}

Sin contenido