Transfers let you move money from your available payout balance to a saved or inline beneficiary.

Recommended Flow

1. List banks for the payout currency.
2. Resolve the beneficiary account name.
3. Create a beneficiary and store the returned beneficiary ID.
4. Initiate the transfer with beneficiaryId, amount, currency, and narration.
5. List or fetch transfers to reconcile payout status.

When To Use Transfers

Use Transfers for standard payouts to customers, suppliers, vendors, or internal recipients. For repeated recipients, create a beneficiary once and store the beneficiary ID in your system.

Beneficiary Strategy

Use a saved beneficiary when you expect to pay the same account more than once. Use an inline beneficiary only for one-off payouts where storing the recipient is not useful.

Balance And Fees

Kyshi checks your available balance before sending a payout. The balance must cover both:

• the transfer amount
• the total payout fees

If the available balance is not enough, Kyshi returns Insufficient Funds.

Currency Notes

Standard transfers support the payout currencies enabled for your business. The backend accepts supported merchant collection currencies such as NGN, KES, GHS, ZAR, XOF, and USD, depending on the payout rail and business configuration. Amounts are sent in major currency units.

Reconciliation Notes

Store the transfer ID and returned transfer code/reference. Use list and fetch endpoints to recover status if your request times out or a webhook is delayed.

For exact request and response schemas, see Reference > Transfers.