🚧

IMPORTANT: How Xfers handles your payments safely

As a Fintech platform powering digital payments, the reliability of our transactions is a key priority for us. In this section, we will go through how your transactions can be handled safely.

Beneath our simple APIs are connections to many payment networks and banks in the region. These payment networks and banks have varying degrees of reliability and feature sets, and these intricacies are handled automatically by Xfers behind the scenes.

Here are two rules you should follow to handle your transactions:

1. Checking the success of a payment

The status is key here. Always check the status of the transaction in the API response / callback to make sure that it is either paid or completed before considering it a successful transaction for your customer.

Visit here for information about Payment Statuses: Payment Statuses

2. Handling failures

On rare occasions, there might be network failures such as timeouts, or HTTP 5xx responses.
Always double check whether the previous transaction has really failed by doing a GET to retrieve the transaction status again.

If you want to retry transactions, make use of the same referenceId as before. This way, Xfers will know that you are trying to retry a previous transaction. We will only attempt to retry it if our systems detect that it has not succeeded previously.

Visit here for information about idempotent requests: Idempotent Requests