Payments

Verify a checkout

GET/api/v1/checkout/sessions/{reference}

Asks the provider about an open payment before answering, so a merchant confirming an order sees the current outcome.

AuthorizationBearer sk_test_… or sk_live_…

Path parameters#

referencestringRequired
Up to 100 characters.

Responses#

200The checkout
401The secret key is missing, invalid or revoked.
404Nothing was found for this business and mode.

curl "https://api.vervapay.com/api/v1/checkout/sessions/order-1001" \
  -H "Authorization: Bearer $FASTPAY_SECRET_KEY"

200The checkout

{
  "data": {
    "amount_minor": 500000,
    "checkout_url": "https://fastpay.ng/pay/…",
    "created_at": "2026-10-28T09:00:00Z",
    "currency": "NGN",
    "customer_email": "ada@example.com",
    "expires_at": "2026-10-28T09:00:00Z",
    "id": "6f1c2a52-5d0b-4f7e-9a51-3c7c2f0d8e11",
    "mode": "test",
    "reference": "order-1001",
    "status": "completed",
    "completed_at": "2026-10-28T09:00:00Z",
    "description": "Order 1001",
    "payment": {
      "id": "6f1c2a52-5d0b-4f7e-9a51-3c7c2f0d8e11",
      "status": "succeeded",
      "fee_minor": 7500,
      "net_minor": 492500,
      "paid_at": "2026-10-28T09:00:00Z",
      "payment_method": "card"
    }
  }
}