Skip to main content

Capture a card payment

POST 
/api/v1/payment/card/complete/:reference

Reads the attempt's authentication result from the gateway, decides, and issues the PAY. Called by the page when 3D Secure is not offered, and as a safety net after a challenge. Idempotent: a capture already credited answers alreadyPaid, and a second call while one is in flight answers PENDING. If the gateway does not answer the PAY, it answers PENDING with gatewayCode UNCONFIRMED: poll GET /api/v1/payment/verify/{reference}, which asks the gateway and settles it, and never start another attempt meanwhile. Always HTTP 200; branch on data.status.

Request​

Responses​

Outcome in data.status: SUCCESSFUL, DECLINED, PENDING or FAILED