First Leeward

Webhook event

3DS Challenge Created

POSTCARD_3DS_CHALLENGE_CREATED

Fired when a new 3DS authentication challenge is received for a card. The partner must respond within the expiry window.

Body

application/json

idstringrequired

Unique event identifier for idempotency

typestringrequired

Webhook event type

Available options:CARD_3DS_CHALLENGE_CREATED
dataobjectrequired
Show child attributes
idstring<uuid>required

Unique 3DS challenge identifier

cardIdstring<uuid>required

ID of the card this challenge is for

statusstringrequired

Challenge status

Available options:PENDINGAPPROVEDREJECTEDEXPIRED
merchantobjectrequired

Merchant details

Show child attributes
namestringrequired

Merchant name

countryCodestringrequired

Merchant country code (ISO numeric)

transactionobjectrequired

Transaction details

Show child attributes
amountstringrequired

Transaction amount

currencystringrequired

Transaction currency (ISO alpha-3)

timestampstringrequired

ISO 8601 timestamp of the transaction

expiresAtstringrequired

ISO 8601 timestamp when this challenge expires

Response

200Webhook received successfully. Return any 2xx status to acknowledge.