3DS Enrolment Check

https://auth.zamupay.com

POST

/apps/graph/api/v1/cybersource/payer-auth/enrolment

Step 2 of 3DS flow. Checks whether the card is enrolled in 3D Secure and determines if a challenge (OTP/biometric) is required.

Frictionless path: ChallengeRequired=false → use AuthenticationId directly in Authorisation.
Challenge path: ChallengeRequired=true → POST the Payload to StepUpUrl in a browser form. On redirect, proceed to Validate Result with the TransactionId query param.

Request

Authorization

Header Params

Body Params application/json

Examples

Responses

🟢200

text/plain

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://auth.zamupay.com/apps/graph/api/v1/cybersource/payer-auth/enrolment' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Content-Type: application/json' \
--data '{
  "SetupId": "3DS-SETUP-00789",
  "TransientToken": "transientToken_ZpKnXq...",
  "Amount": "1000",
  "Currency": "KES",
  "OrderId": "ORD-20250424-00123",
  "ReturnUrl": "https://checkout.partner.com/3ds/complete"
}'

Response Example

{
  "EnrolmentStatus": "ENROLLED",
  "ChallengeRequired": false,
  "AuthenticationId": "AUTH-3DS-00456",
  "Eci": "05",
  "Cavv": "AAABCSIIAAAAAAACcwgAEMCoNh==",
  "XId": "MDAwMDAwMDAwMDAwMDAwMDAwODI="
}

Modified at 2026-05-07 13:08:30

3DS Setup

3DS Validate Result