Skip to main content
POST
Simulate 3DS authorization

Authorizations

Authorization
string
header
required

API key as Bearer token

Headers

Reap-Version
enum<string>
required

API version (YYYY-MM-DD)

Available options:
2025-02-14
Example:

"2025-02-14"

Body

Simulate a WEBHOOK 3DS challenge that defers authorization until the partner responds

cardId
string<uuid>
required

Card ID

amount
number
required

Merchant amount in the project's billing currency, before cardholder fees. Any FX markup or ATM fee that applies to the account is added on top, as in production, so the amount charged to the cardholder can be higher than this value.

Required range: x >= 0
Examples:

100.5

0

1234.99

originalAmount
number

Amount in the original transaction currency. Must be provided together with originalCurrency, and is required when the event lands on a transaction whose original currency is not the billing currency.

Required range: x >= 0
Examples:

100.5

0

1234.99

originalCurrency
string

Original transaction currency as an ISO 4217 alpha code (e.g. EUR). Must be provided together with originalAmount.

Pattern: ^[A-Z]{3}$
channel
enum<string>

Transaction channel. Defaults to ECOMMERCE when omitted.

Available options:
ATM,
POS,
ECOMMERCE,
VISA_DIRECT
Example:

"ATM"

digitalWallet
enum<string>

Digital wallet type (e.g. APPLE_PAY, GOOGLE_PAY). Randomly generated if omitted.

Available options:
APPLE_PAY,
GOOGLE_PAY,
MERCHANT_TOKEN
Example:

"APPLE_PAY"

merchant
object

Merchant details. All fields are optional; an omitted field is randomly generated, except country.

triggerFraudAlert
boolean

When true, also raises a detected fraud alert against the resulting charge. The alert arrives asynchronously; wait for the CARD_FRAUD_ALERT_CREATED event. Detection alone does not block the card.

Response

Response for status 200

id
string<uuid>
required

Unique 3DS challenge identifier

cardId
string<uuid>
required

ID of the card this challenge is for

status
enum<string>
required

Challenge status

Available options:
PENDING,
APPROVED,
REJECTED,
EXPIRED
Example:

"PENDING"

merchant
object
required

Merchant details

transaction
object
required

Transaction details

expiresAt
string
required

ISO 8601 timestamp when this challenge expires

Example:

"2024-01-15T10:35:00Z"