Sign in

v1

latestOpenAPI 3.0.02026-07-242035712.0 MB
Mada Pay LCM

Mada Token Update

Mada Token Update

post/pws/pws_mada_token_update

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

user_idstring

User Id of the Customer who triggered the API request.

remarksstring

Remarks for API request

old_tokeninteger

Public token for old card

new_tokeninteger

Public token for new card

operationReasonCode'PAN_REPLACE' | 'ACCOUNT_UPDATE' | 'PAN_REVERSAL' | 'ACCOUNT_CLOSE' | 'CARD_METADATA_UPDATE' | 'CONTACT_CARDHOLDER' | 'PORTFOLIO_CONVERSION' | 'FINANCIAL_ACCOUNT_INFO_UPDATE' | 'ISSUER_PAN_REFERENCE_ID_UPDATE' | 'EXP_DATE_UPDATE'
<p>Operation reason codes.&nbsp;</p> <p>Possible values</p> <ul> <li>PAN_REPLACE</li> <li>ACCOUNT_UPDATE</li> <li>PAN_REVERSAL</li> <li>ACCOUNT_CLOSE</li> <li>CARD_METADATA_UPDATE</li> <li>CONTACT_CARDHOLDER</li> <li>&nbsp;PORTFOLIO_CONVERSION"</li> <li>FINANCIAL_ACCOUNT_INFO_UPDATE&nbsp;</li> <li>ISSUER_PAN_REFERENCE_ID_UPDATE</li> <li>EXP_DATE_UPDATE</li> </ul>
operationReasonstring

Operation Reason. Eg: “Lost token”

commentTextstring

Comment related to the updated token(s)/PAN

Example request

{
  "api_call_unique_identifier": "438574845790657485",
  "client_id": 760131,
  "old_token": 59669200,
  "new_token": 19966881,
  "operationReasonCode": "PAN_REPLACE",
  "operationReason": "Lost token",
  "commentText": "Update card",
  "cardMetadataInfo": {
    "cardArtData": {
      "cardArtRefId": [
        "fbca33da0f6ae3bb908c053fc67bfa00"
      ]
    }
  }
}

Response

Successful Response

Example response

{
  "header": {
    "error_desc": "success"
  },
  "body": {
    "errorCode": "00",
    "tokens": [
      {
        "errorCode": "00"
      }
    ],
    "keyValues": {
      "key": "A",
      "value": "Value 1"
    },
    "responseDetails": [
      {
        "tokenReferenceID": "468fa67105dc473c9f3e6081caeaa75f",
        "taskID": "bd028456-fc95-449d-b906-5c0a05096879",
        "tokenRequestorID": "tokenRequestorID",
        "panReferenceID": "panReferenceID",
        "statusCode": "PENDING",
        "errorCode": "Error"
      }
    ]
  }
}