Инструкция: Как добавить оплату биткоинами на сайте

Инструкция: Как добавить оплату биткоинами на сайте

@nasharu

У текущей моды на криптовалюты масса обоснованных плюсов:

  1. Безопасные онлайн-платежи: здесь отсутствует фрод и чарджбеки. Сеть устроена так, что отправленный платеж вернуть нельзя, достоверность транзакции подтверждают пользователи по всему миру, а каждая транзакция шифруется.
  2. Выгодные комиссии: стоимость проведения платежа не превышает 1%. И чем больше сумма перевода — тем меньше потери.
  3. Анонимность: средства клиентов не контролируют банки — никто не вправе блокировать транзакцию или добавить лишнюю комиссию.
  4. Платежи без ограничений: транзакции проводятся в неограниченных объемах, чего не позволяют другие платежные средства.

Существует множество сервисов, позволяющих принимать биткоины и другие валюты. Лишь малая часть из них:

  • Blockchain (ключ для работы с API выдается по заявке).
  • Coinbase (необходимо заполнить заявку и дождаться одобрения).
  • Bitaps (открытое API).
  • Cryptonator.

Мы подключили оплату через API сервиса Bitaps, потому что через него это оказалось сделать проще. Если у Blockchain требуется писать заявку и ждать одобрения три банковских дня, то здесь изначально можно подключиться самостоятельно. В API найдется всё необходимое для этого.

Прием платежей

При формировании счета для клиента надо сгенерировать и мониторить уникальный адрес (временный кошелек) для каждого платежа. Как только платёж подтверждён сетью, сервер API перечисляет биткоины с временного кошелька на указанный кошелек (свой или корпоративный, куда вам удобно будет получать средства).

У каждого сервиса свой API, но выглядит схема примерно одинаково:

  • Сгенерируйте платеж, обратившись по специальной ссылке и передав параметры.
  • Создайте биткоин-адрес продавца, на который будут пересылаться деньги.
  • Создайте ссылку вашей системы (callback), которая будет вызываться при подтверждении платежа.
  • Укажите количество принятых подтверждений платежа в сети Bitcoin (опциональное поле, по умолчанию — 3).
  • Определите уровень комиссии сети (опциональное поле, по умолчанию — low). Чем он выше, тем быстрее произойдет перевод.

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

После зачисления средств по указанному счету происходит подтверждение в сети Bitcoin. На каждое подтверждение отправляется обращение к callback и передаются параметры, чтобы опознать платеж. При получении последнего подтверждения надо выполнить заказ или услугу клиента. Сумма передается в сатоши — самой маленькой части биткоина.

Для конвертации используйте методы получения курсов валют. Курс часто меняется, поэтому получите его во время зачисления и сделайте конвертацию.

Пример на языке PHP

