Wait for a Bitcoin Payment Event

2026-03-15 permalink SUBTC

SUBTC can block and wait until a payment arrives to a specific address.
This is useful for building checkout systems or automated payment confirmation.

Wait for a payment event:

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

Example response:

{
 "ok": true,
 "request_id": "f48a753c2c24debd",
 "result": {
  "address": "tb1qj3xzdyr6fdhzh37w4avm4l5dnm53cmvf6p27rf",
  "coin": "btc",
  "expected_sat": 50000,
  "net": "test",
  "received_sat": 102324,
  "status": "confirmed",
  "wallet_id": "w_cf21a601a3f461a92699e5b5dac80ad6d9d66de4592d"
 }
}

What happened:

The API waited until the address received the expected payment.
The wallet detected 102,324 SAT and the transaction reached confirmed status.

This pattern allows developers to build synchronous payment flows using only curl.

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

Wait for a Bitcoin Payment Event

Related Articles