Category links

API Links

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

POST /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

Currency Code Place Holder for Future Use. Valid Values: Refer Appendix Section - Currency Code Example:840 = US Dollar Condition:If no value is passed, default value = 840

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
  }
}