Checking a card's enrollment tag

To check the enrollment tag 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 wish to view. The response will include 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 will not be registered until the merchant account is enrolled. See the Enrollment tag table for more information.

Example Request
curl -X GET https://api.nexiopaysandbox.com/pay/v3/vault/card/{cardToken} \
  -H 'Accept: application/json' \
  -H 'Authorization: Basic [Base64_encoded_login]'
Example 200 Response
{
  "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 UpdatershouldUpdateCardAction
EnrolledtrueThe card will be registered with account updater
EnrolledfalseThe card will be excluded from account updater. If the card was previously registered it will be de-registered
Not EnrolledtrueThe card is tagged for registration. Upon merchant enrollment the card will be registered with account updater
Not EnrolledfalseThe card is tagged for exclusion. Upon merchant enrollment the card will be excluded from account updater

Card status

accountUpdaterStatusDescription
isRegisteredCard has been successfully registered. Automatic card updates will occur.
pendingExclusionCard is in the process of being de-registered (usually takes about three to four business days).
isExcludedCard 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.)
toDeleteIndicates that Nexio must first de-register the card before deleting the token.
pendingDeletionCard 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 NumberResponse CodeDescription
4000200011112222201Expiration date has been updated (3 years added to the expiration date)
4000200111112221201Expiration date has been updated (3 years added to the expiration date)
4000100011112224202Card number updated to 4000100511112229
4000100111112223202Card number updated to 4000100611112228
4000600011112223203Closed account
4000600111112222203Closed account
4000700011112221204Contact cardholder
4000700111112220204Contact cardholder

Did this page help you?