Transfer API

Transfers endpoint are used for end to end transfers within and across acc

It is very important to note that all transfer request must be authenticated with your authentication token.

Possible transfer responses and their meaning

Handling Transaction Response

IsSuccessful

This response parameter is used to determine the status of the initiated request.

• If response is False, a possible system error or invalid request occurred. Transaction should be initiated again and can be initiated with the same transaction reference.

• If response is True, proceed to check the response code to determine the status of the transaction.

ResponseCode

This response parameter is used to determine the status of the transaction.

• If respond code is 00, then the transaction is successful

• If any of the “pending” response codes is gotten, then a TSQ is required to determine the actual status of the transaction after the interval time stated for each transaction type

• If any other response code is received, the transaction failed, and the request can be initiated with a new transaction reference.

• If No Response is received, a transaction status query is required to determine the status of the transaction after the interval time stated for each transaction type.

Handling TSQ Response

IsSuccessful

• This response parameter is used to determine the status of the initiated TSQ request.

• If response is False, possible system error or invalid request occurred. The TSQ request should be initiated again.

• If response is True, proceed to check the “Status” to determine the actual status of the initiated funds transfer request.

Status

This response parameter is used to determine the status of the initiated funds transfer request

• If status is Successful, then the initiated funds transfer request was processed successfully

• If status is Failed, then the initiated funds transfer request failed, a new request can be initiated with a new transaction reference.

• If status is Pending, then we are unable to determine the status of the transaction. Kindly initiate another TSQ request after the interval time stated for each transaction type. if outcome persists, please contact support

A reversal request should NEVER be initiated for INTERBANK transfer irrespective of the transfer or TSQ status, while reversals for other transaction types such as (DEBIT, CREDIT, LOCALFUNDSTRANSFER) can be initiated after 90 seconds of a successful transaction)

Handling Reversal Response

IsSuccessful

This response parameter is used to determine the status of the initiated reversal request.

• If response is False, a possible system error or invalid request occurred. The reversal request should be initiated again.

• If response is True, proceed to check the “Status” to determine the actual status of the reversal.

Status

This response parameter is used to determine the status of the reversal

If status is Successful, then the reversal was processed successfully.

If status is Failed, then the reversal should be initiated again.