Create a Payment Inbox in SUBTC

SUBTC supports payment inboxes — temporary addresses designed to receive a specific amount.
This is useful for building checkout systems or automated payment flows.

Create a payment 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\":50000}"

Example response:

{
"ok": true,
"request_id": "e8fe68e4cc4adad2",
"result": {
"address": "tb1qgg7y5vcqwdtjdjyep82fazrjauyth6tgm4fk47",
"coin": "btc",
"expected_sat": 50000,
"net": "test",
"wallet_id": "w_cf21a601a3f461a92699e5b5dac80ad6d9d66de4592d"
}
}

What happened:

- The protocol generated a new payment address
- The inbox expects **50,000 satoshis**
- Once the payment arrives, the wallet can detect it through balance checks or event waiting

This pattern allows developers to build deterministic payment requests.

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