# BITLIVA Merchant API

- [Bitliva Merchant API: trade crypto and gift cards](https://docs.bitliva.com/index.md): Create customers, give them crypto addresses, buy and sell crypto, sell gift cards, and read your naira wallet with the Bitliva Merchant REST API.
- [Quickstart: make your first crypto sale in the sandbox](https://docs.bitliva.com/quickstart.md): Create a customer, generate a USDT address, simulate a deposit and sell the crypto for naira in the Bitliva sandbox with curl, step by step.
- [Authenticate requests with your Bitliva API key](https://docs.bitliva.com/authentication.md): Send your Bitliva API key as a bearer token on every request, understand sandbox and live modes, and handle 401 and 403 authentication errors.
- [Errors and response format for the Bitliva Merchant API](https://docs.bitliva.com/errors.md): Every Bitliva response uses one envelope. Learn the error codes, HTTP statuses, validation errors, and how to retry safely with references.
- [Manage customers and crypto wallet addresses](https://docs.bitliva.com/guides/customers-and-wallets.md): Create one customer per user, generate deposit addresses per coin and network, and read balances and customer lists with the Bitliva Merchant API.
- [Buy and sell crypto for your customers](https://docs.bitliva.com/guides/buy-and-sell-crypto.md): Check rates, request quotes, then buy or sell crypto for a customer. Naira moves through your wallet and the crypto belongs to the customer.
- [Sell gift cards on behalf of your customers](https://docs.bitliva.com/guides/gift-cards.md): List sellable gift cards with naira rates, then submit a card for review with pictures or an e-code and track it until it is paid.
- [Read your naira wallet and transaction history](https://docs.bitliva.com/guides/transactions.md): Check your naira balance, list transactions with type and status filters, and understand every field on a Bitliva transaction object.
- [Receive and verify Bitliva webhooks](https://docs.bitliva.com/guides/webhooks.md): Get notified when a transaction finishes or a crypto deposit arrives, and verify the X-Bitliva-Signature header with HMAC-SHA256 before you trust it.
- [Test your integration in the Bitliva sandbox](https://docs.bitliva.com/guides/sandbox.md): Use sandbox mode to create test customers, simulate crypto deposits, and fire webhooks before you go live with the Bitliva Merchant API.
- [Me](https://docs.bitliva.com/api-reference/me.md): Your merchant account details.
- [Wallet balance](https://docs.bitliva.com/api-reference/balance.md): Your naira wallet balance.
- [List transactions](https://docs.bitliva.com/api-reference/transactions-list.md)
- [Get one transaction](https://docs.bitliva.com/api-reference/transactions-get.md): One transaction by id.
- [Create a customer](https://docs.bitliva.com/api-reference/customers-create.md): Creates a customer and their crypto account.
- [List customers](https://docs.bitliva.com/api-reference/customers-list.md)
- [Get a customer](https://docs.bitliva.com/api-reference/customers-get.md): One customer with their wallet addresses.
- [Generate a crypto wallet address](https://docs.bitliva.com/api-reference/wallets-create.md): Creates the address a customer receives a coin on. Repeating the same coin and network returns the existing address.
- [List a customer's addresses](https://docs.bitliva.com/api-reference/wallets-list.md): All of a customer's crypto wallet addresses.
- [A customer's crypto balances](https://docs.bitliva.com/api-reference/customers-balances.md): Current balance per coin.
- [Crypto rates](https://docs.bitliva.com/api-reference/rates-crypto.md): Naira per US dollar for each coin. `buy_rate` is what a customer pays, `sell_rate` is what they receive.
- [Quote a sale](https://docs.bitliva.com/api-reference/quotes-sell.md): Naira you would receive for this much crypto.
- [Quote a purchase](https://docs.bitliva.com/api-reference/quotes-buy.md): Crypto you would get for this much naira.
- [Sell crypto](https://docs.bitliva.com/api-reference/crypto-sell.md)
- [Buy crypto](https://docs.bitliva.com/api-reference/crypto-buy.md)
- [Gift cards you can sell](https://docs.bitliva.com/api-reference/giftcards-list.md): Cards with the naira rate per US dollar. `minimum` is in dollars.
- [Sell a gift card](https://docs.bitliva.com/api-reference/giftcards-sell.md): Submits a gift card for review. Use `multipart/form-data`.
- [Simulate a crypto deposit](https://docs.bitliva.com/api-reference/sandbox-deposit.md): Credits a customer's test balance and fires `crypto.deposit.received`. The `txid` is random, so its explorer link will not resolve.

## OpenAPI Specs

- [openapi](https://merchant.bitliva.com/docs/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.