Скрипт для оплаты bitcoin

Как принимать к оплате биткоин используя API Blockchain

Прием платежей в биткоинах становится популярней и востребованней, а значит уважающий себя интернет-магазин должен иметь такую возможность.

По аналогии с известными методами оплаты, такими как PayPal, WebMoney, VISA и Mastercard, Klarna и прочие, есть разные методы приема оплаты в биткоинах на своем сайте. Один из удобнейших методов в случае с биткоином — использование API биржи Blockchain. Вам не нужно привязываться к конкретному языку или SDK, не нужно даже там регистрироваться как в обычных мерчантах (которые, к тому же, становятся все привередливее).

Все что вам необходимо: иметь кошелек для приема биткоинов (или несколько, если будет угодно) и некоторое время на подключение довольно простых API в вашу систему. К тому же, клиент увидит не ваш родной кошелек, а временный кошелек биржи (что тоже приятно, не так ли?).

Прежде чем говорить непосредственно о коде (я буду в примерах использовать PHP, однако все это легко реализуется на JAVA, Python и т.д.), следует прояснить сам механизм приема оплат.

Тут все довольно просто и укладывается в следующую последовательность:

1. Вы запрашиваете у Blockchain временный кошелек, отправив ряд данных.
2. Blockchain возвращает свой временный кошелек для приема оплат вам.
3. Вы показываете этот кошелек клиенту, а также небольшую инструкцию что с этим делать.
4. Клиент оплачивает (переводит средства на кошелек).
5. Дальше следует подождать валидации платежа в системе Bitcoin.
6. В случае успешной валидации системой Blockchain будет вызван скрипт на вашем сайте (вы сами указываете какой) и переданы все данные транзакции.
7. После этого можно спокойно подтверждать факт оплаты уже внутри вашей системы.

Теперь о деталях реализации. Исходить будем из того, что у вас один кошелек (вариант с несколькими сводится в любом случае к выбору одного, а метод их хранения — любой, на ваше усмотрение).

Для получения временного кошелька следует отправить ряд данных:

1. URL скрипта, который будет вызван в случае успешного подтверждения транзакции. Следует заметить, что рекомендуется указывать некий параметр, или даже несколько для возможности идентификации платежа в текущей системе. Можно, конечно, просто указать идентификатор клиента в вашей системе и при получении подтверждения транзакции уже тогда вносить какие-либо данные в БД. Однако я (а также официальная документация) рекомендую использовать заранее созданный номер платежа и какую-либо проверочную фразу. Суммарно получится URL с параметрами как при обычной передаче GET запросом. Для системы Blockchain этот параметр носит название callback. Значение же следует закодировать как URL-строку.
2. Ваш кошелек, для приема платежа. Собственно, на него Blockchain и переведет полученные деньги. Параметр носит название address.
3. Последний из параметров носит название method и для создания временного кошелька всегда имеет значение create.

Эти данные отправляются скрипту Blockchain по адресу https://blockchain.info/api/receive, при этом каждый из параметров идет обычным GET параметром, а результат его выполнения обрабатывается вашей системой (результат будет в формате JSON). Обо всем этом говорится в документации Blockchain API .

