Beneficiaries
Create Beneficiary
Create beneficiaries in order to split payments
Create a new beneficiary for the specified merchant.
Currently split payments are only supported when using Paystack
Endpoint
POST /api/merchants/{merchant_id}/beneficiaries
Authentication: Required (API Key)
Request
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
merchant_id | UUID | Yes | The merchant ID for whom to create the beneficiary |
Body Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
type | string | Yes | Recipient type for the bank account. Options: nuban, ghipss, mobile_money, basa. See Paystack's Transfer Recipients documentation. |
bank_code | string | Yes | Paystack bank code identifying the recipient's bank. Example: "021" for Standard Bank. See Paystack's bank list for valid codes. |
account_number | integer | Yes | The beneficiary's account number |
connection_id | string | Yes | The connection ID of the connection for which the beneficiary should be created |
currency | string | Yes | Currency of the beneficiary account |
name | string | Yes | Beneficiary name, also visible in the NjiaPay portal |
description | string | Yes | Beneficiary description, also visible in the NjiaPay portal |
To get valid bank codes for your country, call Paystack's List Banks API:
https://api.paystack.co/bank?country=nigeriaExample
Terminal
curl -X POST "https://app.infinic.com/api/merchants/{merchant_id}/beneficiaries" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Seller XYZ",
"type": "nuban",
"bank_code": "021",
"account_number": "0123456789",
"currency": "NGN",
"connection_id": "pstck-xxxxx",
"description": "Marketplace seller payment account"
}'
Response
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "string",
"description": "string",
"currency": "ZAR",
"external_id": "string",
"created": "2026-02-08T13:58:54.489Z",
"updated": "2026-02-08T13:58:54.489Z"
}