Confirm Transfer

Request Details

FieldData typeRequiredDescription
transferCodestringYesThe transfer code you want to complete
otpstringYesOTP sent to business email to verify 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/confirm

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

{
    "transferCode": "TRF_Ij8_f75v5eLNbEt",
    "otp": "123456"
}
{
    "data": {
        "id": "ae65e9ca-331c-4d35-b47f-73bdc02a41dc",
        "otp": "123456",
        "code": "TRF_zxjtah4G1jedEaB",
        "status": "APPROVED",
        "approvedAt": "2024-07-09T14:26:38.171Z",
        "createdAt": "2024-07-09T14:26:38.171Z",
        "updatedAt": "2024-07-09T14:26:38.171Z",
        "version": 1,
        "transaction": {
            "id": "20bcdd85-91d6-414e-99d3-d3c4be2a6c8c",
            "type": "DR",
            "amount": 1005,
            "netAmount": 1000,
            "narration": "TEST",
            "status": "SUCCESS",
            "balanceBefore": 100000,
            "balanceAfter": 98995,
            "orderNumber": null,
            "reference": "KYSHI-1720538798194",
            "currency": "NGN",
            "channel": "transfer",
            "ipAddress": "102.88.81.123",
            "processor": "VFD",
            "apiLog": {},
            "meta": {
                "amount": 0,
                "symbol": "$",
                "currency": "USD"
            },
            "feeBreakDown": {
                "processorFee": 0,
                "vat": 0,
                "fee": 5,
                "allInclusiveKyshiFee": 5
            },
            "feeBearer": "CUSTOMER",
            "createdAt": "2024-07-09T14:26:38.171Z",
            "updatedAt": "2024-07-09T14:26:38.171Z",
            "version": 1
        },
        "beneficiary": {
            "id": "8495ec4e-ce21-405f-b0cf-982702881f4d",
            "accountName": "FEMI ZACK",
            "accountNumber": "1111111103",
            "bankName": "Keystone Bank",
            "bankCode": "000002",
            "bvn": "22222222224",
            "description": "TEST",
            "isActive": true,
            "createdAt": "2024-07-08T13:25:58.115Z",
            "updatedAt": "2024-07-08T13:25:58.115Z",
            "version": 1
        }
    },
    "status": true,
    "message": "Success",
    "code": 200
}