DATA HOSTED WITH ♥ BY PASTEBIN.COM - DOWNLOAD RAW - SEE ORIGINAL

  1. // Пример создания платежа
  2.  
  3. // необходимое вам кол-во подтверждений
  4. define('CONFIRMATIONS', 3);
  5.  
  6. // уровень комиссии, чем выше, тем быстрее зачисление
  7. define('FEE_LEVEL', 'low');
  8.  
  9. // адрес вашей логики приема callback'ов
  10. $callback = 'https://example.com/bitcoin-payment-callback';
  11. $callback = urlencode($callback);
  12.  
  13. // формируем адрес для создания платежа
  14. $requestUrl = 'https://bitaps.com/api/create/payment/';
  15. $requestUrl .= 'YOU_BITCOIN_PAYMENT_ADDRESS/';
  16. $requestUrl .= $callback;
  17. $requestUrl .= '?confirmations=' . CONFIRMATIONS . '&fee_level='. FEE_LEVEL;
  18.  
  19. $data = file_get_contents($requestUrl);
  20. $result = json_decode($data, true);
  21.  
  22. // если произошли какие-либо ошибки создания платежа
  23. if (!$result || isset($result['error_code'])) {
  24.    throw new \Exception('Bitcoin payment creation error: ' . $data);
  25. }
  26.  
  27. // если все OK, получим массив данных
  28. [
  29.    // сгенерированный адрес для приёма оплаты
  30.    "address" => "14aT7ELki1pVWtryd5brMGqsFySWgjy8je",
  31.  
  32.    // код платежа
  33.    "payment_code" => "PMTvvdRdFBPvY1KrDeRxSuwr4nDcMVBenbX2rB2zRYHBHbGRYK5Lu",
  34.  
  35.    // счет
  36.    "invoice" => "invNfFnca2Vg49dDg77exiQmqrVKCMBWsBBrB95HNZGbAwqQpNY2b"
  37. ]
  38.  
  39.  
  40. // После оплаты сервис посылает подтверждения на ваш callback
  41. /*
  42.   * В каждом колбэке отправляются переменные в POST запросе:
  43.   * tx_hash={transaction hash}
  44.   * address={address}
  45.   * invoice={invoice}
  46.   * code={payment code}
  47.   * amount={amount} # Satoshi
  48.   * confirmations={confirmations}
  49.   * payout_tx_hash={transaction hash} # payout transaction hash
  50.   * payout_miner_fee={amount}
  51.   * payout_service_fee={amount}
  52. */
  53.  
  54. // Пример обработки подтверждений ($data = $_POST)
  55.  
  56. // будем ждать последнего подтверждения для зачисления денег
  57. if (intval(ArrayHelper::getValue($data, 'confirmations')) !== CONFIRMATIONS) {
  58.    return;
  59. }
  60.  
  61. // получаем сумму
  62. $bcAmount = ArrayHelper::getValue($data, 'amount');
  63. if (!$bcAmount) {
  64.    throw new \Exception('bcAmount is not found!');
  65. }
  66.  
  67. // сумма в Сатошах, нам нужна в BTC
  68. $bcAmount = ($bcAmount / 100000000);
  69. if ($bcAmount < 0) {
  70.    return;
  71. }
  72.  
  73. // получаем курс на данный момент для конвертации в рубли
  74. // чтобы зачислить клиенту в рублях
  75. $exchangeRate = Bitcoin::getExchangeRate();
  76. $rubAmount = $bcAmount * $exchangeRate;
  77.  
  78. // сохраняем информацию о платеже в БД
  79. $invoiceBitcoin->bcAmount = $bcAmount;
  80. $invoiceBitcoin->rubAmount = $rubAmount;
  81. $invoiceBitcoin->save();
  82.  
  83. // логика зачисления денег в сервисе клиенту
  84. $afterPayment = new AfterPayment();
  85. $afterPayment->addMoneyToUserByInvoice($invoiceBitcoin);

Количество подтверждений

Необходимое количество подтверждений зависит от модели риска, клиентов и сумм. Если вы доверяете клиентам, то принимайте платежи без подтверждений или с одним подтверждением. При небольших переводах трех подтверждений достаточно.

Шесть подтверждений математически невозможно подделать, не имея 51% вычислительной мощности сети. Чем больше подтверждений необходимо, тем больше комиссия и время ожидания. В среднем платеж проходит 15-20 минут, а оплата для клиента будет выглядеть следующим образом:

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

Важные замечания

  1. Кроме комиссии сервиса приема платежей, существует биткоин-комиссия за перевод с временного кошелька на указанный вами. Об этом нигде, к сожалению, не написано, поэтому рекомендуем не проводить мелкие платежи. В нашей сети установлено минимальное пополнение — 1000 рублей.
  2. Курс биткоина, как и других криптовалют, ощутимо меняется каждую секунду. Рекомендуем пересчитывать курс и как можно чаще выводить биткоин в реальную валюту. Конечно, это работает для тех случаев, если вам важно работать с реальной валютой, конвертируя биткоин по курсу.
  3. Не каждый блокчейн-сервис разрешает использовать API для приема платежей без подтверждения. Критерии приема в тот или иной сервис неизвестны, поэтому подавайте заявки в несколько мест.
  4. В каждом сервисе комиссии на прием платежей отличаются. Изучите детально каждый, прежде чем решите подключиться.
  5. Не выставляйте число обязательных подтверждений для выполнения оплаты выше шести. Это приведет к большему времени ожидания для клиента и негативным отзывам. Для безопасности хватит трех.
  6. При уровне комиссии low перевод средств занимает тридцать минут. Если желаете сэкономить покупателям средства, не увеличивайте уровень комиссии.