Breet API enquiries

Learn how to integrate and use the Breet API.

By Breet •

15 articles

How can I fund my business wallet?

Keeping your business account funded ensures you have sufficient balance to process payouts and support on-ramp transactions without interruption. You can fund your business account using a Naira bank transfer or supported cryptocurrency deposits, depending on the balance you want to fund. How to Fund Your Business Account 1. From your dashboard, click Fund Wallet. 2. Select the balance you want to fund (USD or Naira/Cedis). 3. Choose your preferred funding method and complete the deposit. Funding Your USD Balance You can fund your USD balance by depositing any supported cryptocurrency. Please note: If your default settlement wallet is set to Naira, you'll be prompted to switch it to USD before proceeding. Funding Your Naira Balance You can fund your Naira balance using either of the following methods: - Cryptocurrency Deposit – Deposit any supported cryptocurrency. - Naira Bank Transfer – Transfer funds to your Virtual Bank Account (VBA). Your Naira balance will be credited once the transfer is successful. Funding Your Cedis Balance - Cryptocurrency Deposit – Deposit any supported cryptocurrency. - “Cedis Bank Transfer” Please note: This switch changes your default settlement wallet for all new crypto deposits, including your customers’ deposits. When you’re done, switch it back if you want customer deposits to settle the way they did before. If your business is yet to create a Virtual Bank Account, you'll be prompted to create one before funding your Naira balance. See: How to create and fund your business virtual bank account for steps on setting up your VBA. Please Note: T

Last updated on Nov 06, 2026

How can I withdraw funds to my business bank account?

Withdraw funds from your NGN or GHS wallet directly to your registered business bank account. This allows your business to settle funds and access them in local bank accounts whenever needed. How to withdraw funds 1. Click Withdraw from your dashboard. 2. Select NGN/GHS Wallet Balance as the source of funds. 3. Enter the amount you want to withdraw. 4. Select the bank account you want to receive the funds. 5. Add a narration, then click Continue. 6. Review the transaction details and click Withdraw Funds. 7. Enter your transaction PIN and click Continue to complete the withdrawal. Please note - The minimum withdrawal amount is ₦2,000 for Nigerian businesses and GHS 50 for Ghanaian businesses. - A ₦50 fee applies to Naira withdrawals. There is no fee for Cedis withdrawals. Each withdrawal can be up to ₦500,000,000 or GHS 2,000,000. - If you haven't added a bank account yet, you'll be prompted to do so before completing the withdrawal.

Last updated on Nov 06, 2026

How can my business check crypto-to-cash rates?

The Rate Calculator gives your business an estimate of the payout rate before you process a transaction. Use it to plan payouts, understand settlement amounts, and price your customers ahead of time. To access it, tap the Rate Calculator icon at the top right corner of your dashboard. Enter the USD value or crypto amount you want to calculate. The calculator will show the estimated payout in NGN, GHS, or USD based on current market rates. Please Note: The final payout may be slightly higher or lower depending on the market rate at the time the transaction is confirmed. A 0.5% fee is applied when the trade is completed. This fee is already factored into the estimated payout shown.

Last updated on Aug 09, 2026

How do currency conversions work?

Move funds between your NGN, GHS, and USD wallets to manage liquidity, fund different transaction flows, and settle payments in the currency your business needs. How to convert 1. Click Convert from your dashboard. 2. Enter the amount you want to convert. 3. Select the destination wallet. - Nigerian businesses: GHS or USD - Ghanaian businesses: NGN or USD 4. Click Continue. 5. Review the conversion details and click Convert to confirm. 6. When you convert between Naira and Cedis, enter your transaction PIN to complete the conversion. Please note: 1. Breet doesn’t charge a fee for conversions. 2. The minimum amount for each conversion: - Naira to USD: ₦7,000 - Cedis to USD: GH₵55 - USD to Naira or Cedis: $5 - Naira to Cedis: ₦1,000 - Cedis to Naira: GH₵150 Please Note: The rate for buying USD is different from the rate for selling USD, so check the amount you’ll receive before you confirm.

