https://habr.com/ru/post/520416/

• JavaScript
• Node.JS
• Финансы в IT

Если Вы планиуете подключать криптовалютные платежи и еще не знакомы с Coinbase Commerce, стоит потратить 5 минут Вашего времени. Расскажу о подключении, настройке и поделюсь готовым open source решениями для Nodejs.

Coinbase Commerce — это крипто-эквайринг без комиссий, паспортов, с отличным API и Вашим личным счетом.

Привет, Хабр!

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

Главный вопросом был выбор сервиса, который подходит для целевой аудитории. В нашем случае, целевая аудитория — это "штаты". Как известно, есть Америка и есть остальной мир, поэтому количество сервисов, которые нам подходят, быстро уменьшилось.

Список доступных криптовалют: USD Coin, Dai, Bitcoin, Bitcoin Cash, Ethereum, Litecoin

Coinbase Commerce (далее — CC).

English version.

Плюсы и минусы

• Быстрая настройка
• Нет комиссий — клиент переводит деньги напрямую на Ваш счет
• Принимает стейблкоины USD Coin & DAI, а также много других
• Глобальный сервис — у Америки в приоритете биржа "Coinbase", имеет фактор доверия даже со стороны государства. Для всего остального мира не принципиально
• Нет посредников. Только Ваш кошелек и Ваш аккаунт
• Отсутствие возвратных платежей. Конечно, клиенту можно вернуть средства по требованию, но это на Ваше усмотрение
• Тестирование хуков — с панели сервиса можно отправлять тестовые вебхуки

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

Регистрация

Процесс проходит в 5 этапов.

1. Регистрация аккаунта email + пароль
2. Подключение 2х этапной верификации
3. Настройка кошелька
4. Бекап кошелька
5. Доступ к интерфейсу и прием платежей

Подключение 2х этапной верификации

Настройка кошелька

При создании кошелька, CC генерирует seed-фразы, которые нужно сохранить.

После ручного ввода seed-фраз, CC предлагает использовать Google Drive для бекапа кошелька.

Доступ к интерфейсу и прием платежей

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

Есть два способа приема платежей, мы рассмотрим оба.

1. С использованием интерфейса — фиксированная оплата за товар\услугу или пожертвования. Не требует навыков программирования, подходит всем.
2. С использованием API — более сложный вариант, требующий настройки бэкенда. Позволяет создавать динамические платежи.

С использованием интерфейса

Создание позиции товара\услуги с фиксированной ценой.

Прием пожертвований.

Последним этапом, CC предлагает выбрать, какую информацию о пользователе будет собирать.

После того, как создаем позицию для оплаты, система нам предлагает варианты интеграции (ссылка или скрипт).

// link
// https://commerce.coinbase.com/checkout/<id>
<a href="https://commerce.coinbase.com/checkout/<id>" target="_blank">

// embed
<div>
  <a class="buy-with-crypto"
     href="https://commerce.coinbase.com/checkout/<id>">Buy with Crypto</a>
  <script src="https://commerce.coinbase.com/v1/checkout.js?version=201807">
  </script>
</div>

С использованием API

Вариант с API формирует платежку вручную и она активна ограниченное количество времени.

Схема работы

С клиента передаем информацию о сумме платежа на сервер, далее формируем временный
"checkout" и возвращаем ссылку https://commerce.coinbase.com/checkout/<id> на клиент, по которой пользователь переходит на страницу оплаты или происходит автоматическая переадресация.

В случае успешной оплаты, отмены или, если время платежки истечет, CC направит информацию на вебхук.

Настройка WebHook

Необходимо добавить url публичного вебхука Settings => Webhook subscriptions.

Протестировать работу вебхука можно на бесплатном сервисе Webhook.site.

Для локальной разработки нужно использовать модуль, который локальную точку доступа сделает публичной, например модуль Ngrok.

// install
$ npm install ngrok -g

// `http://localhost:3000/coinbase-webhook` => `https://<ngrok-host>/coinbase-webhook`
$ ngrok http 3000

Как вариант, можно использовать пример ответа вебхука с сайта Webhook.site и далее отправлять через Postman на локальную точку доступа.

После добавления вебхука, его можно протестировать. Интерфейс позволяет менять только события: charge:created, charge:confirmed, charge:failed, charge:delayed, charge:pending, charge:resolved.

Документация Webhook

Open Source

Подготовил вариант c использованием API — coinbase-commerce-node.

Заключение

В целом, мне понравилась интеграции Coinbase Commerce. Поделитесь своим опытом подключения платежей для приложений.

Спасибо за внимание!