Пишем "страницу поддержки" с Бесплатной оплатой Биткоинами

apirone.com

Слово "пожертвование" не всегда вызывает положительные эмоции, ведь оно происходит от слова "жертвовать" или “пожертвовать” чем либо.

Выражение "поддержать", "помочь" или "стать частью" гораздо благозвучнее и приятнее. Особенно если в ответ плательщик получает рекламную ссылку или рекламное упоминание о себе.
Яркий пример, это Patreon на сайте https://coin.dance/. Но было бы интереснее продавать не одинаковые размеры логотипов, а всю рекламную площадь, в зависимости от суммы оплаты. Скажем квадрат 1х1 стоит 10.000 Сатоши. Кому то хватит реферального пикселя для поисковика, а кто то захочет большой анимированный логотип.

Итак, приступаем.

В своих проектах, вы можете не только принимать, но и полностью управлять кошельком, создавать выплаты по API запросу.
Тариф простой:
Все входящие транзакции абсолютно БЕСПЛАТНЫ!
Фиксированная комиссия 0.0002 BTC ($0.8) за исходящую транзакцию на сумму более 0.001 BTC.
Микро-выплаты менее 100.000 Сатоши также бесплатны. Все входящие транзакции обрабатываются Бесплатно, а значит это идеально подходит для сбора платежей.

Для начала создаем Накопительный (saving) кошелек, отправляем JSON запрос на эндпоинт https://apirone.com/api/v2/btc/wallet

В ответ получаем
{ "wallet": "8133edaa7e1c8040963159b2ef8b2d30", "type": "saving", "transfer_key": "sfZ4MmnfhXNb1RiLh7jqnFW2eZmdsYt9", "currency": "btc" }

wallet - это кошелек, на который мы будем собирать платежи и им управлять.
transfer_key - ключ, с помощью которого делаем выплаты по API

Пример PHP кода:

<?php
  $json_data = array ( 'type' => "saving" );
  
  $api_endpoint = "https://apirone.com/api/v2/btc/wallet";
 
  $curl = curl_init($api_endpoint);
  curl_setopt($curl, CURLOPT_HTTPHEADER, array("Content-Type: application/json"));
  curl_setopt($curl, CURLOPT_POST, 1);
  curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode($json_data));
  curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
  $response = curl_exec($curl);
  $http_status_code = curl_getinfo($curl, CURLINFO_HTTP_CODE);
  curl_close($curl);

  if ($http_status_code==200){
  $decoded = json_decode($response, true);
  echo "Wallet: " . $decoded["wallet"] . "<BR>";
  echo "Key: " . $decoded["transfer_key"];
  } else {
      var_dump($response);
  }
?>

База данных будет максимально проста и оптимизирована. В единственную таблицу мы будем записывать только оплаченные URL, ссылку на логотип и сумму с количеством подтверждений сети.

CREATE TABLE `supporters` (
  `id` int(11) NOT NULL,
  `address` varchar(34) NOT NULL,
  `logo` varchar(250) NOT NULL,
  `link` varchar(250) NOT NULL,
  `amount` int(11) NOT NULL,
  `confirmations` tinyint(4) NOT NULL,
  `ts` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE 		CURRENT_TIMESTAMP
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

-- Индексы таблицы `supporters`
ALTER TABLE `supporters`  ADD PRIMARY KEY (`id`);

-- AUTO_INCREMENT для таблицы `supporters`
ALTER TABLE `supporters`  MODIFY `id` int(11) NOT NULL AUTO_INCREMENT;
COMMIT;

alt text
На странице оплаты нам потребуется форма с двумя текстовыми полями URL, link to logo. По нажатию на кнопку сабмит, оба этих поля и ссылку для получения колбэка, отправляем в JSON запросе на API эндпоинт.

https://apirone.com/api/v2/btc/wallet/<WalletID>/address

<WalletID> - это тот идентификатор кошелька который мы получили в первом запросе.
'secret' - какой то секретный код, для защиты нашего приложения. Мы будем его сверять на странице колбэка.

<?php
  $json_data = array (
    "callback" => array(
        'url'=> 'http://example.com/callback',
       'data' => array (
        'secret' => "abrakadabra",
        'url' => "https://bits.media/",
        'logo' => "https://bits.media/local/templates/bits.media/images/bits3.png"
        )
    )
  );

  $wallet = "8133edaa7e1c8040963159b2ef8b2d30";
  $api_base = "https://apirone.com/api/v2/btc/wallet/". $wallet ."/address";

 $curl = curl_init($api_base);
  curl_setopt($curl, CURLOPT_HTTPHEADER, array("Content-Type: application/json"));
  curl_setopt($curl, CURLOPT_POST, 1);
  curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode($json_data));
  curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
  $http_status_code = curl_getinfo($curl, CURLINFO_HTTP_CODE);
  $response = curl_exec($curl);
  curl_close($curl);

	  $decoded = json_decode($response, true);
	  echo "Please send the payment to the following bitcoin address: " .
	  $decoded["address"];
	?>

