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 UpdatershouldUpdateCardAction
EnrolledtrueThe card will be sent to the Account Updater provider.
EnrolledfalseThe card will not be sent to the Account Updater provider. If the card was previously registered it will be de-registered.
Not EnrolledtrueThe card is tagged for sending to the Account Updater provider. Upon merchant enrollment the card will be sent.
Not EnrolledfalseThe 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.

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