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"
}