Bitliva Merchant API: trade crypto and gift cards

The Bitliva Merchant API lets you offer crypto and gift card trading inside your own product. Each of your users becomes a customer with their own deposit addresses and crypto balances, while naira moves through a single wallet that you control.

What you can do

Create customers

Generate wallet addresses

Give a customer a deposit address for each coin and network.

Buy and sell crypto

Quote a price, then buy or sell crypto for a customer in naira.

Sell gift cards

Submit gift cards for review and get paid to your wallet on approval.

Base URL

Every endpoint lives under one base URL:

https://merchant.bitliva.com/api/v1

Response format

Every response has the same shape: status, message, and data when there is something to return. Errors also carry a stable code that you should match on, never on message.

Success

{
  "status": "success",
  "message": "Balance retrieved successfully.",
  "data": {
    "balance": "5000000.00",
    "currency": "NGN",
    "mode": "test"
  }
}

Error

{
  "status": "error",
  "message": "Invalid or missing API key.",
  "code": "invalid_api_key"
}

Where to go next

Quickstart

Make your first crypto sale in the sandbox.

Authentication

Send your API key and understand sandbox and live modes.

Webhooks

Get notified when a transaction finishes or a deposit arrives.

API reference

Every endpoint with parameters, responses and examples.

Get started

Guides

Bitliva Merchant API: trade crypto and gift cards

What you can do

Create customers

Generate wallet addresses

Buy and sell crypto

Sell gift cards

Base URL

Response format

Where to go next

Quickstart

Authentication

Webhooks

API reference

​What you can do

Create customers

Generate wallet addresses

Buy and sell crypto

Sell gift cards

​Base URL

​Response format

​Where to go next

Quickstart

Authentication

Webhooks

API reference

What you can do

Base URL

Response format

Where to go next