Disbursement

Once merchants successfully complete the Add Beneficiary or Account Verification, merchants will get an Active Beneficiary ID and can perform this Disbursement to instruct Ayoconnect to complete the Fund Transfer process.

Merchants will be notified of the final status of the disbursement in the callbacks whenever it is updated, or they can check the status of the disbursement by calling the 'check status' API.

In the case where the transaction has not been updated by the Bank, the first callback that merchant will get will be the status as Processing (0),

As getting the final status from the banks can take some time, although there can be some delay when receiving the callback, it will be delivered.

In case of a 201 HTTP response code in the callbacks with a transaction status as ‘0’ (Processing), please hit the ‘Check Status’ API or wait for the callback to receive the final status. Please ‘DO NOT FAIL’ the transactions before you get a callback with a transaction status as ‘1’ (Success) or as '4' (Failed).

In case of a 503 or 504 HTTP response code received in the callbacks with a transaction status as ‘0’ (Processing), please ‘DO NOT FAIL’ the transactions. Instead, hit the ‘Check Status’ API or wait for the callback to receive the final status.

In case of a 503 or 504 HTTP response code received in the callbacks with a transaction status as ‘4’ (Failed), you can mark the transaction as ‘failed’.

Important Notes:

• For the final status of a transaction, always refer to the 'status' field from the callbacks disbursement API before marking the transfer as a success or failed in the system, instead of just checking with the response code and error messages
• In case of a 201 HTTP response code in the callbacks with a transaction status as ‘0’ (Processing), please hit the ‘Check Status’ API or wait for the callback to receive the final status.
• In case of a 503 or 504 HTTP response code received in the callbacks with a transaction status as ‘0’ (Processing), please ‘DO NOT FAIL’ the transactions. Instead, hit the ‘Check Status’ API or wait for the callback to receive the final status.
• In case of a 503 or 504 HTTP response code received in the callbacks with a transaction status as ‘4’ (Failed), you can mark the transaction as ‘failed’.