Skip to main content
WEBHOOK
CARD_TOKENIZATION_OTP
{
  "event":       "CARD_TOKENIZATION_OTP",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T10:00:00Z",
  "data": {
    "cardId":    "crd_01HXYZ5555ABCDEF1111",
    "code":      "513847",
    "type":      "WALLET_CODE",
    "timestamp": "2026-05-22T10:00:00Z"
  }
}

{}
Fires when a tokenization code is generated — typically when the cardholder adds their card to Apple Pay or Google Pay. Deliver the code to the cardholder to complete the wallet provisioning flow.

​
Event Type

CARD_TOKENIZATION_OTP

​
Payload

{
  "event":       "CARD_TOKENIZATION_OTP",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T10:00:00Z",
  "data": {
    "cardId":    "crd_01HXYZ5555ABCDEF1111",
    "code":      "513847",
    "type":      "WALLET_CODE",
    "timestamp": "2026-05-22T10:00:00Z"
  }
}

​
Payload Fields

FieldTypeDescription
cardIdstringThe card being added to a digital wallet
codestringThe one-time tokenization code
typestringAlways WALLET_CODE for this event
timestampstringISO 8601 timestamp
For the full event group documentation see Card Events. 
{
  "event":       "CARD_TOKENIZATION_OTP",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T10:00:00Z",
  "data": {
    "cardId":    "crd_01HXYZ5555ABCDEF1111",
    "code":      "513847",
    "type":      "WALLET_CODE",
    "timestamp": "2026-05-22T10:00:00Z"
  }
}

{}

Authorizations

​
Authorization
string
header
required

API key from the FYATU CaaS portal. Pass as Authorization: Bearer <key>.

Body

application/json
​
event
string
Example:

"CARD_TOKENIZATION_OTP"

​
eventId
string
​
businessId
string
​
environment
enum<string>
Available options:
LIVE,
SANDBOX
​
timestamp
string<date-time>
​
data
object

Response

200

Acknowledge the event.