v1

latestOpenAPI 3.0.02026-07-242035712.0 MB

Tokenization customer service

Token Activate

Used to activate a token for a digitization that has been approved and provisioned, but requires additional cardholder authentication prior to activation.

post/pws/customerservice/v3/token/activate/

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'A' | 'C' required

Reason for the activation. Valid values: "A" = Cardholder successfully authenticated prior to activation. "C" = Cardholder successfully authenticated with a customer service agent prior to activation.

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.

activationCodestring

(conditional) [visa] Required when paymentNetwork is VISA.

Example request

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

Response

Successful Response

Example response

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