Create a beneficiary for VA transfers. If the beneficiary already exists for the same business, account number, bank, and mode, Kyshi returns the existing beneficiary.

-H "x-api-key: your_secret_key"

POST {{host}}/v1/va/transfer/beneficiaries

Request Body

Field	Data Type	Required	Description
accountName	string	Yes	Recipient account name. You can get this from name enquiry.
accountNumber	string	Yes	Recipient bank account number.
bankName	string	Yes	Recipient bank name.
bankCode	string	Yes	Bank code returned from the List VA Banks endpoint.
currency	string	Yes	Use `NGN`.
description	string	No	Description for the beneficiary.
bvn	string	No	Recipient BVN, when required.
nameEnqRef	string	No	Name enquiry reference returned by name enquiry, when available.

{
  "accountName": "FEMI ZACK",
  "accountNumber": "0123456789",
  "bankName": "Access Bank",
  "bankCode": "000014",
  "currency": "NGN",
  "description": "Supplier payout",
  "nameEnqRef": "SESSION_123456789"
}

If the API call is successful, Kyshi returns the beneficiary.

{
  "status": true,
  "message": "Success",
  "code": 201,
  "data": {
    "id": "8495ec4e-ce21-405f-b0cf-982702881f4d",
    "accountName": "FEMI ZACK",
    "accountNumber": "0123456789",
    "bankName": "Access Bank",
    "bankCode": "000014",
    "bvn": "",
    "providerId": "SESSION_123456789",
    "description": "Supplier payout",
    "isActive": true,
    "mode": "live",
    "createdAt": "2026-05-20T10:15:00.000Z",
    "updatedAt": "2026-05-20T10:15:00.000Z"
  }
}