Skip to content

docs / beneficiaries

Beneficiaries

Beneficiaries are saved payout recipients. Instead of passing full account details on every payout, save a beneficiary once and reference it by id.

The beneficiary object

json
{
  "id": "ben_01j9xyz001",
  "name": "Kwame Mensah",
  "type": "bank_account",
  "accountNumber": "0123456789",
  "bankCode": "044",
  "bankName": "Access Bank",
  "country": "NG",
  "currency": "NGN",
  "createdAt": "2025-01-10T09: 00: 00Z"
}

Create a beneficiary

POST/v1/beneficiaries