# Busha Developer Documentation ## Docs - [Create currency balance](https://docs.busha.io/api-reference/balances/create-currency-balance.md): Creates a new balance for managing funds in a specific currency. - [Get balance details](https://docs.busha.io/api-reference/balances/get-balance-details.md) - [List all balances](https://docs.busha.io/api-reference/balances/list-all-balances.md): Retrieves all account balances with their current status. - [Get a purchase quote](https://docs.busha.io/api-reference/bill/get-a-purchase-quote.md): Returns a real-time cost breakdown before purchase. Shows bill amount, source amount, exchange rate (if cross-currency), fees, and total. Stateless — no DB record, no rate locking. - [Get order details](https://docs.busha.io/api-reference/bill/get-order-details.md): Returns a single bill order by ID, scoped to the authenticated customer. - [List customer orders](https://docs.busha.io/api-reference/bill/list-customer-orders.md): Returns bill orders for the authenticated customer, newest first. - [Purchase a bill](https://docs.busha.io/api-reference/bill/purchase-a-bill.md): Create a bill payment order. Holds funds from the customer's balance and initiates the purchase with the provider. - [Retrieve details of a specific currency](https://docs.busha.io/api-reference/currencies/retrieve-details-of-a-specific-currency.md): Fetches detailed information about a specific currency using its unique code. This includes details such as network support, decimal precision, and transaction limits. - [Retrieve supported currencies](https://docs.busha.io/api-reference/currencies/retrieve-supported-currencies.md): Retrieves a list of all supported currencies along with their basic details. This endpoint can be used to display available currencies in wallets or APIs requiring currency data. - [Create a new customer](https://docs.busha.io/api-reference/customers/create-a-new-customer.md): Creates a new customer entry in the system. The required fields depend on the `type` of customer being created ('individual' or 'business'). - [Delete a customer](https://docs.busha.io/api-reference/customers/delete-a-customer.md): Delete a customer by their unique ID - [Export Customers](https://docs.busha.io/api-reference/customers/export-customers.md): Export customers to a csv file - [Get a customer by ID](https://docs.busha.io/api-reference/customers/get-a-customer-by-id.md): Retrieve a specific customer by their unique ID - [List Business Industries](https://docs.busha.io/api-reference/customers/list-business-industries.md): List all business industries - [List Customers](https://docs.busha.io/api-reference/customers/list-customers.md): List all customers in created for the business - [Share customer token](https://docs.busha.io/api-reference/customers/share-customer-token.md): Token sharing. - [Update a customer](https://docs.busha.io/api-reference/customers/update-a-customer.md): Update the details of an existing customer - [Verify a customer](https://docs.busha.io/api-reference/customers/verify-a-customer.md): Verify the identity and information provided by a customer - [Generate presigned upload URL](https://docs.busha.io/api-reference/files/generate-presigned-upload-url.md): Generates a presigned URL for uploading files directly to storage - [Introduction](https://docs.busha.io/api-reference/introduction.md): Introductory essay for integrating with Busha - [Get deposit address](https://docs.busha.io/api-reference/miscellaneous/get-deposit-address.md): Get an address for a currency - [Get virtual bank account](https://docs.busha.io/api-reference/miscellaneous/get-virtual-bank-account.md): Get a virtual bank account for a currency - [Get virtual bank account terms](https://docs.busha.io/api-reference/miscellaneous/get-virtual-bank-account-terms.md): Get the terms and conditions for a virtual bank account by currency code - [List banks resource](https://docs.busha.io/api-reference/miscellaneous/list-banks-resource.md): Returns a list of all banks and their bank codes - [Look up users addresses](https://docs.busha.io/api-reference/miscellaneous/look-up-users-addresses.md): Returns a user's addresses based on currency and network - [Regenerate deposit address](https://docs.busha.io/api-reference/miscellaneous/regenerate-deposit-address.md): Regenerate an address for a network - [Returns a list of countries](https://docs.busha.io/api-reference/miscellaneous/returns-a-list-of-countries.md): Returns a list of countries and their supported payment channels - [Validate payment destination](https://docs.busha.io/api-reference/miscellaneous/validate-payment-destination.md): validates a payment destination is valid - [List trading pairs](https://docs.busha.io/api-reference/pairs/list-trading-pairs.md): Retrieves all available trading pairs with their current rates. - [Activate a draft invoice](https://docs.busha.io/api-reference/paymentlinks/activate-a-draft-invoice.md): Transitions an invoice from draft status to active and sends email notification to customer - [Create a payment link](https://docs.busha.io/api-reference/paymentlinks/create-a-payment-link.md): Create a payment link - [Create a payment request for payment link](https://docs.busha.io/api-reference/paymentlinks/create-a-payment-request-for-payment-link.md): Create a payment request for payment link - [Delete a payment link](https://docs.busha.io/api-reference/paymentlinks/delete-a-payment-link.md): Delete a payment link - [List payment links](https://docs.busha.io/api-reference/paymentlinks/list-payment-links.md): List payment links - [List payment requests for payment link](https://docs.busha.io/api-reference/paymentlinks/list-payment-requests-for-payment-link.md): List payment requests for payment link - [Retrieve a payment link](https://docs.busha.io/api-reference/paymentlinks/retrieve-a-payment-link.md): Retrieve a payment link - [Update a payment link](https://docs.busha.io/api-reference/paymentlinks/update-a-payment-link.md): Update a payment link - [Create a payment request](https://docs.busha.io/api-reference/paymentrequests/create-a-payment-request.md): Create a payment request - [Finalize a payment request](https://docs.busha.io/api-reference/paymentrequests/finalize-a-payment-request.md): Finalize a payment request - [List payment requests](https://docs.busha.io/api-reference/paymentrequests/list-payment-requests.md): List payment requests - [Retrieve a payment request](https://docs.busha.io/api-reference/paymentrequests/retrieve-a-payment-request.md): Retrieve a payment request - [Create a new Quote](https://docs.busha.io/api-reference/quotes/create-a-new-quote.md): Create Quote - [Create Unauthenticated Quotes](https://docs.busha.io/api-reference/quotes/create-unauthenticated-quotes.md): Create Unauthenticated Quote - [Get Quote](https://docs.busha.io/api-reference/quotes/get-quote.md): Returns a single quote by it's unique ID - [List Payment Options](https://docs.busha.io/api-reference/quotes/list-payment-options.md): List Fiat Payment Options - [List Quotes](https://docs.busha.io/api-reference/quotes/list-quotes.md): List Quotes - [Create a recipient](https://docs.busha.io/api-reference/recipients/create-a-recipient.md): Create a new recipient for transfers. - [Delete a recipient](https://docs.busha.io/api-reference/recipients/delete-a-recipient.md): Delete a specific recipient - [List recipients](https://docs.busha.io/api-reference/recipients/list-recipients.md): Retrieve a list of all recipients - [Resolves a bank account](https://docs.busha.io/api-reference/recipients/resolves-a-bank-account.md): Resolves a bank account for bank transfers - [Retrieve a recipient](https://docs.busha.io/api-reference/recipients/retrieve-a-recipient.md): Get details of a specific recipient - [Get transaction](https://docs.busha.io/api-reference/transactions/get-transaction.md): Retrieves a transactions - [List transactions](https://docs.busha.io/api-reference/transactions/list-transactions.md): Returns a list of transactions - [Create transfer](https://docs.busha.io/api-reference/transfers/create-transfer.md): Create a transfer object - [Get transfer](https://docs.busha.io/api-reference/transfers/get-transfer.md): Retrieves a transfer - [List transfers](https://docs.busha.io/api-reference/transfers/list-transfers.md): Gets all transfers - [Changelog](https://docs.busha.io/changelog/index.md): Review historical changes and latest updates to the Busha Developer Documentation. - [USD Conversions](https://docs.busha.io/examples/buy-usd.md): Buy and sell USD with fiat or cryptocurrency using Busha's API. - [Sell Crypto for Fiat](https://docs.busha.io/examples/crypto-to-fiat.md): Sell cryptocurrency for fiat currency using Busha's API. - [Customer Deposits](https://docs.busha.io/examples/customer-deposits.md): Accept fiat and crypto deposits using temporary bank accounts and addresses. - [Customer Payouts](https://docs.busha.io/examples/customer-payouts.md): Process crypto-to-fiat payouts to bank accounts and mobile money. - [Buy Crypto with Fiat](https://docs.busha.io/examples/fiat-to-crypto.md): Buy cryptocurrency with fiat currency using Busha's API. - [Introduction to Examples](https://docs.busha.io/examples/introduction.md): Explore practical code examples and integration patterns for common Busha use cases. - [Off-Ramp Integration](https://docs.busha.io/examples/off-ramp-integration.md): Integrate the Off-Ramp widget to let users sell crypto on your application. - [On-Ramp Integration](https://docs.busha.io/examples/on-ramp-integration.md): Integrate the On-Ramp widget to let users buy crypto on your application. - [Payment Links](https://docs.busha.io/examples/payment-links.md): Create payment links to accept crypto payments from customers. - [Processing Markups](https://docs.busha.io/examples/processing-markups.md): Add custom markup fees to transactions and generate revenue. - [Accept Stablecoin with Payment Links](https://docs.busha.io/guides/accepting-stablecoin-payments/payment-links.md): Create a Busha-hosted checkout link and share it anywhere your customers buy from you - [Accept Stablecoin with SDK Integration](https://docs.busha.io/guides/accepting-stablecoin-payments/payment-widget.md): Add Busha checkout to your website and start receiving stablecoin payments faster - [Convert Between Balances](https://docs.busha.io/guides/balance/convert-balance-to-balance.md): Convert funds between currencies in your Busha account. Swap NGN to USDT, BTC to KES, and more. - [Manage Balance Accounts](https://docs.busha.io/guides/balance/manage-balance-accounts.md): View and manage multi-currency balances. Check NGN, KES, USDT, BTC, and other currency balances. - [Create a Business Customer](https://docs.busha.io/guides/customers/create-business.md): Set up business customer accounts. Manage company profiles and business verification. - [Create an Individual Customer](https://docs.busha.io/guides/customers/create-individual.md): Create customer profiles for individual users. Handle KYC and identity verification. - [Retrieve Customers](https://docs.busha.io/guides/customers/retrieve-customers.md): Fetch customer profiles and details. Access KYC status, balances, and transaction history. - [Initiate Transactions on Behalf of Customers](https://docs.busha.io/guides/customers/transactions-on-behalf.md): Process deposits, payouts, and conversions for your customers. - [Verify Customer Identity](https://docs.busha.io/guides/customers/verify-identity.md): Implement KYC verification for customers. Collect documents and verify identity information. - [Process Crypto Deposits](https://docs.busha.io/guides/deposits/process-crypto-deposits.md): Generate deposit addresses for cryptocurrency. Accept BTC, USDT, ETH, and more. - [Process Fiat Deposits](https://docs.busha.io/guides/deposits/process-fiat-deposits.md): Accept NGN and KES deposits using temporary bank accounts. - [Process Deposits with Quote Currency](https://docs.busha.io/guides/deposits/process-with-quote-currency.md): Process deposits using quote currency pairs. Convert funds during the deposit flow. - [Generate API Keys](https://docs.busha.io/guides/getting-started/generate-api-key.md): Create and manage your Busha API keys. - [Choose Your Integration Path](https://docs.busha.io/guides/getting-started/integration-paths.md): Pick the fastest Busha integration path: Payments API, Payments SDK, On/Off-ramp APIs, or Customer onboarding for B2B2C. - [Making Your First Request](https://docs.busha.io/guides/getting-started/make-first-request.md): Send your first request to the Busha API. - [Quick Start](https://docs.busha.io/guides/getting-started/quick-start.md): Get started with Busha API. Create your account, generate API keys, and make your first request. - [Setting up a Sandbox](https://docs.busha.io/guides/getting-started/setup-sandbox.md): Learn how to set up your sandbox environment for testing Busha integrations safely. - [Create Your First Payment Request](https://docs.busha.io/guides/payment-requests/create-first-payment.md): Generate payment requests for customers. Accept crypto payments with fixed or variable amounts. - [Retrieve Payment Request](https://docs.busha.io/guides/payment-requests/retrieve-payment.md): Fetch payment request details and status. Monitor payment completion and customer information. - [Process Crypto Payouts](https://docs.busha.io/guides/payouts/process-crypto-payouts.md): Send cryptocurrency payouts to blockchain addresses. - [Process Payouts](https://docs.busha.io/guides/payouts/process-payouts.md): Send payouts to bank accounts and mobile money. - [Create Your First Quote](https://docs.busha.io/guides/quotes/create-first-quote.md): Learn how to create quotes in Busha. Lock in exchange rates and fees before executing transactions. - [Retrieve a Quote](https://docs.busha.io/guides/quotes/get-quote.md): Learn how to fetch and verify quote details. Check rates, fees, and expiration times. - [Create and Manage Recipients](https://docs.busha.io/guides/recipients/create-and-manage.md): Set up payout recipients for bank accounts and mobile money. Manage recipient details and verification. - [Addresses, Banks, and Mobile Money](https://docs.busha.io/guides/reference/addresses-banks-mobile.md): Reference for banks, mobile money providers, and crypto addresses in supported countries. - [Currency Pairs](https://docs.busha.io/guides/reference/pairs.md): See available conversions between fiat and cryptocurrency. - [Recipients Reference](https://docs.busha.io/guides/reference/recipients.md): See the Recipient object. - [Supported Payment Channels](https://docs.busha.io/guides/reference/supported-channels.md): View all supported payment methods. Bank transfers, mobile money, and cryptocurrency options. - [Supported Countries](https://docs.busha.io/guides/reference/supported-countries.md): See which countries are supported by Busha Business. - [Supported Currencies](https://docs.busha.io/guides/reference/supported-currencies.md): Complete list of supported fiat and cryptocurrencies. NGN, KES, USDT, BTC, ETH, and more. - [Supported Industries](https://docs.busha.io/guides/reference/supported-industries.md): See which business industries can use Busha. - [Supported Transfer Types](https://docs.busha.io/guides/reference/supported-transfers.md): View all available transfer types you can initiate with a quote. - [Test Addresses For Off-Ramp Operations](https://docs.busha.io/guides/reference/test-addresses.md): Testnet assets for testing off-ramp operations in sandbox. - [Transfer Status](https://docs.busha.io/guides/reference/transfer-status.md): Understand all transfer statuses on Busha. - [Request IDs](https://docs.busha.io/guides/request-id/request-id.md): Track and troubleshoot API requests using unique request identifiers. - [Token Sharing](https://docs.busha.io/guides/token-sharing/token-sharing.md): Share verified KYC data between platforms using Sumsub token sharing. - [Set Up Webhooks](https://docs.busha.io/guides/webhooks/setup.md): Configure webhooks to receive real-time notifications. Monitor deposits, payouts, and transaction status. - [Webhook Events](https://docs.busha.io/guides/webhooks/webhook-events.md): Real-time notifications for transfers, deposits, conversions, payouts, payment requests, and customer verification in your Busha integration. - [Integrate Off-Ramp Widget](https://docs.busha.io/guides/widgets/integrate-off-ramp.md): Add the Off-Ramp widget to your app. Enable users to sell crypto and receive fiat payouts. - [Integrate On-Ramp Widget](https://docs.busha.io/guides/widgets/integrate-on-ramp.md): Add the On-Ramp widget to your app. Let users buy crypto with fiat currencies directly. - [Compliance](https://docs.busha.io/overview/compliance.md): Understand Busha's compliance requirements. KYC, AML policies, and regulatory guidelines for your integration. - [Customers](https://docs.busha.io/overview/customers.md): Learn how to create and manage customer profiles in Busha. Handle KYC, balances, and customer transactions. - [Fees](https://docs.busha.io/overview/fees.md): Understand Busha's fee structure. - [Multi-Currency Accounts](https://docs.busha.io/overview/multi-currency-accounts.md): Manage multiple currencies in a single account. Support NGN, KES, USDT, BTC, and more in your application. - [Off-Ramp Widget](https://docs.busha.io/overview/off-ramp-widget.md): Learn how the Off-Ramp widget works. Enable users to sell crypto and receive fiat payouts. - [On-Ramp Widget](https://docs.busha.io/overview/on-ramp-widget.md): Understand how the On-Ramp widget works. Let users buy crypto directly in your application. - [Quotes](https://docs.busha.io/overview/quotes.md): Learn how quotes work in Busha. Lock in exchange rates and fees before executing transactions. - [Transactions](https://docs.busha.io/overview/transactions.md): Track and monitor all transaction activity in Busha. View history, statuses, and transaction details. - [Transfers](https://docs.busha.io/overview/transfers.md): Understand how to create and manage transfers in Busha. Execute quotes and move funds between accounts. ## OpenAPI Specs - [openapi-spec](https://raw.githubusercontent.com/bushaHQ/openapi/refs/heads/main/openapi-spec.yaml) - [openapi](https://docs.busha.io/openapi.json) ## Optional - [Guides](https://docs.busha.io/guides) - [Blog](https://blog.busha.io) - [Changelog](https://docs.busha.io/changelog)