Beneficiaries - Keette Developers

A beneficiary is a saved payout destination (bank account, mobile money, stablecoin address, and so on). Create one once, then reference its id on every payout.

Flow

Inspect corridors for the scheme and required fields
POST /v1/beneficiaries with those fields
Pass beneficiary_id to payouts

curl https://api.keette.com/v1/beneficiaries \
  -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Ada Okonkwo",
    "scheme": "ngn_bank",
    "currency": "NGN",
    "account_number": "0123456789",
    "bank_code": "058"
  }'

Updates and archive

PATCH /v1/beneficiaries/{id} — change mutable fields (name, metadata)
POST /v1/beneficiaries/{id}/archive — soft-delete; existing payouts keep their snapshot

List with GET /v1/beneficiaries. Fetch one with GET /v1/beneficiaries/{id}.

Next

Corridors — schemes and field requirements
Payouts — send to a beneficiary
API reference — full request shapes