1. Initiate Card Payment (with 3DS)

Integrate unified card rails fully wrapped with native 3D Secure workflows. Submit card details securely and handle authorization flows seamlessly.

POST/v1/payments/card/initiate

Request

Headers

Authorization: Bearer sec_key_live_••••••••••••••••
Content-Type: application/json

Body

{
  "amount": 2500,
  "currency": "GHS",
  "email": "customer@example.com",
  "card": {
    "number": "4000123456789010",
    "expiry_month": "12",
    "expiry_year": "2028",
    "cvv": "123"
  },
  "redirect_url": "https://yourdomain.com/checkout/verify"
}

Response

{
  "status": "success",
  "transaction_reference": "TXN-CARD-90811A",
  "amount": 2500,
  "currency": "GHS",
  "message": "Payment authorized successfully.",
  "gateway_response": {
    "code": "00",
    "message": "Approved"
  }
}

⚠

Test environment only — no real transactions are processed. Use the test cards below.

Try the API

Fill in the form below to see a simulated API call and response in real time.

Test Cards

Customer Details

First Name

Last Name

Phone

Country

City

Address

Card Details

Card Number

Exp Month

Exp Year

CVV

Amount (GHS)

Live Payload Preview

{
  "amount": 2500,
  "currency": "GHS",
  "redirect_url": "https://yourdomain.com/checkout/verify"
}

Response

Response will appear here after you send the request.