Tokenization Initiation

The first message CLOWD9 receives from the Network is a request to verify whether the PAN is active and eligible for tokenization.

CLOWD9 responds directly to the Network with the result of this eligibility check.

Event: check_eligibility

This event is triggered at the beginning of the tokenization process to determine whether a DPAN can be issued for the provided PAN.

Request

FieldDescriptionFormat
event_typeIdentifies the activityUUID
created_datetimeThe date and time of the requestString
token_infoObject
card_idThe Identifier associated to the CardUUID
client_idThe Identifier associated to the ClientUUID
dpan_idThe Identifier associated to the DPANUUID
networkIdentifies the Network associated with the Wallet ProviderString
pan_reference_idNetwork generated IdentifierString
previous_statusThe previous status of the DPAN if applicableString
statusThe current status of the DPANString
token_reference_idUnique ID for the token associated with the PANString

Example

Example 2 - DPAN Check Eligibility

{
    "created_datetime": 1754313047,
    "event_type": "check_eligibility",
    "token_info": {
        "card_id": "47277b0d-2aa6-48ab-a2f5-7a5dababf2f8",
        "client_id": "82d890aa-f083-4359-a1c8-5cd483ba40e8",
        "dpan_id": "19035fa2-c2fd-4a75-96a1-8655ec880fb1",
        "network": "visa",
        "pan_reference_id": "V-3025197339880335891989",
        "previous_status": "active",
        "status": "active",
        "token_reference_id": "DNITHE302521033484727131"
    }
}

Response

Respond with 200, that message was received. The response will need a body and will need to be valid JSON, for example as below.

"ok"

Did this page help you?