Virtual account transfer lets you send NGN payouts from your available VA transfer balance to a Nigerian bank account.

Flow

1. List supported banks with GET /v1/va/transfer/banks.
2. Resolve the recipient account name with GET /v1/va/transfer/name-enquiry.
3. Create or reuse a beneficiary with POST /v1/va/transfer/beneficiaries.
4. Initiate the transfer with POST /v1/va/transfer.
5. Track transfers with GET /v1/va/transfer or GET /v1/va/transfer/{id}.

Authentication

Send your secret key in the request header for authenticated endpoints.

-H "x-api-key: your_secret_key"

Notes

• VA transfer currently runs on the NGN virtual account payout rail.
• Amounts are sent in major currency units. For example, 1000 means 1000 NGN.
• Kyshi validates that your business has enough available balance before initiating the transfer.