Payouts

Payouts allow you to send funds to recipients across multiple countries through various payment methods. With Honeycoin's unified payout endpoint, you can send money to mobile money wallets, bank accounts, and other local payment destinations.

What Are Payouts?

Payouts are outbound transactions where you disburse funds from your Honeycoin account to recipients. The payout infrastructure handles different payment networks and currencies across supported regions.

Supported Payout Methods

Honeycoin supports multiple payout destinations:

Payout Coverage

Payouts are currently live in the following countries:

For a complete list of supported countries, payment methods, and transaction limits, please refer to the Supported Countries & Limits documentation.

For the latest list of supported mobile money operators in each country, see the Mobile Money Operators guide.

Key Features

Universal Endpoint

The Honeycoin payouts endpoint is universal, allowing you to send to any supported destination type through a single API endpoint.

Multi-Currency Support

Send payouts in the recipient's local currency or receive funds in your preferred wallet currency. Honeycoin handles currency conversion automatically.

External Accounts

Store recipient account details securely as external accounts, allowing you to make repeat payouts without re-entering information each time.

Real-Time Status Tracking

Track payout status through webhooks or by querying the transaction status.

How Payouts Work

The payout flow is straightforward:

1.Prepare payout details - Gather recipient information (name, account number, country, amount)

2.Choose destination - Select the payment method (mobile money, bank account, etc.)

3.Initiate payout - Send the payout request to Honeycoin's API

4.Monitor status - Track the payout through webhooks or status queries

5.Confirm delivery - Verify that funds have reached the recipient

Payout Limits and Considerations

Transaction Limits

Each country and payment method has minimum and maximum transaction limits. Ensure your payout amounts fall within these limits. Refer to Supported Countries & Limits for specific details.

Processing Time

Payout processing times vary by destination:

• Mobile Money - Typically 1-5 minutes
• Bank Transfers - Typically 1-24 hours depending on the bank
• Paybill/Till - Typically 1-5 minutes

Wallet Balance

Ensure your Honeycoin account has sufficient balance in the appropriate currency before initiating payouts. Payouts will fail if your account is underfunded.

Retrieving Bank Information

When making bank transfer payouts, use the Get Banks API to retrieve the list of supported banks for a specific country. This endpoint provides the bank codes needed for payout requests.

Example:

Plain Text

GET /api/b2b/utilities/banks?country=KE

This returns all supported banks in the specified country that can receive payouts.

Getting Started

To start making payouts:

1.Review the Payouts API Reference - Understand the endpoint parameters and response structure

2.Check Supported Countries & Limits - Verify your target country and payment method are supported

3.Review Mobile Money Operators - If paying to mobile money, identify the correct operator code

4.Use Get Banks API - For bank transfers, retrieve supported banks for the target country

5.Read the Payouts Implementation Guide - Follow step-by-step instructions for implementing payouts

6.Test in sandbox - Use test credentials to validate your integration before going live

Next Steps

• Payouts Implementation Guide - Complete guide to implementing payouts in your application
• API Reference - Detailed endpoint documentation
• External Accounts - Learn how to store and manage recipient accounts
• Get Transactions - Query payout status and history
• Get Banks - Retrieve supported banks for bank transfer payouts

Best Practices

• Validate recipient information before initiating payouts
• Use external accounts for recurring payouts to the same recipients
• Monitor payout success rates to identify potential issues
• Implement proper error handling for failed payouts
• Use webhooks for real-time payout status updates
• Keep detailed records of all payouts for reconciliation and auditing
• Test thoroughly in sandbox before deploying to production