Tokenization Decisioning Request

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

{
  "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