Create a Payment Inbox in SUBTC

SUBTC supports payment inboxes — temporary addresses designed to receive a specific amount.<br>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" \<br>-H "X-SUBTC-KEY: $KEY" \<br>-H "Content-Type: application/json" \<br>-d "{\"wallet_id\":\"$WID\",\"expected_sat\":50000}"

Example response:

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

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:<br>https://subtc.net/api