Last updated on Nov 06, 2026

How do I set my default settlement wallet?

Your default settlement wallet determines where incoming crypto deposits are credited after conversion. It is determined by the country you selected when you registered your business account. Nigerian businesses default to the NGN wallet, while Ghanaian businesses default to the GHS wallet. Wallet options Local Wallet (NGN or GHS) This is the default setting. All deposits are converted and credited to your local wallet. Best for businesses that primarily settle in Naira or Cedis, or need funds readily available for local withdrawals. USD Wallet Deposits are converted to USD and credited to your USD wallet. Useful if your business wants to reduce local currency exposure, hold value in USD, or fund stablecoin-related flows. How to change your default wallet Go to Settings > Crypto Settings, select your preferred wallet, and save your changes. Please Note: Changing your default wallet only affects new deposits. Deposits already received or in progress will follow the wallet setting that was active at the time they were made.

Last updated on Aug 08, 2026

How does crypto funding work?

This guide explains how your business can use its dedicated wallet addresses to receive crypto directly from business partners or other external senders. This is separate from the wallet addresses generated for your customers through the API. If you want to process transactions programmatically via the API, refer to the API transaction flow on docs.breet.io. Step-by-step guide 1. Log in to your dashboard and click Fund Wallet. 2. Select the wallet you want to fund (NGN/GHS or USD). 3. Choose Crypto as your funding method. 4. Select the cryptocurrency you want to receive. 5. Copy the wallet address or scan the QR code and share it with the sender. Supported cryptocurrencies - Bitcoin (BTC) - Litecoin (LTC) - Dogecoin (DOGE) - Ethereum (ETH) - Bitcoin Cash (BCH) - USDT (TRON, Ethereum, Solana, TON, BSC & Polygon) - USDC (Ethereum, Polygon, Base, BSC, Arbitrum & Solana) - TRON (TRX) - Binance Coin (BNB) - Avalanche (AVAX) - Solana (SOL) - XRP - TON How it works - Each cryptocurrency is assigned a permanent wallet address for your business. - You can reuse these wallet addresses whenever you want to receive crypto. - Once crypto is received, Breet automatically converts it to NGN, GHS, or USD based on your selected settlement wallet. - The converted value is credited to your business balance after the required blockchain confirmations. Please note - A 0.5% transaction fee applies to received transactions. - You can enable automatic settlement if you want funds to be paid directly into your bank account after conversion. - Your business can also hold proceeds in USD and later convert them to local currency or withdraw them as USDT or USDC.

Last updated on Nov 06, 2026

How to create and fund your business virtual bank account

A Virtual Bank Account (VBA) gives your business a dedicated account number for funding your Naira wallet via local bank transfers. Once created, you can reuse the same account details for future top-ups. How to create your Business Virtual Bank Account 1. Log in to your dashboard and click Fund Wallet. 2. Select Naira Wallet. 3. Choose Naira Bank Transfer as your funding method. 4. Click Generate Virtual Account. 5. Enter your director's BVN and Date of Birth. This is only required the first time you create your VBA. 6. Your Virtual Bank Account will be created using your registered business name. Funding your Business Naira wallet Transfer funds from a bank account linked to the director's BVN to your Virtual Bank Account. Your Naira wallet will be credited once the transfer is successful. Please note - Your business Virtual Bank Account is unique to your business and can be reused for all future Naira top-ups. - A 1.5% fee applies to Naira top-ups via bank transfer, capped at ₦1,000.

Last updated on Oct 20, 2026

How to send stablecoins from the business dashboard

Send USDT or USDC directly from your business dashboard to pay suppliers, settle business obligations, or make payments to business partners. Breet automatically converts your USD balance into the selected stablecoin before sending it to the recipient wallet. If you want to offer stablecoin purchases to your users programmatically, refer to the API documentation on docs.breet.io. How to Send Stablecoins from Your Business Dashboard 1. Click Withdraw from your dashboard. 2. Select USD Balance as the source of funds. 3. Select the stablecoin and network, then enter the required transaction details and click Continue. 4. Review the transaction details and click Send to confirm. Supported networks Stablecoin Supported networks USDT ERC20, TRC20, BSC, Solana, TON USDC ERC20, TRC20, BSC, Solana, Base Please note - The minimum transaction amount is $5. Each transfer can be up to $250,000. - Network fees apply to all stablecoin transfers and will be displayed before you confirm the transaction. - Crypto transactions are irreversible. Always verify the recipient wallet address and selected network before sending.

