Funding
Callback for Balance Top-up
Successful top-up to currency balances triggers a callback notification. Notification type is HTTP GET and includes the data below
{ref} - Your Transaction Reference
{status} - Transaction Status as completed or failed
{amount} - Transaction Amount
Data passed is available as query parameters attached to your server endpoint url. This endpoint is defined on your server and should be setup to accept the values above.
Callback RETRY - Notifications for balance top-up are resent if a valid response is not received from your servers. Due to this, you would need to ensure three things.
HTTP 200 code is returned for a successful callback
Callbacks are idempotent such that multiple calls only credits your system once, resolved by checking for existing funding reference.
HTTP 200 code is returned if a funding reference already exists.
Full Information - To fetch additional information about the funding transaction, such as source, time etc, you should call the Check Funding Status API here using the ref received in the notification.
Last updated