Skip to main content
POST
/
api
/
v1
/
split-beneficiaries
Create Split Beneficiary
curl --request POST \
  --url https://checkout-staging.embedly.ng/api/v1/split-beneficiaries \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "organizationId": "<string>",
  "beneficiaryName": "<string>",
  "accountNumber": "<string>",
  "bankCode": "<string>",
  "bankName": "<string>",
  "beneficiaryAlias": "<string>"
}
'
{
  "statusCode": 200,
  "message": "Split beneficiary created successfully",
  "data": {
    "id": "1c7e2c80-9f8c-4bd8-8c9d-bd63810c5df9",
    "organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
    "beneficiaryName": "string",
    "accountNumber": "4278816938",
    "bankCode": "string",
    "bankName": "string",
    "beneficiaryAlias": "string",
    "isActive": true,
    "createdAt": "2026-02-16T07:57:04.4688132Z",
    "updatedAt": null
  }
}
​
organizationId
string
required
Example: 02600494-1a3c-11f0-a818-6045bd97b81d
​
beneficiaryName
string
required
Example: John Doe
​
accountNumber
string
required
Example: 7891256098
​
bankCode
string
Example: 30234.
​
bankName
string
Example: Sterling Bank.
​
beneficiaryAlias
string
Example: Testing.
{
  "statusCode": 200,
  "message": "Split beneficiary created successfully",
  "data": {
    "id": "1c7e2c80-9f8c-4bd8-8c9d-bd63810c5df9",
    "organizationId": "0075b72d-6648-11f0-a7cf-0274f77d4a81",
    "beneficiaryName": "string",
    "accountNumber": "4278816938",
    "bankCode": "string",
    "bankName": "string",
    "beneficiaryAlias": "string",
    "isActive": true,
    "createdAt": "2026-02-16T07:57:04.4688132Z",
    "updatedAt": null
  }
}