v1

latestOpenAPI 3.0.02026-07-242035712.0 MB

Tokenization customer service

Token Suspend

Used to suspend an active token so that it may not initiate any new transactions. All authorizations for a suspended token will be declined.

post/pws/customerservice/v3/token/suspend/

Request body

api_call_unique_identifierstring required

Unique number that must be passed at each API request. Identifier to make each API request unique

client_idinteger required

Unique identifier for the client which Paymentology will provide at outset

reasonCode'L' | 'S' | 'T' | 'Z' required

The reason for the action. Valid values: "L" - Cardholder reported token device lost. "S" - Cardholder reported token device stolen. "T" - Issue or cardholder reported fraudulent token transactions. "Z" - Other.

tokeninteger required

Paymentology Public Token.

tspTokenstring required

Token Service Provider Unique reference to the token

user_idstring

User Id of the Customer who triggered the API request.

remarksstring

Remarks for API request

commentTextstring

Comment related to the token status change. Maximum length of 500.

Example request

{
  "api_call_unique_identifier": "438574845790657485",
  "client_id": 760131,
  "reasonCode": "Z",
  "token": 311012081,
  "tspToken": "DWSPMC00000000784034nvc7fetlv5huicsdtmng6xpetgcq123",
  "commentText": "Customer found a device."
}

Response

Successful Response

Example response

{
  "header": {
    "error_desc": "success"
  }
}