Confirm card payment | AlphaX

curl -X POST https://public-api.alphax.com/card-payments/confirm \
     -H "X-API-Key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "reference": "ORDER-123123",
  "token": "<token_from_sdk>",
  "amount": 1050,
  "currency": "USD",
  "billing": {
    "firstName": "John",
    "lastName": "Snow",
    "email": "john.snow@example.com",
    "addressLine1": "1 Raffles Place",
    "city": "Singapore",
    "state": "Singapore",
    "postalCode": "048616",
    "countryCode": "SG",
    "phone": "+6591234567",
    "addressLine2": null
  }
}'

{
  "transaction": {
    "ulid": "01kqc6aaq3jshqyz6a0k8nkxfe",
    "reference": "ORDER-123123",
    "amount": 1050,
    "currency": "USD",
    "fee_amount": 35,
    "fee_currency": "USD",
    "status": "AUTHORIZED",
    "created_at": "2026-04-29T08:40:16+00:00"
  }
}

Confirm a card payment using the token returned by the Card Payment SDK’s submit().

Authentication

X-API-Keystring

API Key authentication via header

Request

Your payment details

referencestringRequired

Your unique payment reference (e.g. ORDER-123123)

tokenstringRequired

Token returned by the Card Payment SDK’s submit()

amountintegerRequired>=100

Amount in cents, minimum 100 (e.g. 1050 = 10.50 USD)

currencyenumRequired

Currency in ISO 4217 3-letter format. Only USD is supported at the moment.

Allowed values:

billingobjectRequired

Response

Card payment confirmed

transactionobjectOptional

Errors

422

Unprocessable Entity Error