Callback addresses are used for commercial use, they incur 1% fee on each transaction received. Callback addresses is a perfect solution to build a white-label payment system into your application.

📘

Forward Address

When using a forwarded address, the blockchain fees required for the transaction to be signed in the blockchain are deducted from the received amount.

Endpoint

https://anonwallet.net/api/v1/callback_address

POST Body Parameters

ParametertypeExampleIs Required?
currencystringBTCNo (default is BTC)
forward_addressstring1BthisisandummybitcoinaddressNo (Used to forward received amount to your specific address after is confirmed in the system)
ipn_urlstringhttps://domain.com/ipn_handlerNo (Used to notify you on incoming payments on callback address)

Your domain must have SSL Certificate
labelstringJohn DoeNo (Used in case of identification in your system)

Code Example

/** * Requires libcurl */ $curl = curl_init(); $payload = array( "currency" => "BTC", "forward_address" => "1Bthisisandummybitcoinaddress", "ipn_url" => "https://domain.com/ipn_handler", "label" => "John Doe" ); curl_setopt_array($curl, [ CURLOPT_HTTPHEADER => [ "Content-Type: application/json", "Authorization: Bearer YOUR_API_KEY_HERE" ], CURLOPT_POSTFIELDS => json_encode($payload), CURLOPT_URL => "https://anonwallet.net/api/v1/callback_address", CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => "POST", ]); $response = curl_exec($curl); $error = curl_error($curl); curl_close($curl); if ($error) { echo "cURL Error #:" . $error; } else { echo $response; }

API Response

{ "status": 200, "message": "OK", "address": "1qs2qsyzh6f64srzenpw4c2xl0twr0lc6h06tsrtzc", "forward_address": "1ad7qsyzh6f64srzenpw4c2xl0twr0lc6h06tsrtzc", "ipn_url": "domain.com/ipn_handler", "label": "John Doe" }