Quickstart

Get your first payment live in under 10 minutes.

1 — Register a merchant account

Create a merchant account and complete KYC verification. Once approved you can generate API keys from your merchant dashboard under Developer → API Keys.

2 — Get your API key

API keys have two modes:

Keep your live key secret. Never expose it in client-side code.

3 — Create a payment intent

curl -X POST https://quatapay.com/api/v1/gateway/payments \
  -H "Authorization: Bearer qpay_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 5000,
    "currency": "XAF",
    "description": "Order #1042",
    "return_url": "https://your-site.com/success",
    "cancel_url": "https://your-site.com/cancel",
    "customer_reference": "cust_abc123"
  }'

Response:

{
  "data": {
    "payment": {
      "id": "pay_…",
      "slug": "abc123def456",
      "status": "requested",
      "amount": 5000,
      "currency": "XAF",
      "created_at": "2025-05-11T09:00:00Z"
    },
    "checkout_url": "https://quatapay.com/checkout/abc123def456"
  }
}

4 — Redirect the customer

Redirect the customer browser to the checkout_url. They will:

1. Log in to their QuataPay account (or create one)
2. Review the payment amount and merchant details
3. Confirm with their wallet PIN
4. Be redirected to your return_url on success

5 — Receive the webhook

Configure a webhook endpoint in Developer → Webhooks. QuataPay will POST to your URL when a payment completes or fails:

{
  "event": "payment.succeeded",
  "data": {
    "id": "pay_…",
    "slug": "abc123def456",
    "status": "succeeded",
    "amount": 5000,
    "currency": "XAF",
    "customer_reference": "cust_abc123",
    "transaction_id": "tx_…"
  }
}

Verify the X-QuataPay-Signature header — see the Webhooks page for verification code.

Next steps

• API reference — all endpoints
• Webhooks — signature verification + event catalogue
• Sandbox — test cards, test wallets, and simulated scenarios