Sandbox environment

Cryptonly provides a sandbox environment for testing merchant flows before going live.

The sandbox is available at:

Merchant panel: https://sandbox-merchant.cryptonly.net Merchant api: https://sandbox-api-merchant.cryptonly.net

Use this environment to test invoices, hosted checkout pages, deposits, withdrawals, API integrations, and webhook handling without using real mainnet funds.

---

Important: Sandbox uses testnets only

The sandbox environment does not use mainnet networks.

Do not send real funds to sandbox payment addresses. Sandbox payments should only be made with testnet assets.

Supported sandbox networks:

Network	Sandbox network
Ethereum	ETH Sepolia
BNB Smart Chain	BSC Testnet
TRON	Tron Shasta
Bitcoin	BTC Testnet

---

What the sandbox is used for

The sandbox environment is designed for testing the full payment flow:

• creating invoices
• opening hosted payment pages
• sending testnet crypto payments
• checking payment statuses
• testing confirmations
• testing merchant balances
• testing withdrawals
• validating API integration
• validating webhook events

This allows merchants and developers to verify their integration before switching to the production environment.

---

Testnet assets

To complete test payments, use testnet assets from the supported networks.

You may need testnet funds for:

• ETH Sepolia
• BSC Testnet
• Tron Shasta
• BTC Testnet

Testnet assets have no real monetary value and are used only for development and QA purposes.

---

Sandbox vs production

Environment	Purpose	Networks	Funds
Sandbox	Testing and integration	Testnets only	Testnet funds
Production	Real merchant payments	Mainnets	Real funds

Use sandbox while building and testing. Use production only when your integration is ready for real payments.

---

Recommended testing flow

1. Log in to the sandbox merchant dashboard.
2. Create a test invoice or hosted checkout payment.
3. Select one of the supported testnet networks.
4. Send testnet funds to the generated payment address.
5. Wait for the payment status to update.
6. Verify the payment in the dashboard.
7. Confirm that your webhook endpoint receives the expected events.
8. Test balance and withdrawal behavior where applicable.

For more ways to verify status transitions and webhook delivery without a real payment, see Testing your integration.

---

Safety note

Never send mainnet assets to sandbox addresses.

Sandbox addresses are intended for testnet transactions only. Mainnet funds sent by mistake may not be recoverable.