Skip to main content
WEBHOOK
CARD_ISSUED
{
  "event":      "CARD_ISSUED",
  "eventId":    "evt_01HXY123456ABCDEF",
  "businessId": "BUS1A2B3C4D5E6F",
  "timestamp":  "2026-05-26T10:00:00Z",
  "data": {
    "cardId":         "crd_01HXYZ5555ABCDEF1111",
    "status":         "ACTIVE",
    "cardType":       "VIRTUAL",
    "cardBrand":      "VISA",
    "cardholderId":   "chl_01HXYZ1234ABCDEF5678",
    "maskedPan":      "445123******4123",
    "last4":          "4123",
    "expirationDate": "06/2030",
    "balance":        100.00,
    "currency":       "USD",
    "is3ds":          true,
    "isTokenized":    false,
    "isJitfEnabled":  false,
    "isOneTimeUse":   false
  }
}

{}
Fires after a successful POST /cards request once the card provider confirms the card is active and ready to use.

​
Event Type

CARD_ISSUED

​
Payload

{
  "event":      "CARD_ISSUED",
  "eventId":    "evt_01HXY123456ABCDEF",
  "businessId": "BUS1A2B3C4D5E6F",
  "timestamp":  "2026-05-26T10:00:00Z",
  "data": {
    "cardId":         "crd_01HXYZ5555ABCDEF1111",
    "status":         "ACTIVE",
    "cardType":       "VIRTUAL",
    "cardBrand":      "VISA",
    "cardholderId":   "chl_01HXYZ1234ABCDEF5678",
    "maskedPan":      "445123******4123",
    "last4":          "4123",
    "expirationDate": "06/2030",
    "balance":        100.00,
    "currency":       "USD",
    "is3ds":          true,
    "isTokenized":    false,
    "isJitfEnabled":  false,
    "isOneTimeUse":   false
  }
}

​
Payload Fields

FieldTypeDescription
cardIdstringThe newly issued card ID (prefix crd_)
statusstringAlways ACTIVE at issuance
cardTypestringVIRTUAL or PHYSICAL
cardBrandstringVISA or MASTERCARD
cardholderIdstringThe cardholder the card belongs to
isOneTimeUsebooleantrue for single-use cards that auto-terminate after their first settled transaction
maskedPanstringBIN-masked PAN — first 6 digits + 6 stars + last 4 (e.g. 445123******4123)
last4stringLast 4 digits of the PAN
expirationDatestringCard expiry in MM/YYYY format (e.g. 06/2030)
balancenumberCard balance in USD at issuance
currencystringCard currency (always USD)
is3dsboolean3D Secure enabled on this card
isTokenizedbooleanCard has been tokenised (Apple Pay / Google Pay)
isJitfEnabledbooleanJust-In-Time funding active
cvv, programId, and environment are intentionally excluded from webhook payloads. The CVV is only available once in the POST /cards issuance response.

​
Common Use Cases

  • Display the new card details to the cardholder in your UI
  • Record the card in your internal database linked to the cardholder
  • Trigger a “Your card is ready” push notification to the cardholder
{
  "event":      "CARD_ISSUED",
  "eventId":    "evt_01HXY123456ABCDEF",
  "businessId": "BUS1A2B3C4D5E6F",
  "timestamp":  "2026-05-26T10:00:00Z",
  "data": {
    "cardId":         "crd_01HXYZ5555ABCDEF1111",
    "status":         "ACTIVE",
    "cardType":       "VIRTUAL",
    "cardBrand":      "VISA",
    "cardholderId":   "chl_01HXYZ1234ABCDEF5678",
    "maskedPan":      "445123******4123",
    "last4":          "4123",
    "expirationDate": "06/2030",
    "balance":        100.00,
    "currency":       "USD",
    "is3ds":          true,
    "isTokenized":    false,
    "isJitfEnabled":  false,
    "isOneTimeUse":   false
  }
}

{}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
event
string
Example:

"CARD_ISSUED"

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

Response

200

Acknowledge the event.