Skip to main content
POST
/
v2
/
payment-orders
/
{id}
/
payer-authentication
/
validate
Validate 3DS payer authentication
curl --request POST \
  --url http://localhost:3156/v2/payment-orders/{id}/payer-authentication/validate \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-merchant-id: <api-key>' \
  --data '
{
  "authenticationTransactionId": "auth-txn-123456789"
}
'
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "externalId": "ORDER-123",
  "status": "AUTHORIZED",
  "amount": 250,
  "currency": "MXN"
}

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,
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