Last updated on Nov 06, 2026

Secure your business dashboard with multi-factor authentication (MFA)

Multi-Factor Authentication (MFA) adds an extra layer of security to your business account by requiring an additional verification step before access is granted or sensitive actions are completed. We recommend enabling MFA to help protect your business funds and account settings from unauthorized access. How to enable MFA 1. Log in to your Breet partner dashboard. 2. Go to Settings. 3. Select Security. 4. Click MFA Authentication and choose your preferred verification method. 5. Follow the on-screen instructions to complete the setup. Available MFA methods Authenticator App (Recommended) Generates a time-based verification code using an authenticator app on your mobile device. Before getting started, install an authenticator app such as Google Authenticator or Authy. Email OTP Sends a one-time password to your registered email address whenever verification is required. When you'll be asked to verify After MFA is enabled, verification is required when you: - Log in to your dashboard. - Initiate withdrawals. - Enable, disable, or update automatic settlement settings. - Add a new withdrawal wallet address. - Change your webhook settings. Your selected MFA method will be used for verification. Recovery codes If you use an authenticator app, you'll receive recovery codes during setup. Store them securely, as they can be used to access your account if you lose access to your authenticator device. If you run out of recovery codes, contact our support team to generate a new set. Mandatory MFA To help protect high-volume business accounts, MFA may become mandatory once your account reaches certain activity thresholds. When this happens, MFA cannot be disabled from the dashboard.

Last updated on Nov 06, 2026

What is automatic settlement?

Automatic settlement pays out each successful trade from your Breet business account, so you don’t have to place withdrawals yourself. You can settle in fiat (to a bank account) or in stablecoin (to an external wallet address). Only one can be on at a time. Fiat settlement After each successful trade, the Naira or Cedis is sent to a bank account. Deposits are routed in one of two ways: - Per-address: Deposits to a wallet address that has its own settlement bank account go to that account. You set this up through the API when you generate the address. See: Auto-settlement API documentation - Business-wide: All other deposits go to one bank account. To turn this on, go to “Settings” > “Automatic Settlement” and select your bank account. Fiat settlement only pays out deposits that settle to your Naira or Cedis wallet. Deposits that settle to your USD wallet stay in your USD wallet. Please Note: If a payout is below ₦2,000 (GH₵50 for Cedis), the settlement fails and the funds stay in your wallet. Stablecoin settlement After each successful trade, the funds are sent as either USDT or USDC to your preferred stablecoin wallet address. Stablecoin settlement works when: - Business-wide automatic settlement is on, and - You’ve added a preferred stablecoin wallet address. Each payout has the same network fee as a USD withdrawal: - TRON (TRC20): $4.00 - Ethereum (ERC20): $0.10 - BSC: $0.10 - Solana (SOL): $0.30 - Base: $0.10 (USDC only) To turn off business-wide automatic settlement, you’ll need to enter a verification code from your email or authenticator app.

Last updated on Nov 06, 2026

What is the Breet API Partner Dashboard?