Проще всего это рассмотреть на примере:
[snippet >

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

И пока мы не перешли к следующему шагу, внесу ряд замечаний:

1. Этот код — максимально прост. В реальной системе я бы советовал использовать грамотно продуманный и написанный класс, а также использовать базу данных для хранения подготовленных платежей (как минимум, важно хранить номер платежа, идентификатор пользователя в системе, проверочную фразу или ее составляющие).
2. Функции file_get_contents будет достаточно. Использование cURL или даже чистых сокетов — дело личное и зависит от реализации получения данных от сервиса.
3. Время на валидацию платежа может быть разным и весьма существенным (доходило до 6 часов у меня). А курс биткоина может поменяться. Так что тут есть два варианта: или хранить курс на момент создания платежа (что может сыграть как в плюс, так и в минус) или же запрашивать его по факту получения подтверждения транзакции. Я использую второй метод для спокойствия. Это если вы конечно будете конвертировать биткоин в какую-нибудь другую валюту. Как конвертировать и получать курс я расскажу в конце.

А теперь — получение подтверждения транзакции (деньги к тому моменту на ваш кошелек уже поступят).

Файл должен именоваться receive_payment.php и лежать в корне сайта, так как при запросе временного кошелька мы указали именно такое именование при формировании $callback_url.

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

Однако, как и в предыдущем шаге внесу ряд замечаний:

1. ВАЖНО! На самом деле скрипт для одного и того же платежа будет вызван не один раз, а по количеству его подтверждений на отдельных нодах. Отсюда следует, что вам следует проверять, а не было ли раньше подтверждения. Иначе получится накрутка.
2. Blockchain отдает гораздо больше параметров, чем я указал в скрипте:
transaction_hash — хэш транзакции (он уникален);
input_transaction_hash — хэш оригинальной транзакции (он уникален);
input_address — кошелек Blockchain, на который придет платеж;
destination_address — ваш кошелек, на который придет платеж;
confirmations — количество подтверждения нодами (рекомендуется принимать подтверждение платежа в случае, если этот параметр имеет значение большее или равное 6).
3. Параметр value отдает значения не в биткоинах, а в satoshi (1 Satoshi = 0.00000001 BTC). Поэтому следует приводить полученное значение к биткоинам (по указаной в примере скрипта формуле выше).
4. Параметры invoice_id и secret являются кастомными, то есть задаются вами еще на этапе получения кошелька от Blockchain. Соответственно их может быть больше, меньше, вообще не быть, а также они могут иметь любые названия.
5. Рекомендую хранить в истории платежей полученное значение в биткоинах, однако конвертировать его в другую валюту (доллары, например), которая используется у вас в системе. Если же ваша система работает только с биткоинами — ничего конвертировать не нужно.

На этом можно было бы завершить статью — получать биткоины вы теперь умеете, однако я не могу не затронуть вопрос конвертации биткоина в другие валюты по курсу биржи Blockchain. По этому вопросу существует отдельная документация: Exchange Rates API.

Этот сервис может ровно две вещи:
1. Дать сводку текущего курса. Вернет JSON. Как этим пользоваться на своем сайте — решать вам. Я приведу только примитивный пример:
[snippet >

Полная распечатка результата есть в документации.
2. Конвертировать для вас из указанной валюты необходимое указанное количество денежных единиц в биткоины. Я б сказал — сервис для ленивых. Пример:
[snippet >

Сервису надо отдать два параметра:
currency — название валюты (список валют есть в документации, а также его можно получить самостоятельно, используя код из предыдущего пункта, просто вызвав там print_r($exchange_data_obj);).
value — сколько меняем.

Все. Вернет только число биткоинов.

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

Источник

Если Litecoin отправлен на bitcoin-адрес. Как быть?!

Пиринговая платежная система, использующая одноименную расчетную единицу и одноименный протокол передачи данных, «Биткоин», многим полюбилась из-за криптографических методов, обеспечивающих защиту системы. Еще одним очевидным плюсом является то, что вся информация о транзакциях между адресами системы доступна в открытом виде. В этой статье мы рассмотрим способ добавления «Биткоин» на ваш сайт в качестве системы оплаты.

2. Как получить ключ API?

3. Создание новых адресов для ваших клиентов

Введение

Биткоины — довольно привлекательный метод оплаты для онлайн-предпринимателей, в основном из-за того, что комиссия при использовании этого метода крайне незначительна в сравнении с PayPal или кредитными картами. Соответственно, это позволяет получить более высокую прибыль и предлагать услуги клиентам во всем мире по доступным ценам. Более того, биткоины формально не облагаются налогом, поскольку не представляют собой денежную форму, выдаваемую правительством. Также среди достоинств системы «Биткоин» можно выделить отсутствие необходимости обращения к посредникам.

В этой статье мы попробуем добавить биткоины в качестве способа оплаты на сайте. Для принятия платежей мы будем использовать Blockchain.info Receive Payments API V2, так как он прост, безопасен и может быть реализован менее чем за 10 минут.

Получение информации из биткоин сети

Самый “тяжеловесный” пункт. Классическим решением является поднятие собственного эталонного полного узла Биткоин, он же — каноничный bitcoind. Это позволит нам общаться с ним по JSON-RPC. С ним мы сможем как получать информацию из сети, так и пушить транзакции. На что стоит обратить внимание:

• После установки, синхронизация узла может занять длительное время. Только после синхронизации узел можно использовать.
• Займет немало места. Уже 40+ гигабайт.
• Мне лично неизвестно какую нагрузку по запросам сможет выдержать.
• Любые проблемы с падением/обновлением лягут на ваши плечи.

Альтернатива — имплементация полного узла на Ruby+PostgreSQL, Toshi. Неканоничная, но стремящаяся к полной совместимости реализация. Обратите внимание, из-за дополнительных индексов, база данных займет 220+ гигабайт места. Опять таки, требуется синхронизация с сетью. Возможно, есть другие имплементации полного узла (мне неизвестны). Еще одна альтернатива
— использование публичного API провайдера. На его плечи ляжет получение информации из сети и трансляция транзакций.

• chain.com
• blockchain.info/ru/api (не рекомендую)
• www.blockcypher.com
• chain.so/api
• coinalytics.co
• www.blocktrail.com
• coinkite.com/developers
• другие

Лично я рекомендую подключить несколько решений с фейловером.

Blockchain.info’s API V2

Paychanges API V2 Blockchain.info является самым простым и быстрым способом начать принимать платежи биткоинами от кого угодно в любой точке мира с помощью простого HTTP-GET-запроса. Стоит отметить, что одним из основных препятствий, связанных с принятием платежей биткойнами, является необходимость создания уникального адреса биткойнов для каждого нового пользователя или счета. Эти сгенерированные адреса должны быть под контролем и безопасно храниться. API приема платежей отвечает за создание и мониторинг биткоин-адресов. При получении платежей API позволяет уведомить сервер с помощью простой процедуры обратного вызова.

Как получить ключ API?

Чтобы использовать API Blockchain.info, вы должны заполнить форму заявки по адресу:

Обратите внимание, что этот ключ API предназначен только для получения платежей. Существует стандартный API кошелька, который доступен в Python, Java, .NET (C #), Ruby, PHP и Node и может использоваться для отправки и получения платежей. Однако он отличается от Receive Payments V2 API тем, что не подходит для генерации разных адресов для разных пользователей.

На рисунке ниже показана форма заявки на получение Receive Payments V2 API. Вам нужно будет ввести свое имя, адрес электронной почты, URL-адрес сайта, на котором вы будете внедрять API, а также описание товаров, которые вы продаете, или услуг, которые предлагаете на своем веб-сайте. В большинстве случаев заявка рассматривается в течение 2-3 рабочих дней.

Рисунок 1. Форма заявки на получение Receive Payments V2 API

Общие принципы работы платежного шлюза

Вариант 1

Предположим, у нас есть уникальный счет (invoice, order), представленый к оплате клиенту, и платить клиент будет в биткоинах. Начнем с того, что надо сконвертировать валюту оригинального счета (USD например) в BTC. Задача это тривиальная и рассматривать мы ее не будем. Далее. Стандартом де факто является генерация нового уникального адреса биткоин под каждый заказ (он же счет, он же invoice, он же ордер). Ожидается, что средства на этот счет переведет только наш клиент, только 1 раз, и только строго указанную сумму (можно больше, никто не обидится, но никак не меньше). Т.о. при поступлении средств на указанный биткоин адрес в нужном количестве, заказ считается оплаченным.
Вкратце, цепочка такая:

• ордер в системе ->
• генерируем соответствующий ордеру уникальный адрес биткоин ->
• показываем клиенту ->
• ждем оплату на адрес ->
• ордер закрыт (отмена по истечению срока годности или же поступление BTC и засчитываем факт оплаты)

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

Если вы имеете возможность “отобрать” предоставленный товар или услугу у клиента в случае выявленного факта отмены транзакции, я рекомендую засчитывать неподтвержденный баланс. Это будет означать почти мгновенный процесс оплаты для клиента (в противовес часа ожидания, например). А если какие то транзакции выявятся откаченными в итоге, запросить клиента о повторном платеже, угрожая отобрать услугу/товар.

Не ожидайте что подобный фрод вас тут же массово настигнет, откат транзакций это очень большая редкость, а “вручную” стимулировать подобный откат (на который кстати у злоумышленника нет никаких гарантий успеха) технически неподкованным клиентам нереально (в противовес чарджбекам по кредитным картам).

Еще один пример когда можно засчитывать неподтвержденный баланс — если на подготовку заказа клиента уходит больше одного часа (например обрабатывается корзина покупателя, готовится к отправке курьерской службой). Тут куча времени перепроверить баланс перед самой отправкой товаров.

Для остальных случаев можно ввести некий порог, выше которого обязательно ожидать подтвержденного баланса (например 0.25 BTC). Для максимальной надежности сделать его нулевым.

После закрытия ордера вы можете оставить биткоины на этом адресе до востребования, или для удобства перевести на единый “агрегационный” кошелек мерчанта. Будьте осторожны, в последнем случае вы можете скомпрометировать такой коммерческий показатель как “оборот”, т.к. транзакцию оплаты может отследить каждый платящий клиент. Для переводов вам понадобится создавать, подписывать и транслировать транзакции, используя приватные ключи от адресов.

Пару слов о времени жизни ордера.

Если ваш товар или услуга жестко привязаны к эквиваленту в фиатной валюте (например USD), то типичный срок жизни ордера составляет 7-15 минут из-за волатильности курса.

Вариант 2

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

• генерация адреса пользователю ->
• мониторинг транзакций на адрес ->
• пополнение внутреннего счета при наличии входящих транзакций

Получение расширенного публичного ключа (Extended Public Key)

Чтобы иметь возможность получать платежи, вам потребуется учетная запись BIP32. Самый простой способ начать прием биткоинов — создать кошелек blockchain.info по адресу:

Вам нужно создать новую учетную запись, которая будет использоваться исключительно для получения транзакций, поддерживаемых API. При вызове API нужно использовать ключ xPub, который можно найти в «Настройки-> Учетные записи и адреса -> Дополнительные параметры -> Показать код xPub».

Рисунок 2. Получение ключа xPub

Как завести криптовалюту на Bitcoin Core

Чтобы завести криптовалюту на Bitcoin Core необходимо в главном окне выбрать вкладку «Получить»:

В открывшемся окне нужно заполнить необходимые поля и нажать кнопку «Запросить платеж»:

После этого программа выдаст адрес для перевода коинов и QR-код для платежа:

Для пополнения можно использовать только BTC, другие криптовалюты или фиатные деньги не поддерживаются.

Создание новых адресов для ваших клиентов

Для каждого клиента у нас будет свой уникальный адрес, на который он будет отправлять платежи. При получении денег на любой из таких адресов вам будет отправлено HTTP-уведомление. Обратите внимание, что каждый вызов, сделанный на сервере, приведет к увеличению параметра index, это делается для того, чтобы убедиться, что один и тот же адрес не назначен более чем одному клиенту. Тем не менее все средства, отправленные на любой из созданных адресов, будут добавлены в один и тот же кошелек.

https://api.blockchain.info/v2/receive?xpub=$xpub&callback=$callback_url&key=$key

Следует учесть, что существует программное ограничение — кошелек не сканирует более 20 неиспользуемых адресов. Таким образом, API будет возвращать ошибку, если более 20 из ранее созданных адресов не были использованы. Если вы столкнулись с этой ошибкой, вам придется либо перейти на новый xPub (в том же блоке blockchain.info), либо начать получать платежи на один из ранее созданных неиспользуемых 20 адресов.

Это можно опционально контролировать, добавляя gap_limit в качестве дополнительного параметра URL, что не приведет к увеличению числа биткоин-адресов, которые могут отслеживаться серверами Blockahin.info. Добавление параметра gap_limit изменяет максимально допустимый интервал, после которого API больше не будет генерировать новые адреса.

https://api.blockchain.info/v2/receive?xpub=$xpub&callback=$callback_url&key=$key&gap_limit=$gap_limit

Ниже рассмотрим параметры, используемые в приведенном URL:

• xpub: ваш xPub (пункт назначения, куда будут отправляться платежи ваших клиентов).
• callback_url: это URL-адрес обратной связи, на который будут приходить уведомления при получении платежа.
• key: ваш ключ API-интерфейса получения платежей, который вы получите после того, как приложение будет успешно принято.
• gap_limit: необязательный параметр, который определяет количество неиспользуемых адресов биткоинов, разрешенных до того, как будет возвращена ошибка.

С помощью xPub создаем неиспользуемый биткойн-адрес:

Теперь пусть ваши клиенты отправляют средства по адресу, указанному в ответе:

RESPONSE: 200 OK, APPLICATION/JSON

Ниже приведен пример реализации на PHP:

$my_callback_url = ‘INSERT YOUR CALLBACK URL HERE +/- that can include customer identification parameters such as ?invoice_id=058921123&secret=’.$secret;

$response = file_get_contents($root_url . ‘?’ . $parameters);

echo ‘Send Payment To : ‘ . $object->address;

Первый способ (проще):

Для реализации следующих шагов потребуются родной core-клиент от litecoin (litecoind). Возможно, нужный функционал есть в каком-либо еще клиенте — не проверял. Попробуем импортировать WIF от bitcoin-адреса прямо в litecoin. litecoin-cli importprivkey Kz1s4tr1PqQ9nyq8Tukzx6MyK8XMNDvvhfXWxYCcVgJdErtFiwvA

По окончанию можно проверить баланс командой: bitcoin-cli getbalance

Или посмотреть непотраченные выходы командой: bitcoin-cli listunspent

Если WIF импортировался и на нем были средства, то Вы увидите это командами getbalance, listunspent.

Также, разумеется команда: bitcoin-cli dumpprivkey 366ys86t5Evf4xeW4ngst1cwJM1YKDSC7x

Должна вернуть результат: Kz1s4tr1PqQ9nyq8Tukzx6MyK8XMNDvvhfXWxYCcVgJdErtFiwvA

Источник