Transactions 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 respond code is x06 a TSQ is required to determine the actual status of the transaction after 60 secs

• 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 60 secs.

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 60 secs. if outcome persists, please contact support.

A reversal can be initiated after 60 secs 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.