Business / Invoice API ▓ LIVE ON MAINNET v2.4 · 22 coins · 8 networks

Crypto
invoices.
One POST

A hosted payment page. A signed webhook. A verifiable receipt. No KYC, no custody, no monthly retainer — 0.4% flat on settled volume.

Start building → Read the docs

No KYC · No custodian · No small print

§ Part I / IV · Mechanism

From POST to PAID, automatic.

Between confirmation & webhook
Fires within seconds

#StepBehaviourState

01CreateMerchant POSTs invoice body. OrbChain mints a per-invoice address on the merchant's own BIP-44 path.PENDING

02WatchChain monitor ticks every 30 seconds. Confirmations rise; threshold enforced per merchant.CONFIRMING

03CreditAtomic single-flight credit. Deposit row advances. Merchant balance updated. No double-spend window.CLEARED

04NotifyHMAC-SHA512 webhook dispatched with deterministic event_id derived from SHA-256(event_type, entity_id).SIGNED

05ReceiptEd25519 settlement receipt minted at GET /v1/payment/:track_id/receipt. Verifiable offline.SEALED

Settlement Feed · examplePREVIEW

18:47:01✓ PAID · pay_01JR3K9TFR · BTC_LN$142.00

18:46:58✓ PAID · pay_01JR3K8M2P · USDT_TRC20$2,400.00

18:46:47→ webhook delivered · hmac=e5f2… · rt=240msOK

18:46:32✓ PAID · pay_01JR3K7HQ8 · ETH$87.22

18:46:21→ confirmations 3/3 · BTC_LN instantcleared

18:46:10✓ PAID · pay_01JR3K6KX4 · SOL$54.00

18:45:56→ receipt sealed · ed25519=a7c4… · offline-verifiable256-bit

18:45:44✓ PAID · pay_01JR3K5PV9 · USDC_ERC20$980.00

18:45:31→ webhook delivered · hmac=91d7… · rt=180msOK

§ Part II / IV · Capabilities

What ships
with every invoice.

Six named features
All live

SymFeatureMechanismStatus

LNInstant LightningBitcoin over Lightning — atomic, sub-cent fees, zero confirmation wait. On-chain fallback is one parameter.LIVE

ASAuto SettleCustomer pays any accepted coin. Merchant receives the settlement coin configured. Swap runs at checkout.LIVE

SRSigned ReceiptsEd25519-signed receipt per PAID invoice. Verify offline against our published public key.LIVE

DWDeterministic Webhooksevent_id = SHA-256(event_type, entity_id) → Crockford-base32. Retry 1,000×, identical id. Idempotent by construction.LIVE

NKNo-KYC ForeverEmail and password. No documents, no verification wall, no volume gates. Your gateway, your rules, your ledger.LIVE

22Twenty-two coinsBTC · ETH · LTC · TRX · SOL · XMR · TON · XRP plus USDT/USDC across ERC-20, TRC-20, SOL, TON.LIVE

§ Part III / IV · Integration

Three lines of curl.
One webhook handler.

Languages
Node · Python · Go · Rust · PHP

POST /v1/payment/invoicecurl · 200 OK

// $50 invoice — customer pays in BTC-Lightning or USDT-TRC20.
curl https://orbchain.io/v1/payment/invoice \
  -H "merchant_api_key: mk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "amount":           50,
    "currency":         "USD",
    "accepted_coins":   ["BTC_LN", "USDT_TRC20"],
    "order_id":         "order_7f92a1",
    "callback_url":     "https://shop.example/webhooks/orbchain"
  }'

// response
{
  "track_id":   "pay_01JR3K9T…",
  "pay_link":   "https://orbchain.io/pay/pay_01JR3K9T…",
  "expires_at": "2026-04-20T18:45:00Z",
  "event_id":   "01H8KP9M3FRA8YTVKX6ZBN4AX2"
}

§ Part IV / IV · Questions

Things merchants
ask first.

Answered
In full, with links

Q.01How do I verify the webhook is from OrbChain?

Compute HMAC-SHA512 of the raw request body, keyed on your webhook_secret, and compare with the HMAC header in constant time. Full reference implementations for Node, Python, Go, Rust, PHP at /docs#webhooks.

Q.02What happens if the customer underpays?

The invoice stays CONFIRMING until the full amount lands. Partial credits are never applied automatically — reconcile via GET /v1/payment/:track_id and settle with the customer out of band.

Q.03Can I use my own domain for the payment page?

Yes. Post to /v1/payment/white-label instead. OrbChain returns the address and QR payload, and you host the surface entirely on your own domain. See White Label.

Q.04What if my webhook endpoint is temporarily down?

Five retries with exponential backoff at 2, 4, 8, 16, and 32 seconds. Every attempt writes to WebhookLog; failed dispatches are replayable from the dashboard after recovery.

Q.05Do you ever custody my funds?

No. Derived addresses sit on a BIP-44 branch that you control. We never hold keys you did not give us. Withdrawals to your cold wallet are an on-demand parameter, not a ticketed request.

Start accepting
crypto in 60 seconds.

Email and password. No KYC, no monthly retainer — 0.4% flat on settled volume. The entire tariff.

Create account → Read the spec

Crypto invoices. One POST

From POST to PAID, automatic.

What shipswith every invoice.

Three lines of curl.One webhook handler.

Things merchantsask first.

Start acceptingcrypto in 60 seconds.

Crypto
invoices.
One POST

What ships
with every invoice.

Three lines of curl.
One webhook handler.

Things merchants
ask first.

Start accepting
crypto in 60 seconds.