Mobile Money Collection

The TemboPlus Mobile Money (MOMO) Collection APIs let you collect payments directly from customer mobile wallets using USSD push, monitor your collection wallet balance, retrieve transaction history, and track the status of each transaction.

These APIs are designed for businesses that receive frequent mobile money payments and need reliable, traceable collections with real-time updates.

---

What You Can Do

✅ Initiate USSD Collection Requests — Request payments from customer mobile wallets ✅ Check Collection Wallet Balance — Retrieve your collection wallet’s current and available balance at any time. ✅ View Collection Account Statement — Pull detailed transaction history for your collection wallet over a date range. ✅ Track Transaction Status — Query the latest status of a specific collection transaction using its reference and ID.

---

How MOMO Collection Works

1. Initiate a USSD payment You call the Collect from Mobile Money endpoint with the required payload.

2. Customer receives a USSD prompt The customer is prompted by their Mobile Network Operator (MNO) to confirm the payment by entering their PIN.

3. Customer authorizes or rejects the payment The MNO processes the PIN entry and returns the final result to TemboPlus.

4. TemboPlus notifies your system TemboPlus sends a POST request to your configured callbackUrl with the latest transaction status.

---

Supported Channels

TemboPlus currently supports the following Mobile Money Collection channels in Tanzania:

Channel	Mobile Network Operator (MNO)	TemboPlus Channel Code
Airtel Money	Airtel Tanzania	TZ-AIRTEL-C2B
HaloPesa	Viettel Tanzania (Halotel)	TZ-HALOTEL-C2B
Mixx by Yas (formerly Tigo Pesa)	Honora Tanzania (Yas)	TZ-TIGO-C2B

---

Getting Started

Before integrating the MOMO Collection APIs, make sure you have:

From TemboPlus

• API Base URL (The base URL for your environment e.g. sandbox or production)

• Partner Account ID (Your unique account identifier)

• Partner Secret Key (Key to authenticate all requests)

From Your Side

• Webhook URL (callbackUrl) An HTTPS endpoint that can receive POST requests with JSON payloads.

---

🧩 Next Steps

To integrate successfully with TemboPlus MOMO Collection:

1. Review the API Reference to understand:

   • Authentication and required request headers

   • Environment setup and supported channels

   • Common error responses and standardized status codes

2. Study the MOMO Collection Flow for an overview of how transactions move between TemboPlus, MNOs, and customer USSD sessions.

3. Explore the API endpoints for implementation details:

   • Initiate MOMO Collection — Start a USSD push request to collect funds

   • Collection Balance — Retrieve your collection wallet balance

   • Collection Statement — View detailed transaction history

   • Transaction Status — Query the outcome of a specific transaction

---

💡 Tip

If you are new to TemboPlus, begin in the sandbox environment to test your end-to-end flow before switching to production.