Skip to main content
WEBHOOK
CARD_AUTHORIZATION
{
  "event":       "CARD_AUTHORIZATION",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T10:00:00Z",
  "data": {
    "cardId":       "crd_01HXYZ5555ABCDEF1111",
    "amount":       42.50,
    "currency":     "USD",
    "merchantName": "Amazon",
    "decision":     "APPROVED",
    "timestamp":    "2026-05-22T10:00:00Z"
  }
}

{}

Documentation Index

Fetch the complete documentation index at: https://docs.fyatu.com/llms.txt

Use this file to discover all available pages before exploring further.

Fires asynchronously after every authorization decision for a CaaS card — both approvals and declines. This event cannot influence the authorization outcome; it is informational only.

​
Event Type

CARD_AUTHORIZATION

​
Payload

{
  "event":       "CARD_AUTHORIZATION",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T10:00:00Z",
  "data": {
    "cardId":       "crd_01HXYZ5555ABCDEF1111",
    "amount":       42.50,
    "currency":     "USD",
    "merchantName": "Amazon",
    "decision":     "APPROVED",
    "timestamp":    "2026-05-22T10:00:00Z"
  }
}

​
Payload Fields

FieldTypeDescription
cardIdstringThe card that was authorized
amountnumberAuthorization amount (in dollars)
currencystringAuthorization currency (ISO 4217)
merchantNamestringMerchant name from the authorization request
decisionstringAPPROVED or DECLINED
timestampstringISO 8601 timestamp
For the full event group documentation see Card Events. 
{
  "event":       "CARD_AUTHORIZATION",
  "eventId":     "evt_01HXY123456ABCDEF",
  "businessId":  "BUS1A2B3C4D5E6F",
  "environment": "LIVE",
  "timestamp":   "2026-05-22T10:00:00Z",
  "data": {
    "cardId":       "crd_01HXYZ5555ABCDEF1111",
    "amount":       42.50,
    "currency":     "USD",
    "merchantName": "Amazon",
    "decision":     "APPROVED",
    "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_AUTHORIZATION"

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

Response

200

Acknowledge the event.