## Base properties shared by both tokenization decisioning requests (with response) and without

- **account_token**  
  Type: string  
  Required: Unique identifier for the user tokenizing a card

- **card_token**  
  Type: string  
  Required: Unique identifier for the card being tokenized

- **created**  
  Type: date-time  
  Required: Indicate when the request was received from Mastercard or Visa

- **device**  
  Type: object  
  Description: device object

- **issuer_decision**  
  Type: string (enum)  
  Required: Whether Lithic decisioned on the token, and if so, what the decision was.  
  Allowed: `APPROVED`, `DENIED`, `VERIFICATION_REQUIRED`

- **tokenization_channel**  
  Type: string (enum)  
  Required: The channel through which the tokenization was made.
  Allowed: `DIGITAL_WALLET`, `MERCHANT`

- **tokenization_source**  
  Type: string (enum)  
  Description: The source of the tokenization.  
  Allowed: `ACCOUNT_ON_FILE`, `CONTACTLESS_TAP`, `MANUAL_PROVISION`, `PUSH_PROVISION`, `TOKEN`, `UNKNOWN`

- **tokenization_token**  
  Type: string  
  Required: Unique identifier for the digital wallet token attempt

- **wallet_decisioning_info**  
  Type: object  
  Required: wallet_decisioning_info object

- **digital_wallet_token_metadata**  
  Type: object  
  Required: Contains the metadata for the digital wallet being tokenized.

- **customer_tokenization_decision**  
  Type: object  
  Optional: The customer's tokenization decision outcome. Only populated in webhook events (after decisioning), not in the initial decisioning request

- **event_type**  
  Type: string (enum)  
  Required: The name of this event  
  Allowed: `digital_wallet.tokenization_approval_request`

- **tokenization_decline_reasons**  
  Type: array of objects  
  Description: List of reasons why the tokenization was declined. Only populated in webhook events, not in the initial decisioning request

- **tokenization_tfa_reasons**  
  Type: array of objects  
  Description: List of reasons why two-factor authentication was required. Only populated in webhook events, not in the initial decisioning request

- **rule_results**  
  Type: array of objects  
  Description: Results from rules that were evaluated for this tokenization. Only populated in webhook events, not in the initial decisioning request

## Sample JSON Output

```json
{
  "account_token": "00000000-0000-0000-0000-000000000002",
  "card_token": "00000000-0000-0000-0000-000000000001",
  "created": "2026-07-18T00:26:02.790Z",
  "device": {
    "imei": "123456789012345",
    "ip_address": "1.1.1.1",
    "location": "37.3860517/-122.0838511"
  },
  "issuer_decision": "APPROVED",
  "tokenization_channel": "DIGITAL_WALLET",
  "tokenization_source": "PUSH_PROVISION",
  "tokenization_token": "string",
  "wallet_decisioning_info": {
    "account_score": "100",
    "device_score": "100",
    "recommendation_reasons": [
      "string"
    ],
    "recommended_decision": "Decision1"
  },
  "digital_wallet_token_metadata": {
    "payment_account_info": {
      "account_holder_data": {
        "phone_number": "string"
      },
      "pan_unique_reference": "string",
      "payment_account_reference": "string",
      "token_unique_reference": "string"
    },
    "payment_app_instance_id": "string",
    "status": "string",
    "token_requestor_id": "string",
    "token_requestor_name": "APPLE_PAY"
  },
  "customer_tokenization_decision": {
    "latency": "100",
    "outcome": "APPROVED",
    "responder_url": "https://example.com",
    "response_code": "123456"
  },
  "event_type": "digital_wallet.tokenization_approval_request",
  "tokenization_decline_reasons": [
    "ACCOUNT_SCORE_1"
  ],
  "tokenization_tfa_reasons": [
    "WALLET_RECOMMENDED_TFA"
  ],
  "rule_results": [
    {
      "auth_rule_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "result": "APPROVED",
      "name": "string",
      "explanation": "string"
    }
  ]
}
```

Updated 3 months ago