Skip to main content
POST
Validate 3DS payer authentication

Authorizations

x-api-key
string
header
required

API key for authentication (required)

x-merchant-id
string
header
required

Merchant ID for identifying the merchant (required)

Path Parameters

id
string<uuid>
required

Payment order ID

Body

application/json
authenticationTransactionId
string
required

The authentication transaction ID returned from the 3DS challenge

Minimum string length: 1
Example:

"auth-txn-123456789"

Response

Payer authentication validated successfully

id
string<uuid>
required

Payment order ID

Example:

"123e4567-e89b-12d3-a456-426614174000"

status
enum<string>
required

Payment order status (typically AUTHORIZED after successful validation)

Available options:
PENDING,
PROCESSING,
REFERENCE_GENERATED,
AUTHORIZED,
PARTIALLY_AUTHORIZED,
ACTION_REQUIRED,
COMPLETED,
PARTIALLY_PAID,
CANCELLATION_REQUESTED,
CANCELLED,
FAILED,
REFUND_PROCESSING,
PARTIALLY_REFUNDED,
REFUNDED
Example:

"AUTHORIZED"

externalId
string

External payment order ID

Example:

"ORDER-123"

amount
number

Payment amount

Example:

250

currency
string

Currency code

Example:

"MXN"

customer
object

Customer details