Update Token Status
In certain situations, such as in the case of device loss or card replacement, the token status should be updated to avoid misuse. You can use a CoreCard API to update the token status accordingly to Inactive, Active, or Closed. A token, once closed, cannot be made active or Inactive and needs to be digitalized again.
Update Transaction Token Status
Action: POST
Endpoint: /api/CoreCredit/DigitalWallets/UpdateTxnTokenStatus
Use this API to update the PAN token status by using the last four digits of a token number and new token status to be updated. The token status can be set as active, inactive, or closed, as required.
Request fields detail
Fields | Description |
---|---|
Source string |
Source of API Consumer For external system expected sources will be WEB. Allowable Values: 50 |
IPAddress string Optional |
IP Address of Client / Application Hosting Server Example: 10.206.0.204 Allowable Values: 15 |
DateFormat string Optional |
Place Holder for Future Use. Values are: 1 : MM/dd/yyyy HH:MM:SS (Default) 2 : MM/dd/yy HH:MM:SS 3 : dd/MM/yyyy HH:MM:SS Allowable Values: 25 |
CurrencyCode string Optional |
Place Holder for Future Use. Currency Code Ex. 840 = US Doller. Allowable Values: 10 |
CurrencySymbolType string Optional |
Place Holder for Future Use. CurrencySymbolType: 1: Currency Sign like $ 2: 3 ALPHA Currency Code like USD Allowable Values: 10 |
Language string Optional |
Place Holder for Future Use. Language: en: means use English Default: en - English Allowable Values: 10 |
ExternalIP string |
IP Address of end user of API Allowable Values: 50 |
SessionID string Optional |
Session identifier of the API Example: 000028;026;1349906692 Allowable Values: 100 |
APIVersion string |
Version of the API to be invoked. Example: 2.0 API Version Current Version 2.0 Allowable Values: 10 |
CallerID string Optional |
Caller ID of source from where API is initiated it is End User Caller ID Example: 7204454214 (phone number applicable in Case of IVR) Allowable Values: 20 |
CalledID string Optional |
Called ID of destination for which API is initiated It is Destination Called ID Example: 7314145404 (phone number applicable in Case of IVR) Allowable Values: 20 |
RequestTime datetime Optional |
Request Date Time of API Format: MM/dd/yyyy HH:mm:ss Example:01/15/2020 10:05:23 |
Skey decimal Mandatory |
Unique number for each token. Valid Values: 0-9 Example: 12345 |
AdminNumber int64 Conditional |
Details can be obtained by admin number (Embossing Acctid) Valid Values: 0-9 Example: 12345 Condition: At least one of AccountNumber\ AdminNumber is required. |
ProductID integer Mandatory |
ProductID Valid Values: 0-9 Example: 12345 |
AccountNumber string Conditional |
Account number of cardholder Valid Values: 0-9 Format: XXXXXXXXXXXXXXXX Example: 8000000000000037 Condition: At least one of AccountNumber\ AdminNumber is required. Allowable Values: 19 |
TokenNumberLast4Digits string Mandatory |
Last 4 digits of Token number Valid Values:0-9 Format: XXXX Example: 1234 Allowable Values: 4 |
NewTokenStatus string Mandatory |
New Token Status Valid Values: A - Active C - Close I - Inactive Allowable Values: 1 |
Sample request body
{ "Source": "WEB", "IPAddress": "10.120.0.1", "DateFormat": null, "CurrencyCode": null, "CurrencySymbolType": null, "Language": null, "ExternalIP": "10.120.0.0", "SessionID": null, "APIVersion": "2.0", "CallerID": null, "CalledID": null, "RequestTime": null, "Skey": 1.0, "AdminNumber": 129409, "ProductID": 3351, "AccountNumber": null, "TokenNumberLast4Digits": "0188", "NewTokenStatus": "I" }
Response fields detail
Fields | Description |
---|
Sample response body
{ "application/json": { "Message": "Success", "Status": true, "ErrorCode": "Err00017", "ResponseData": null } }