OuiPay
API ReferencePayments

Payments

The payment resource : collecting funds with a resolved method.

A payment collects funds from a customer: always as a transaction entry with a payment attempt on a resolved method.

The payment object

{
  "id": "01M2S18...",
  "transaction_id": "01M2S18...",
  "customer_id": "01M2S17...",
  "amount_minor": 50000,
  "currency": "NGN",
  "method": "card",
  "status": "processing",
  "provider": {
    "slug": "flutterwave",
    "redirect_url": "https://checkout.flutterwave.com/..."
  },
  "created_at": "2026-09-18T02:00:00Z"
}
FieldTypeNotes
transaction_idstringThe transaction entry: source of truth
methodstringResolved method (card, bank_transfer, …)
statusstringMirrors the transaction's status

Endpoints

MethodPathDescription
POST/v1/paymentsCreate
GET/v1/payments/{id}Retrieve
GET/v1/payments/methodsSelectable methods for a customer

On this page