Simulate 3DS authorization
Simulates a WEBHOOK 3DS challenge for a card authorization. Returns a pending ThreeDsChallenge and delivers CARD_3DS_CHALLENGE_CREATED without creating a transaction. After POST /card-3ds-challenges/{id}/respond with approve: true, authorization completes and CARD_TRANSACTION_CREATED is delivered. With approve: false, the challenge is rejected and no transaction is created (mirrors production). The card must use 3dsChallengeMethod: WEBHOOK.
Authorizations
API key as Bearer token
Headers
API version (YYYY-MM-DD)
2025-02-14 "2025-02-14"
Body
Simulate a WEBHOOK 3DS challenge that defers authorization until the partner responds
Card ID
Amount in the project's billing currency
x >= 0100.5
0
1234.99
Amount in the original transaction currency. Must be provided together with originalCurrency.
x >= 0Original transaction currency as an ISO 4217 alpha code (e.g. EUR). Must be provided together with originalAmount.
^[A-Z]{3}$Transaction channel. Defaults to ECOMMERCE when omitted.
ATM, POS, ECOMMERCE, VISA_DIRECT "ATM"
Digital wallet type (e.g. APPLE_PAY, GOOGLE_PAY). Randomly generated if omitted.
APPLE_PAY, GOOGLE_PAY, MERCHANT_TOKEN "APPLE_PAY"
Merchant details. All fields are optional and will be randomly generated if omitted.
Response
Response for status 200
Unique 3DS challenge identifier
ID of the card this challenge is for
Challenge status
PENDING, APPROVED, REJECTED, EXPIRED "PENDING"
Merchant details
Transaction details
ISO 8601 timestamp when this challenge expires
"2024-01-15T10:35:00Z"