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
Parameter | type | Example | Is Required? |
---|---|---|---|
currency | string | BTC | No (default is BTC) |
forward_address | string | 1Bthisisandummybitcoinaddress | No (Used to forward received amount to your specific address after is confirmed in the system) |
ipn_url | string | https://domain.com/ipn_handler | No (Used to notify you on incoming payments on callback address) Your domain must have SSL Certificate |
label | string | John Doe | No (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"
}