Skip to main content
Preview a mobile money payout to confirm the phone number, amount, fee, and available balance. Then create the payout to send funds to the recipient’s mobile wallet. Pay from TZS or USD (currency). Recipients always receive TZS — mobile wallets cannot hold USD. When you pay from USD, preview and create responses include exchanged and exchange.
Create Mobile Money Payout allows one create request every 60 seconds per merchant. Creating another payout before the cooldown ends returns an error with the remaining wait time. Preview is not affected.

​
Prerequisites

  1. API Keys - Generate API Keys for Hosted Checkout integration
  2. Authorization Token - Use API Keys to Generate Authorization Token

​
How It Works

Step 1 - Retrieve Account Balance

Retrieve account balance

This endpoint retrieves account balance that can help check if merchant has enough funds to perform a payout
Step 2 - Validate payout details

Preview Mobile Money Payout

Validates mobile money payout details like phone number, amount, order-reference, fee
Step 3 - Initiate Mobile Money Payout

Create Mobile Money Payout

Initiate a mobile money payout by sending a request to the API. The specified amount will be transferred to the recipient’s mobile wallet.
Step 4 - Check payout status

Check Payout Status

This endpoint queries for the payout status using payout’s Order Reference