When our system detects a payment, our server will notify your specified callback URL with information about the transaction. You'll have to create a payment processing page to handle the callbacks and finalize your customers' orders.
Our service starts doing callbacks from
0 (a new unconfirmed transaction in bitcoin network) up to
6 confirmations. Totally, you can get
7 callbacks per one transaction.
1 confirmation we will forward your bitcoins to the destination address, and then there will be added a transaction hash and a destination address to callback parameters.
In order to confirm a successful processing of the callback, your server should respond in plain text format:
When we get *ok* we will stop doing callbacks for this transaction.
In case your server doesn’t respond or responds incorrectly, our callback server will make new attempts for every new block within 3 days.
The difference between Callback V1 and V2 is in the type of HTTP method requests (GET / POST) and the construction of parameters in JSON. If you use V2 processing, use V2 callback handlers!
In this version, callbacks will always be sent to specified URL as POST-requests containing the details of the payment and the forwarded transaction.
Please add our domain and source IP to the white list in Cloudflare CDN dashboard.
Otherwise, we can not guaranty properly callback to your host.
HTTP and HTTPS protocol schemas in URL are required. Also, we support callback to network.
The following table lists all POST parameters that will be sent in the request to your server:
|Parameter||Present||Experiment with a value|
integer, range 1-10^16
string, 32 chars
integer, range 0-1000
string, 64 chars
|Reset Values||Try callback|
The following block shows an example of the callback request URL:
Don't finish order with 0 confirmation! Because sender can create a new transaction with more fee to another receiver and network may confirm it. Then payment will never arrive. Just update your order and wait for confirmation.
Finish order or top-up user's account balance within 1-6 confirmations, recommended 3. And you will be sure that each payment arrives to you. Second PHP example demonstrates it.