Lithic · Schema

tokenization-request-base

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

FinTechBaaSCard IssuingPaymentsEmbedded Finance

Properties

Name	Type	Description
account_token	string	Unique identifier for the user tokenizing a card
card_token	string	Unique identifier for the card being tokenized
created	string	Indicate when the request was received from Mastercard or Visa
device	object
issuer_decision	string	Whether Lithic decisioned on the token, and if so, what the decision was. APPROVED/VERIFICATION_REQUIRED/DENIED.
tokenization_channel	string	The channel through which the tokenization was made.
tokenization_source	string	The source of the tokenization.
tokenization_token	string	Unique identifier for the digital wallet token attempt
wallet_decisioning_info	object

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/tokenization-request-base",
  "title": "tokenization-request-base",
  "description": "Base properties shared by both tokenization decisioning requests (with response) and without",
  "type": "object",
  "properties": {
    "account_token": {
      "description": "Unique identifier for the user tokenizing a card",
      "example": "00000000-0000-0000-0000-000000000002",
      "type": "string"
    },
    "card_token": {
      "description": "Unique identifier for the card being tokenized",
      "example": "00000000-0000-0000-0000-000000000001",
      "type": "string"
    },
    "created": {
      "description": "Indicate when the request was received from Mastercard or Visa",
      "format": "date-time",
      "type": "string"
    },
    "device": {
      "$ref": "#/components/schemas/device"
    },
    "issuer_decision": {
      "description": "Whether Lithic decisioned on the token, and if so, what the decision was. APPROVED/VERIFICATION_REQUIRED/DENIED.",
      "enum": [
        "APPROVED",
        "DENIED",
        "VERIFICATION_REQUIRED"
      ],
      "example": "APPROVED",
      "type": "string"
    },
    "tokenization_channel": {
      "description": "The channel through which the tokenization was made.",
      "enum": [
        "DIGITAL_WALLET",
        "MERCHANT"
      ],
      "example": "DIGITAL_WALLET",
      "type": "string"
    },
    "tokenization_source": {
      "description": "The source of the tokenization.",
      "enum": [
        "ACCOUNT_ON_FILE",
        "CONTACTLESS_TAP",
        "MANUAL_PROVISION",
        "PUSH_PROVISION",
        "TOKEN",
        "UNKNOWN"
      ],
      "example": "PUSH_PROVISION",
      "type": "string"
    },
    "tokenization_token": {
      "description": "Unique identifier for the digital wallet token attempt",
      "type": "string"
    },
    "wallet_decisioning_info": {
      "$ref": "#/components/schemas/wallet-decisioning-info"
    }
  },
  "required": [
    "account_token",
    "card_token",
    "created",
    "issuer_decision",
    "tokenization_channel",
    "tokenization_token",
    "wallet_decisioning_info"
  ]
}