Developers · Recipients

Recipients

Save and reuse the people and businesses you pay. A recipient is validated once, then referenced by id on every payment — so you never re-send sensitive details.

Create a recipient

curl https://sandbox.amnenpay.com/v1/recipients \
  -X POST \
  -H "Authorization: Bearer sk_test_51H8xExampleSandboxKeyOnly" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "phone",
    "name": "Amina Yusuf",
    "country": "KE",
    "currency": "KES",
    "phone": "+254712345678"
  }'

Recipient types

TypeDescription
phoneMobile money / wallet recipient identified by phone number.
bank_accountBank recipient with account number and bank code.
walletAnother Amnen wallet, identified by wallet ID.
cardPush-to-card recipient (where supported).

Endpoints

EndpointDescription
POST /recipientsCreate and validate a reusable recipient.
GET /recipientsList saved recipients.
GET /recipients/{id}Retrieve a recipient.
DELETE /recipients/{id}Remove a saved recipient.