Moneywave
  • Moneywave
  • Introduction
  • Send Money to People
    • Banks and Destinations
    • Single Payout
    • Examples
      • Single USD Payout
      • Single ZAR Payout
      • Single KES Payout
    • Check Payout Status
    • Mass Payout
  • Funding for Payout
    • Balances
    • How to Fund
    • Fund with Cards
    • Fund via USSD
    • Check Funding Status
  • Transaction Reporting
    • Search / List
  • Manage Balances
    • Create Balance
    • Fetch Balance
    • Transfer Balance
  • Notifications
    • Asynchronous Payouts
    • Mass Payouts
    • Funding
    • Reversals
  • Authentication
  • POS
    • Onboarding
    • Dispense Error
Powered by GitBook
On this page
  1. Notifications

Funding

PreviousMass PayoutsNextReversals

Last updated 3 years ago

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.

  1. HTTP 200 code is returned for a successful callback

  2. Callbacks are idempotent such that multiple calls only credits your system once, resolved by checking for existing funding reference.

  3. 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 using the ref received in the notification.

here