Initiate Transfer

Send money to your customers.

Transfer will be pending if OTP is yet to be provided.

Request Details

FieldData typeRequiredDescription
beneficiary.accountNumberstringYesThe recipient's number according to their account registration.
beneficiary.accountNamestringYesThe recipient's name according to their account registration.
beneficiary.bankNamestringYesRequired for all recipient types. You can get the list of Bank Names by calling the List Banks endpoint .
beneficiary.bankCodestringYesRequired for all recipient types. You can get the list of Bank Codes by calling the List Banks endpoint.
currencystringYesSee Supported Currencies only NGN available for now
amountnumberYesAmount to transfer
narrationstringYesThe reason for the transfer

After collecting the necessary details. Make a POST request to our transfer endpoint.

Note : Before making a post request, the secret key should be specified in the header.

-H "x-api-key: your_secret_key".
{{host}}/v1/transfer

If the API call is successful, Kyshi returns the following response:

{
    "beneficiary": {
        "accountNumber": "1111111103",
        "accountName": "FEMI ZACK",
        "bankCode": "000002",
        "bankName": "Keystone Bank"
    },
    "amount": 1000,
    "narration": "TEST",
    "currency": "NGN"
}
{
    "status": true,
    "code": 201,
    "message": "Success",
    "data": {
          "transferCode": "999999"
      }
}