The Breet API Partner Dashboard is built for businesses that integrate Breet's API into their own products. It gives partners a central place to manage transactions, monitor performance, track balances, and control how crypto payments move through their business. To create a partner account, visit partners.breet.io. API documentation is available at docs.breet.io. After you sign up, complete business verification (KYB) from your dashboard. While your business is under review, you can test your integration in Sandbox. Who it's for The Partner Dashboard is for fintechs, payment platforms, startups, virtual card providers, remittance platforms, gaming platforms, and any business that wants to let users pay, deposit, or withdraw using crypto. Key benefits - No blockchain infrastructure to manage. Breet handles wallet infrastructure, transaction monitoring, confirmations, gas fees, and conversion logic so your team doesn't have to. - No wallet address limits. Generate wallet addresses for your users through the API without fixed limits. - Bi-directional crypto flows. Support crypto-to-cash and cash-to-crypto flows within your product. - Flat 0.5% transaction fee. No setup fees or monthly subscription charges. - Dashboard visibility. Track transactions, monitor performance, view balances, and manage activity connected to your integration. - Dedicated partner support. Get support via Slack or WhatsApp during onboarding, testing, and after going live. - Agile feature development. Breet works closely with partners to support relevant feature improvements based on your business flow. FAQs Is the Partner Dashboard for individual traders? No. It is built for businesses integrating Breet's API into their own products. Does Breet limit the number of wallet addresses we can generate? No. There are no fixed wallet address limits for partners. How much does Breet charge? Breet charges a flat 0.5% transaction fee. There are no setup fees or monthly subscription charges. Do partners get support during integration? Yes. Partners get dedicated support via Slack or WhatsApp during onboarding, testing, and after launch. Where can I find the API documentation? API documentation is available at docs.breet.io. For further assistance, email sales@breet.io or call +2348109894764.

Last updated on Nov 06, 2026

What does “We Detected a Wrong Asset Deposit” mean?

This means a coin was sent to one of your Breet addresses before a wallet was opened for that coin. For example, USDT on Ethereum was sent to your Ethereum (ETH) address. If Breet supports the coin, Breet opens the wallet for you and processes the deposit as a normal sale. You’ll get an email titled “Heads up! We detected a wrong asset deposit”. What happens next? The deposit is processed like any other sale, with the same confirmations, checks, minimum amount, and fee. If the amount is below the minimum for that coin, the deposit is held as Flagged and you can resolve it. I sent a coin by mistake, but I didn’t get an email Reach out to the Breet team on your dedicated Slack channel and share the transaction hash. Please Note: Some coins and networks can’t be recovered. Always check the coin and network for the address before you send.

Last updated on Nov 04, 2026

How do I verify my business (KYB)?

Before you can use your Live business account, Breet needs to verify your business. This is called KYB (Know Your Business). Until your business is approved, most pages in Live stay locked, and an onboarding checklist opens when you log in. Before you start, have these documents ready: - Proof of Address - Tax Identification Number - Evidence of Registration or Incorporation - Status Report - Memorandum and Articles of Association To complete KYB: 1. Log in to your dashboard at partners.breet.io as the business owner. 2. Open “Business Verification” from the onboarding checklist. 3. Fill in your business details. 4. Add your directors. 5. Read and accept the acknowledgement. 6. Select “Submit”. You can follow the progress of your review on the status page. Breet will let you know once your business is approved. Please Note: Sandbox stays open while your business is under review, so you can test your integration in the meantime. If you need help, email sales@breet.io.

Last updated on Nov 06, 2026

How do I invite team members to my business dashboard?

You can invite team members to your business dashboard and choose what they can access. Before you start: - Open Sandbox at least once yourself. - Invite and manage team members in Live only. To invite a team member: 1. In Live, go to “Settings”. 2. Select “Team Management”. 3. Follow the steps on screen to invite a team member and choose their access. The team member gets an invite. Once they accept, their role and access are copied to Sandbox as well. You can resend or delete an invite while it’s still pending. Please Note: Only team members with permission to manage the team can open “Team Management”

Last updated on Nov 06, 2026

Which events don’t send a webhook?

Some events don’t currently send a webhook. Check this list before you contact support. Business-wide automatic settlement payouts These payouts don’t send a withdrawal webhook and don’t appear in Withdrawal History. Use your wallet history to match them. Payouts started from the dashboard Payouts you start from the dashboard don’t send withdrawal webhooks. Payouts you start through the API do. Webhook events not subscribed to You only receive webhooks for the events you’ve subscribed to. If you’re not getting a webhook you expect, check which events you’ve selected.

Last updated on Nov 06, 2026