API Reference

Callback Notification

Blockonomics will send http callback for payments on your address. For each callback following parameters are returned:

  • status is the status of transaction. 0-Unconfirmed, 1-Partially Confirmed, 2-Confirmed
  • addr is the receiving address
  • value is the recevied payment amount in satoshis
  • txid is the id of the paying transaction
  • For unconfirmed transactions an rbf attribute may be returned

A callback succeeds when the server returns 200 HTTP status. Callback are retried 7 times with an exponential backoff of 4 seconds. Use Dashboard > Stores to configure callback for your server. Your callback url can also contain a secret parameter for additional security.

Warning about zero confirmations: It is always recommended to wait for at least one confirmation to deliver your product/service. Sometimes you may want to accept zero confirmation for fast delivery of digital goods. In such cases you should reject unconfirmed payments that have rbf attribute. This is because RBF payments can be easily cancelled or reversed