On/Offramps

On/Offramps allow you to bridge between fiat currency and cryptocurrency. Offramps convert stablecoins (USDC/USDT) into fiat currency for bank or mobile money payouts, while Onramps convert fiat currency into cryptocurrency on supported blockchains.

What Are On/Offramps?

Offramps enable users to convert cryptocurrency holdings into fiat currency. Users send USDC or USDT on supported EVM chains to a generated deposit address, and Honeycoin automatically converts and pays out the equivalent fiat amount to their bank account or mobile money wallet.

Onramps enable users to convert fiat currency into cryptocurrency. Users pay via mobile money or bank transfer, and Honeycoin automatically settles the equivalent cryptocurrency (USDC or USDT) to their specified on-chain wallet address.

Together, these services provide a seamless bridge between traditional finance and decentralized applications.

Supported Cryptocurrencies

Both Onramps and Offramps support the following stablecoins:

Supported Blockchains

Cryptocurrency settlements are available on the following EVM-compatible blockchains:

Offramps Overview

Offramps allow users to exit the crypto ecosystem by converting stablecoins to fiat currency.

Offramp Flow

1.Get supported payout methods - Retrieve bank or mobile money operator codes

2.Initiate offramp transaction - Create an offramp request with recipient details

3.Send crypto to deposit address - User sends USDC/USDT to the generated address

4.Receive fiat payout - Honeycoin automatically initiates the fiat payout once crypto is confirmed

5.Receive confirmation - Webhook notification confirms completion

Offramp Payout Destinations

Offramps support the following fiat payout methods:

Key Offramp Features

• Instant deposit address generation - Each offramp creates a unique deposit address valid for 1 hour
• Exact amount requirement - Users must send the exact crypto amount specified; sending different amounts triggers automatic refunds
• Automatic payout initiation - Fiat payout is automatically initiated once crypto deposit is confirmed on-chain
• Refund handling - Failed payouts automatically refund crypto to the sender's address
• Real-time webhooks - Receive instant notifications when offramps complete

Offramp Limitations

• Deposit addresses are valid for 1 hour
• Only USDC and USDT are supported
• Exact amount must be sent (no partial amounts)
• Refund address is optional (defaults to sender's address if not provided)

Onramps Overview

Onramps allow users to enter the crypto ecosystem by converting fiat currency to stablecoins.

Onramp Flow

1.Initiate onramp transaction - Create an onramp request with user details and destination wallet

2.User makes fiat payment - User pays via mobile money or bank transfer

3.Crypto settlement - Once fiat payment is confirmed, crypto is automatically settled to the user's wallet

4.Receive confirmation - Webhook notification confirms completion

Onramp Payment Methods

Onramps support the following fiat payment methods:

Onramp Implementation Options

Honeycoin offers two ways to implement onramps:

1. Onramp API

The standard API endpoint for programmatic onramp integration. You handle the entire user interface and payment flow.

Use this when:

• You want full control over the user experience
• You're building a custom payment interface
• You need to integrate with your existing payment flow

2. Onramp SDK

A pre-built, embeddable widget that handles the entire onramp user journey. The SDK manages payment input, real-time exchange rate display, payment selection, and status updates.

Use this when:

• You want a quick, turnkey solution
• You want to minimize integration complexity
• You prefer a white-labeled payment interface
• You want automatic handling of payment collection and blockchain settlement

Key Onramp Features

• Multi-currency support - Accept payments in local currencies across supported countries
• Real-time exchange rates - Display current conversion rates to users
• Flexible payment methods - Users can choose their preferred payment method
• Automatic settlement - Crypto is automatically sent to the user's wallet once payment is confirmed
• Email receipts - Optional email receipts for transaction history (recommended)
• Redirect handling - SDK supports success, failure, and cancellation redirects
• Real-time webhooks - Receive instant notifications when onramps complete

Onramp Limitations

• Only USDC and USDT are supported
• Email is optional but highly recommended
• Receiver address must be valid on the specified chain
• External reference must be unique (prevents duplicate transactions)

Supported Countries

On/Offramps are available in multiple African countries. For the most current list of supported countries, payment methods, and transaction limits, refer to the Supported Countries & Limits documentation.

Use Cases

Offramps

• Crypto-to-fiat conversion - Users exit crypto holdings into local currency
• Earnings withdrawal - DApp users withdraw earnings as fiat
• Liquidity provision - Traders convert stablecoins to fiat for cash needs
• Cross-border payments - Send crypto that settles as fiat in recipient's country

Onramps

• DApp funding - Users fund their crypto wallets to use decentralized applications
• Crypto purchases - Users buy stablecoins with fiat currency
• Cross-border remittances - Send fiat that settles as crypto in recipient's wallet
• Investment entry - Users enter crypto markets with fiat currency

Getting Started

For Offramps

1.Review the Offramps Guide - Complete step-by-step implementation guide

2.Check Supported Countries & Limits - Verify supported countries and limits

3.Use Get Banks API - Retrieve supported banks for bank payouts

4.Use Get Mobile Money Operators API - Retrieve supported mobile money operators

5.Review Offramp API Reference - Detailed endpoint documentation

For Onramps

1.Choose implementation - Decide between API or SDK

2.Review the Onramps Guide - Complete step-by-step implementation guide

3.Check Supported Countries & Limits - Verify supported countries and limits

4.For API: Review Onramp API Reference - Detailed endpoint documentation

5.For SDK: Review Onramp SDK Reference - SDK parameters and integration

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

Key Differences: API vs SDK (Onramps)

Exchange Rates and Conversion

Both Onramps and Offramps handle currency conversion automatically at current market rates. For historical rates or FX rate information, use the Get FX Rate API and Get Historical Rates API.

Webhooks and Status Tracking

Both Onramps and Offramps support webhook notifications for real-time transaction updates. Configure your webhook URL in your dashboard to receive notifications when transactions complete.

Best Practices

• Use unique external references to prevent duplicate transactions
• Implement proper error handling for failed transactions
• Use webhooks for real-time status updates rather than polling
• Validate user input before initiating transactions
• Test thoroughly in sandbox before deploying to production
• Include email addresses in onramp requests for transaction receipts
• Monitor transaction success rates to identify potential issues
• Keep detailed records of all transactions for reconciliation