Skip to main content
POST
Simulate a 3DS challenge

Authorizations

Api-Key
string
header
required

Body

application/json

3DS challenge simulation request

cardId
string<uuid>
required

The Rain card ID to simulate the challenge for. Must be an active card belonging to your tenant.

amount
integer
required

The transaction amount in cents.

Required range: x >= 1
merchantName
string
required

The merchant name to include in the challenge details.

deliveryMethod
enum<string>
required

The OTP delivery method. PUSH is not supported for simulation.

Available options:
SMS,
EMAIL,
WHATSAPP

Response

Successful operation

challengeId
string<uuid>
required

Unique identifier for this challenge session.

oneTimePassword
string
required

The 6-digit OTP that your system should deliver to the cardholder.

expiryTime
string<date-time>
required

When the challenge expires (5 minutes from creation).