'/%3e%3cdefs%3e%3cpattern%20id='pattern0_2104_4598'%20patternContentUnits='objectBoundingBox'%20width='1'%20height='1'%3e%3cuse%20xlink:href='%23image0_2104_4598'%20transform='matrix(0.00376176%200%200%200.0172414%20-0.00219436%200)'/%3e%3c/pattern%3e%3cimage%20id='image0_2104_4598'%20width='267'%20height='58'%20preserveAspectRatio='none'%20xlink:href='data:image/png;base64,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'/%3e%3c/defs%3e%3c/svg%3e)
Corridor-Specific Behavior: Ghana (GHS Payouts)
1. Overview
Ghana is one of Africa’s strongest mobile money ecosystems.
While traditional bank accounts exist and are growing, mobile money (especially MTN Mobile Money, also known as MTN MoMo ) dominates daily payments, merchant transactions, and personal fund transfers.
Bitnob supports two rails for GHS payouts:
Mobile money (mobile_money): Wallet payouts to MTN MoMo, Telecel Cash and AirtelTigo Money, identified by phone number. Send network as mtn, vodafone (Telecel) or airtel (AirtelTigo).
Bank account (bank): Payouts to Ghanaian bank accounts, identified by bank code and account number.
Both rails use the same flow — Create Quote, Initialize, Finalize. Only the beneficiary object changes. Get Supported Countries returns both mobile_money and bank as destination types for the GHS corridor.
2. Settlement Methods Available
method | description |
|---|---|
Mobile Money Payouts | Mobile phone number-based wallets on MTN MoMo, Telecel Cash and AirtelTigo Money. Send network: mtn, vodafone (Telecel) or airtel (AirtelTigo) to match the recipient's number. |
Bank Account Payouts | Transfers to Ghanaian bank accounts. Send destination_type: bank with the bank's bank_code from Get Banks (e.g. GH190100 for Stanbic Bank), the account_number and the account_name. |
Bank codes come from Get Banks.
Over 90% of retail and micro-merchant payouts favor Mobile Money channels, especially MTN.
3. Beneficiary Validation Standards
How you validate a GHS beneficiary depends on the rail.
Mobile money: For MTN numbers, confirm the wallet with Account Lookup — pass type=mobile_money, MTN as the bank_code, and the phone number with the 233 country code as the account_number.
Bank account: Account Lookup does not support Ghana bank accounts yet, so you can't resolve the account name before paying out. Take the bank_code from Get Banks and collect the account_name from your user.
Because the account name isn't verified up front, a wrong account number can only be caught when the bank rejects the transfer. Confirm the account number and account name with your user before you finalize.
type | validation process |
|---|---|
Mobile Money Wallets | Validate phone number format and work out the network from the prefix. Resolve MTN wallet names with Account Lookup. |
Bank Accounts | Check the bank_code against Get Banks for GH. Check the account number is digits only and matches the length your user's bank uses. Account Lookup is not available, so have the user confirm the account name. |
Best Practices for Mobile Money Validation
Work out the network from the phone number prefix and send the matching network.
Normalize mobile numbers (e.g., remove leading 0, standardize to international format if needed, e.g., 23324xxxxxxx).
Check wallet registration status if provider API allows.
Check wallet tier restrictions (if available) for maximum transaction limits.
4. Mobile Money Wallet Tiering and Transaction Limits
Mobile money accounts in Ghana are often tiered based on KYC — the corridor min/max Bitnob enforces comes from Get Limits:
wallet tier | limits |
|---|---|
Tier 0 (Basic Registration) | Low daily transaction limit (~GHS 1,000) and low wallet balance cap. |
Tier 1 (Full KYC with ID) | Higher daily limits (~GHS 5,000–10,000) and wallet caps. |
Tier 2 (Business Wallets) | Even higher limits, used for SMEs and merchants. |
Impact on Payouts:
If a payout exceeds the recipient's wallet tier limit, the transaction will fail immediately or be auto-reversed to sender.
Some providers may hold funds temporarily pending user wallet upgrade (rare but possible).
Product Requirement:
Educate users about wallet limits when setting up high-value payouts.
Monitor reversals dynamically and surface payout status changes to users immediately.
5. Payout Timing Expectations
phase | expected time |
|---|---|
Funding Confirmation (Bitcoin/Stablecoin) | <15 minutes (depending on network congestion). |
Mobile Money Payout Processing | Instant |
Bank Account Payout Processing | 1 to 10 minutes |
6. Common Failure Modes
failure mode | description | response strategy |
|---|---|---|
Wrong Network | The network sent doesn't match the recipient's number, for example mtn for a Telecel Cash number. | Work out the network from the prefix before paying out. See the prefix table below. |
Invalid Mobile Number | Wrong length or format; Ghanaian mobile numbers are 10 digits nationally (0XXXXXXXXX). | Normalize to a single format and validate the prefix before submitting. |
Inactive or Unregistered Mobile Money Account | Mobile money account closed, dormant, or never completed registration. | Resolve the account name before paying with Account Lookup; fail fast and refund rather than retrying blindly. |
Limit Exceeded | Payout above the recipient's daily limit. | Split large payouts into compliant amounts. |
Invalid Bank Account or Bank Code | Account number doesn't exist at the bank, or the bank_code doesn't match the recipient's bank. | Take bank codes from Get Banks rather than hardcoding them. Because Account Lookup isn't available for Ghana bank accounts, have the user confirm the details before finalizing. |
Related endpoints: Account Lookup, Get Banks.
Ghana Mobile Money Network and Prefixes
GHS mobile money payouts go to MTN MoMo, Telecel Cash and AirtelTigo Money. Send the network that matches the recipient's number.
MTN is the largest mobile network operator in Ghana and the dominant mobile money provider (over 90% of wallet market share).
network | network value | prefixes |
|---|---|---|
MTN MoMo | mtn | 024, 054 (original ranges); 025, 055, 059 (added later) |
Telecel Cash (formerly Vodafone Cash) | vodafone | 020, 050 |
AirtelTigo Money | airtel | 026, 056 |
Mobile money wallets are tightly linked to these phone numbers.
Validation Best Practices for Ghana Mobile Money
step | best practice |
|---|---|
Phone Format | Normalize numbers (drop leading 0 if formatting for international +233 dialing). Example: 024xxxxxxx → 23324xxxxxxx |
Carrier Mapping | Work out the network from the prefix and send the matching network value. |
Wallet Status Check | If possible, query provider API to validate if mobile wallet is active and capable of receiving payouts. |
Amount Limits | Respect wallet tier transaction limits, especially for Tier 0/Tier 1 users. |
7. Operational Best Practices for Ghana Corridor
area | recommendation |
|---|---|
Network Detection | Work out the network from the phone number prefix and send the matching network value (mtn, vodafone or airtel). |
Number Normalization | Store one canonical format (e.g., 23324xxxxxxx) and normalize on input so 024xxxxxxx, +233 24 xxx xxxx, and 23324xxxxxxx all resolve to the same wallet. |
Validation | For MTN numbers, resolve the beneficiary name with Account Lookup before releasing funds, passing MTN as the bank_code. Ghana bank accounts can't be looked up yet. |
Bank Payouts | Take bank codes from Get Banks rather than hardcoding them, and show the user the account name and number to confirm before you finalize. Set expectations that bank payouts take 1 to 10 minutes. |
Related endpoints: Account Lookup, Get Banks.
Quick Reference Table
field | value |
|---|---|
Rails | Mobile money (MTN MoMo, Telecel Cash, AirtelTigo Money) and bank account |
Destination Type | mobile_money or bank |
Mobile Money network | mtn, vodafone (Telecel), airtel (AirtelTigo) |
Bank Codes | From Get Banks for GH, e.g. GH190100 (Stanbic Bank), GH040100 (GCB Bank Ltd) |
Standard Number Format | 10 digits nationally (0XXXXXXXXX); 233XXXXXXXXX internationally |
Prefixes | MTN 024, 025, 054, 055, 059; Telecel 020, 050; AirtelTigo 026, 056 |
SLA (Normal Conditions) | Mobile money instant; bank account 1 to 10 minutes; funding confirmation under 15 minutes |
Wallet Tier Limits | Tier 0 ~GHS 1,000/day · Tier 1 ~GHS 5,000–10,000/day · Tier 2 (business) higher |
Main Risks | Wrong network for the number, wallet tier limits, inactive or unregistered wallets, unverified bank account details |
Validation Endpoints | Account Lookup for name resolution (MTN mobile money), Get Banks for bank and provider codes, Get Limits for corridor min/max |
Related endpoints: Account Lookup, Get Banks, Get Limits.
Closing Note
For mobile money, sending the right network for the number is a critical first step in ensuring fast, successful, and user-trusted payouts in Ghana. For bank payouts, the equivalent is confirming the bank code and account details with your user, since they can't be looked up.
Paying out with the wrong network or a wrong number can lead to:
Delayed refunds,
Auto-reversals,
User frustration,
Increased operational costs.
Well-built payout products in Ghana embed prefix-based validation directly into user onboarding and payout flows.