Back to Developer Hub
Sandbox Environment

Test safely before you go live

Sandbox projects create test invoices, skip chain activity, and let you simulate webhook callbacks from the dashboard.

Create a sandbox project

In the API Keys page, toggle the environment to Sandbox. Sandbox keys are isolated from live reporting and do not create sweep tasks.

Replay webhooks

Use the sandbox payment endpoint to simulate invoice.paid events and verify signature handling against your webhook endpoint.

How it works

  1. Create a Sandbox API key from Projects & API Keys.
  2. Use that key in your SDK or curl request to create an invoice.
  3. Open the invoice in the dashboard and trigger a sandbox payment simulation via POST /api/invoice/{id}/sandbox/pay.
  4. Confirm the webhook payload, signature, and dashboard status updates.
SDK Example
Sandbox Key
import { OrvexClient } from "orvex-pay";

const client = new OrvexClient({
  apiKey: "SBX_KEY_HERE"
});

const invoice = await client.invoices.create({
  priceAmount: "25.00",
  priceCurrency: "USD",
  payCurrency: "USDT",
  successUrl: "https://example.com/success",
  cancelUrl: "https://example.com/cancel"
});
Simulate via curl
Post Request
curl -X POST "https://api.orvexpay.com/api/invoice/{invoice_id}/sandbox/pay"   -H "x-api-key: SBX_KEY_HERE"   -H "Content-Type: application/json"   -d '{
    "amountReceived": 25.00,
    "transactionHash": "sbx_test_hash"
  }'

Recommended flow

Build against Sandbox first, verify your signature logic, then swap the key to Live when you're ready.

Read the help guide

Safety checks

  • Sandbox invoices are excluded from live revenue and payout balances.
  • Sandbox payments skip blockchain monitoring and sweep workers.
  • Webhook payloads still use the production signature format.