Create a BTC Mainnet Payment Inbox

2026-03-16 permalink SUBTC

SUBTC supports deterministic payment inboxes for real BTC transactions.
An inbox generates a dedicated address expecting a specific payment amount.

Create an inbox:

curl -sS -X POST "https://api.subtc.net/v1/btc?mode=inbox_create" \
  -H "X-SUBTC-KEY: $KEY" \
  -H "Content-Type: application/json" \
  -d "{\"wallet_id\":\"$WID\",\"expected_sat\":20000}"

Example response:

{
 "ok": true,
 "request_id": "c863a427b2e5112f",
 "result": {
  "address": "bc1qakqvzcpd8vr7k09qcj0255ncmhfk9cmdk2c322",
  "coin": "btc",
  "expected_sat": 20000,
  "net": "main",
  "wallet_id": "w_87d2a561cdd665948c1d756106f7b2179327927c3b8c"
 }
}

What happened:

The gateway created a new Bitcoin address dedicated to this payment request.

Expected payment:
20,000 SAT

When the payment reaches or exceeds the expected amount, the wallet can detect it via polling, wait events, or webhooks.

This pattern is ideal for checkout pages, invoices, and automated payment systems.

API Base:
https://subtc.net/api

Create a BTC Mainnet Payment Inbox

Related Articles