Test your integration in the Bitliva sandbox

The sandbox lets you build and test a full Bitliva integration before you go live. You can create test customers, simulate crypto deposits that credit their balance, and receive the same webhooks you will get in production.

Sandbox limits

You can create up to 5 customers. After that, creating a customer returns customer_limit_reached.
Responses report "mode": "test", so you can confirm which environment you are in with GET /me.

Simulate a crypto deposit

In the sandbox there is no real chain to send funds from. Instead, call POST /sandbox/customers/{id}/deposits to credit a customer’s test balance. The customer must already have an address for that coin and network.

curl -X POST https://merchant.bitliva.com/api/v1/sandbox/customers/$CUSTOMER_ID/deposits \
  -H "Authorization: Bearer $BITLIVA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"currency": "usdt", "network": "trc20", "amount": 25}'

{
  "status": "success",
  "message": "Deposit simulated.",
  "data": {
    "deposit": {
      "id": "5b8f0e2d-1c64-4a0f-8d77-3a9e2c1b6f40",
      "customer_id": "2f6d1c0a-8a3e-4d59-b8a1-71e0c4d5f9a3",
      "currency": "usdt",
      "network": "trc20",
      "amount": "25",
      "address": "sandbox_usdt_9f2c1d...",
      "txid": "4c1e9a07d3b25f8e61a0c9d7b4e2f3a58c1d6e0b9f7a4c2d3e5b8a1f0c6d9e72",
      "explorer_url": "https://tronscan.org/#/transaction/4c1e9a07d3b25f8e61a0c9d7b4e2f3a58c1d6e0b9f7a4c2d3e5b8a1f0c6d9e72",
      "created_at": "2026-10-18T10:20:00+01:00"
    }
  }
}

The call fires a crypto.deposit.received webhook. The txid is random, so its explorer link will not resolve. Outside the sandbox this endpoint returns sandbox_only.

Test your webhook endpoint

Add your endpoint in the dashboard.
Press Send test to deliver a webhook.test event.
Confirm that you verify the signature and answer with a 2xx status.
Simulate a deposit to receive a real crypto.deposit.received event.

Before you go live

Live access needs a verified business. Until your business is verified, or if the account is suspended, live requests return live_not_enabled.

Get started

Guides

Test your integration in the Bitliva sandbox

Sandbox limits

Simulate a crypto deposit

Test your webhook endpoint

Before you go live

​Sandbox limits

​Simulate a crypto deposit

​Test your webhook endpoint

​Before you go live

Sandbox limits

Simulate a crypto deposit

Test your webhook endpoint

Before you go live