---
title: "Mada Token Update"
method: POST
path: "/pws/pws_mada_token_update"
tags: ["Mada Pay LCM"]
---

# Mada Token Update

`POST /pws/pws_mada_token_update`

Mada Token Update

## Request body

- TokenUpdateInternal — Mada-TokenUpdateInternal
  - `api_call_unique_identifier` string, required — Unique number that must be passed at each API request. Identifier to make each API request unique
  - `client_id` integer, required — Unique identifier for the client which Paymentology will provide at outset
  - `user_id` string — User Id of the Customer who triggered the API request.
  - `remarks` string — Remarks for API request
  - `old_token` integer — Public token for old card
  - `new_token` integer — 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>
  - `operationReason` string — Operation Reason. Eg: “Lost token”
  - `commentText` string — Comment related to the updated token(s)/PAN
  - `cardMetadataInfo` CardMetaData — Mada-CardMetaData
    - `cardIssuer` string — Card Issuer Name.
    - `foregroundColor` string — Foreground color of the Digital Wallet entry for the card. Specified as a CSS style RGB triple, for example, rgb (23,122,235).
    - `backgroundColor` string — Background color of the Digital Wallet entry for the card. Specified as a CSS style RGB triple, for example, rgb (23,122,235).
    - `labelColor` string — Label color of the Digital Wallet entry for the card. Specified as a CSS style RGB triple, for example, rgb (23,122,235).
    - `shortDescription` string — A short description of the card.
    - `longDescription` string — A long description of the card.
    - `issuerProductConfigId` string — Profile id associated with the card. This is a required field if operationReasonCode = CARD_METADATA_UPDATE
    - `applicationInfo` CardMetadataApplicationInfo
      - `supportsTokenNotifications` boolean — Indicates whether the card supports token notifications for transactions originating on the device
      - `supportsFPANNotifications` boolean — Indicates whether the card supports FPAN notifications for all transactions that point back to the FPAN.
      - `transactionServiceURL` string — URL of the issuer Transaction History (Transaction Details) Web Service.
      - `messageServiceURL` string — URL of the message/offer web service that conforms to the API described to PNOs and issuers in the Card Notification Services API Specification.
      - `transactionPushTopic` string — Push topic that the issuer will use to notify the device that new transactions are available.
      - `messagePushTopic` string — Push topic that the notification provider will use to notify the device that new messages are available.
      - `appLaunchURL` string — URL to be passed to the associated issuer mobile app when launching it.
      - `appLaunchURLScheme` string — URL scheme that the application is registered for, in order to deep link from transaction notifications and show all transaction notifications.
      - `associatedStoreIdentifiers` string — A list of mobile application store item identifiers for associated issuer mobile banking application. Format is specific to a mobile store/phone platform. Only one item in the list is used: the first item identifier for an application compatible with the current device.
      - `associatedApplicationIdentifiers` string — Optional, similar to associatedStoreIdentifiers, but explicit App IDs. (Only applicable to SE DWPs.)
    - `cardArtData` CardArtData — Mada-CardArtData
      - `cardArtRefId` string[] — GUID-based file name for Cart Art Image file used by the Issuer while loading the image in the VRM system.
    - `termsAndConditionsId` string — GUID-based file name for Terms and Conditions text. File used by the issuer while loading the image in the VCCM system.
    - `contactInfo` ContactInfo
      - `contactWebsite` string — Customer Service website of the issuing bank.
      - `contactNumber` string — Customer Service phone number of the issuing bank.
      - `contactName` string — Name of the issuing bank. It may be used in combination with other text strings.
      - `contactEmail` string — Customer Service email address of the issuing bank.
    - `privacyPolicyURL` string — URL pointing to issuing bank’s privacy policy.
    - `termsAndConditionsURL` string — URL pointing to issuing bank’s terms and conditions for card.

## Response `200`

Successful Response

- ResponseTokenUpdate
  - `header` Header
    - `error_desc` string, required — Error Description
    - `error_id` integer, required — Error Id
  - `body` TokenUpdateResponse — Mada-TokenUpdateResponse
    - `responseId` string
    - `error` Error
      - `errorCode` string
      - `errorDescription` string
      - `details` Details
        - `location` string
        - `message` string
    - `errorCode` string — Business Error
    - `tokens` Token[] — Tokens
      - `tokenReferenceId` string — Unique ID for the Token associated with the PAN
      - `commentId` string — Identifier of the comment added. Only present when comment text was provided in the request.
      - `taskID` string — GUID with hyphens.
      - `tokenRequestorID` string — Unique ID assigned to the initiator of the token request.
      - `panReferenceID` string — Unique ID for the PAN.
      - `statusCode` 'PENDING' | 'FAILURE' | 'NOT_ALLOWED' — Action status codes. Values are: - PENDING - FAILURE - NOT_ALLOWED
      - `errorCode` string — Business error.
    - `keyValues` Entry
      - `key` string — Key
      - `value` string — Value
    - `responseDetails` ResponseDetail[] — Entry Key/Value object
      - `tokenReferenceID` string — Unique ID for the Token associated with the PAN.
      - `taskID` string — Present in case Status Code is PENDING for Visa cards. Not present otherwise.
      - `tokenRequestorID` string — Unique ID assigned to the initiator of the token request.
      - `panReferenceID` string — Unique ID for the PAN.
      - `statusCode` string — Action status codes. Values are: PENDING | FAILURE | NOT_ALLOWED
      - `errorCode` string — Present in the case of business error.

## Other responses

- `404` — Webservices does not exist
- `500` — Internal Server error

---

[API](https://skmtc.net/paymentology/apis/payapi-docs.md) · [All operations](https://skmtc.net/paymentology/apis/payapi-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paymentology/payapi-docs/revisions/a675891b0365/schema)