Token status & Account Lifecycle Management

👍
By using Network Tokens, you no longer need to worry about declined authorizations due to expired or blocked card credentials.

In general, the PCI Proxy token is always up to date if a Network Token has been provisioned for the underlying card number. We automatically update the PCI Proxy or Network Token if anything changes on the underlying card number.

Call the Alias Status API to see the latest PAN expiry date or to check whether the status or the last 4 digits of the underlying PAN has changed. We also return the paymentAccountReference- a unique identifier returned directly by the card brands to detect the underlying PAN across various channels.

curl --request GET \
  --url 'https://api.sandbox.datatrans.com/v1/aliases/{alias}' \
  --header 'Authorization: Basic {basicAuth}'

{
    "alias": "7LHXscqwAAEAAAGQl2DPXQbbUOZ4ADnU",
    "fingerprint": "F-cg_iu0Xulk1UNMtL57hZW3",
    "type": "CARD",
    "masked": "22228502xxxx7008",
    "dateCreated": "2024-07-09T12:03:42Z",
    "card": {
        "usage": "REGISTRATION",
        "panRemoved": false,
        "bin": "22228502",
        "last4": "7008",
        "expiryMonth": "12",
        "expiryYear": "30",
        "cardInfo": {
            "brand": "MASTERCARD",
            "type": "credit",
            "usage": "consumer",
            "country": "US",
            "issuer": "",
            "accountType": "PAN"
        },
        "networkToken": {
            "expiryMonth": "08",
            "expiryYear": "27",
            "status": "ACTIVE",
            "paymentAccountReference": "5001CKVAXG3BF45LG87F63JVX3AQ0",
            "tokenRequestorId": "50179002095",
            "token": "2222850249926011"
        }
    }
}

If a networkToken object is present in the response, a Network Token has been successfully provisioned. If not, it means that the issuer does not yet support Network Tokens or the card is not enrolled for it. You can continue to use the PAN value mapped to the PCI Proxy token.

A Network Token can have the following pre-defined state:

State	Description
ACTIVE	Network Token is activated and ready for use in downstream payment operations (e.g. authorisation, 3D-Secure attempt).
PENDING	Network Token has been requested but is not yet active.
INACTIVE	Network Token has not yet been activated.
SUSPENDED	Network Token is suspended and can not be used for further interaction. It can be suspended by various sources such the cardholder, the card issuer or the token requestor.
DELETED	Network Token has been permanently deleted.
FAILED	Network Token provisioning request failed. See `reason` object in the response of the provisioning request to see more details.

👍By using Network Tokens, you no longer need to worry about declined authorizations due to expired or blocked card credentials.

👍
By using Network Tokens, you no longer need to worry about declined authorizations due to expired or blocked card credentials.