API ReferenceBeneficiaries
Beneficiaries
The beneficiary resource : verified payout destinations.
A beneficiary is a verified payout destination: a bank account, mobile money number, or another OuiPay wallet. Create once, reuse for multiple transfers.
The beneficiary object
{
"id": "01M2S17...",
"customer_id": "01M2S17...",
"type": "bank_account",
"bank_code": "058",
"account_number": "0123456789",
"account_name": "Amara Okonkwo",
"currency": "NGN",
"created_at": "2026-09-18T01:13:51Z"
}| Field | Type | Notes |
|---|---|---|
type | string | bank_account, mobile_money, wallet |
account_name | string | Resolved at creation (verified) |
Account details are verified at creation: an invalid destination fails fast, before any money moves.
Endpoints
| Method | Path | Description |
|---|---|---|
| POST | /v1/beneficiaries | Create |
| GET | /v1/beneficiaries/{id} | Retrieve a beneficiary |