Checking a card's enrollment tag
To check the enrollment of an existing card token, send a GET
request to the View card token details endpoint.
Replace the {cardToken}
in the example below with the card token you want to view. The response includes a boolean value called shouldUpdateCard
. This is the card's enrollment tag. It indicates whether a card will be registered or excluded from account updater.
Note
The card token does not get sent to the Account Updater provider until the merchant account is enrolled. See the Enrollment tag table for more information.
curl -X GET https://api.nexiopaysandbox.com/pay/v3/vault/card/{cardToken} \
-H 'Accept: application/json' \
-H 'Authorization: Basic [Base64_encoded_login]'
{
"accountUpdaterStatus": "isExcluded",
"card": {...},
"data": {...},
"dateCreated": "2019-07-31T17:02:39.035Z",
"dateLastModified": "2019-07-31T18:33:30.660Z",
"merchantId": "100100",
"shouldUpdateCard": true,
"tokenex": {...}
}
Enrollment tag table
Merchant's Enrollment in Account Updater | shouldUpdateCard | Action |
---|---|---|
Enrolled | true | The card will be sent to the Account Updater provider. |
Enrolled | false | The card will not be sent to the Account Updater provider. If the card was previously registered it will be de-registered. |
Not Enrolled | true | The card is tagged for sending to the Account Updater provider. Upon merchant enrollment the card will be sent. |
Not Enrolled | false | The card is tagged for not sending to the Account Updater provider. Upon merchant enrollment the card will not be sent. |
Card status
The accountUpdaterStatus
parameter is only for use with legacy Account Updater accounts.
accountUpdaterStatus | Description |
---|---|
isRegistered | Card has been successfully registered. Automatic card updates will occur. |
pendingExclusion | Card is in the process of being de-registered (usually takes about three to four business days). |
isExcluded | Card is excluded or has been de-registered from the account updater service. (This is the default status before a card is run through the account updater service.) |
toDelete | Indicates that Nexio must first de-register the card before deleting the token. |
pendingDeletion | Card is in the process of being de-registered. The token will be deleted within three to four business days. |
Test cards for account updater
Test transactions for Account Updater can be submitted using the following card numbers:
Test Card Number | Response Code | Description |
---|---|---|
4000200011112222 | 201 | Expiration date has been updated (3 years added to the expiration date) |
4000200111112221 | 201 | Expiration date has been updated (3 years added to the expiration date) |
4000100011112224 | 202 | Card number updated to 4000100511112229 |
4000100111112223 | 202 | Card number updated to 4000100611112228 |
4000600011112223 | 203 | Closed account |
4000600111112222 | 203 | Closed account |
4000700011112221 | 204 | Contact cardholder |
4000700111112220 | 204 | Contact cardholder |
Updated over 1 year ago