Following the Tokenization Initiation and the acceptance of the Terms and Conditions by the Customer, the Network will request approval from CLOWD9.

CLOWD9 will carry out further card validation steps based on the:

Primary Account Number status
CVV2 and Expiry
Risk criteria as per your configurations

Following these checks, CLOWD9 will respond with on of three respond based on the risk criteria configured as follows:

Approved (reason code 00): This will result in the token creation in an inactive status via the Network, known as the Green Flow. Further verification is not required and the next step will be Token Activation
No Reason to Decline (response code 085): The Network will progressing with the token creation in an inactive status; however further Customer Verification will be required. This is known as the Yellow Flow and will require Cardholder Verification methods to be provided as per the next step
Declined (response code will depend on the reason for the Decline): As a result of the decline, the Customer will not be able to tokenize their card. They will be required to re-start the process

Where you are involved in the Approve Provisioning Request, CLOWD9 decision only applies if no decision is received from you.

Request

Field	Description	Format	Example
token_info
dpan_id	Identifier associated to the device token	UUID
card_id	Identifier associated to the card being tokenized	UUID	3d0229b5-8330-4c62-be60-d8a5ba2f605d
token_reference_id	The Network identifier associated to the Token	string
pan_reference_id	The Network identifier associated to the PAN	string
client_id	The Identifier associated to the card	UUID
network	The network associated with the BIN and card_id visa mastercard discover	string	visa
status	The status of the token: Created Activated Deleted Suspended	string	Created
previous_status	The previous status of the token: Created Activated Deleted Suspended	string
device_info
device_id	The Identifier associated with the device
identifier	The Identifier associated to the device provided by the Network
index	The index provided by the Network	string
name	The name associated to the device	string
os_type	Identifies the device OS type	string
os_version	Identifies the device OS version	string
type	Identifies the type of device	string
decisions
cvv2	The outcome of the CVV2 validation: M =CVV2 matches N =CVV2 does not match P = not provided empty = not provided	string	M
avs	The outcome of the AVS check: M = Address matches N =Address does not match, P = not provided empty = not provided	string	M
action	The outcome of the Provisioning request: APPROVED (Green Flow) REQUIRE_ADDITIONAL_AUTHENTICATION (Yellow Flow) DECLINED (Red Flow)	string	APPROVED
error	Will provide addtional information when the Provisioning request has be declined. For example: "Invalid CVV2"	string
cardholder_info
high_value_customer	Indicates if the Customer is a high-value customer: true false	boolean	false
risk_assessment_score	Risk assessment score for the customer. Values are 0 - 9	string	0
pan_entry_mode	Method used to enter the PAN during tokenization: KEY_ENTERED ON_FILE MOBILE_BANKING_APP TOKEN CHIP_DIP CONTACTLESS_TAP	string	KEY_ENTERED
life_cycle_trace_id	Network trace ID for lifecycle tracking	string	1245678945633463464366
created_datetime

Example

{
    "token_info": {
        "dpan_id": "8f92d6e1-4b0e-4d1a-9c26-4e6f4f6e3bfa",
        "card_id": "4c6b8be3-b725-4c0b-9914-b12dfe2d2b8f",
        "token_reference_id": "DNITHE302505556755796984",
        "pan_reference_id": "3025091437104242823868",
        "client_id": "1d9b60b4-dedf-4762-9c3d-a9090be7a391",
        "network": "VISA",
        "status": "Created"
    },
    "device_info": {
        "device_id": "69bbf287-b88c-4218-85da-124fe514239b",
        "identifier": "7VnCWhDb98QXaHFNbx75e0z9",
        "index": 0,
        "name": "",
        "os_type": "",
        "os_version": "",
        "type": ""
    },
    "decisions": {
        "cvv2": "M",
        "avs": "P",
        "action": "APPROVED",
        "error": ""
    },
    "cardholder_info": {
        "high_value_customer": false,
        "risk_assessment_score": "0"
    },
    "pan_entry_mode": "KEY_ENTERED",
    "life_cycle_trace_id": "1245678945633463464366",
    "created_datetime": "1751551391"
}