В ответ на запрос, получаем новый биткоин адрес для оплаты. Все сгенерированные адреса будут постоянно мониториться нашим сервисом, ведь клиент может оплатить сейчас, а может сделать это чуть позже.

Для удобства оплаты выводим QR код, с помощью АПИ:
https://apirone.com/ru/docs/get-qr-code

Обработка колбэка. Callback.php

alt text
Страница колбэка нужна для обработки данных от платежного сервиса. Apirone передает адрес на который поступил платеж, сумму, транзакцию, количество подтверждений и данные которые предоставленные пользователем: secret, url, logo. Данные передаются POST запросом в формате JSON, так удобнее и безопаснее.

<?php
$secret = "abrakadabra";

//receive JSON data
$data = file_get_contents('php://input');

if ($data) {
    $params = json_decode($data, true);

// проверяем наш секретный код
if ($params["data"]["secret"] !== $secret) die();

$url = $params["data"]["url"];
$logo = $params["data"]["logo"];
$input_address = $params["input_address"];
$value_in_satoshi = $params["value"];

//Save unconfirmed transaction and data to your Database.
if ($params["confirmations"] == 0) {

	// записываем URL и LOGO в базу данных
	
}

if ($params["confirmations"] >= 3) {
	
	// обновляем количество конфирмов в базе данных
	// по завершению сделки, сообщаем серверу *ok*
	
	echo "*ok*";
	}
}
?>

Оплату за донаты от доверительных плательщиков, можно принимать по нулевому подтверждению Биткоин сети. Но если вы продаете что то дорогое и значимое, мы рекомендуем завершать сделку по 2-3 подтверждениям сети.
После завершения оплаты, в ответ серверу сообщаем ok. После этого колбэки по оплате прекращаются.

Завершение оплаты и размещение логотипа

alt text
Чтобы показать клиенту о проведенной оплате, мы должны её периодически проверять. Мы будем проверять её в созданной таблице. Ведь как только платежный сервер сделает колбэк, у нас сохраняется сгенерированный адрес и ссылки в БД. С помощью Ajax JQuery запроса с периодичностью в 3 секунды, проверяем оплату в БД по идентификатору - сгенерированному биткоин адресу. Как альтернатива, можно проверять транзакцию напрямую в блокчейне, например через blockchain.info или любой другой открытый API или открытая подписка по сокету.
Именно поэтому все входящие платежи должны быть бесплатными, а не брать за это процент. Транзакции всегда можно проверить в блокчейне.

Как только мы нашли транзакцию, пишем плательщику что оплата прошла успешно и перезагружаем страницу. Теперь его логотип со ссылкой будет на сайте. Размер логотипа = сумма оплаты / 10000 Сатоши.

Отладка

Чтобы проверить работу колбэка без оплаты, достаточно его эмулировать cURL запросом:

 curl -X POST -H "Content-type: application/json" -d '{
  "data":
  {"url": "https://bits.media/", "logo": 	"https://bits.media/local/templates/bits.media/images/bits3.png", "secret": "abrakadabra"},
  "input_address": "1E2VSRsaW3Kb1gDkdRUGDo6knAKfi9iYsb",
  "confirmations": 0,
  "input_transaction_hash": 	"4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b",
  "value" : 100000000
}' -i http://example.com/callback.php

http://example.com - замените на свой ресурс.

Так мы отправляем запрос с "data" - данными пользователя и информацию о транзакции в формате JSON.
Вы можете поменять секретный код, ссылки, количество подтверждений, сумму и увидеть, что на это отвечает страница callback.php.

Заключение

Предложенный код, вы можете использовать и модифицировать как угодно. Например выставлять логотипы одного размера, а сумма оплаты это время размещения в минутах. Или сумма это занимаемая площадь, а может даже клетка на шахматной доске или приоритет в списке. Как вам будет угодно.

GitHub: https://github.com/Apirone/supporter
Документация по разворачиванию проекта: https://apirone.com/ru/integrations/become-a-supporter
Рабочий пример: https://allprivatekeys.com/become-a-supporter.php
Документация: https://apirone.com/ru/docs/wallet