Как добавить криптоплатежи в интернет-магазин

Сначала решите

Четыре решения сэкономят переделки.

1. Какие активы и сети. Начните с малого: USDT и USDC покрывают большинство клиентов. Qvard поддерживает USDT, USDC, BTC, LTC, TRX, BNB и ETH в сетях TRC20, ERC20, BEP20, Bitcoin и Litecoin.
2. Цена в долларах. Оставьте цены как есть. Платёж создаётся в долларах США, а точная сумма в крипте показывается на странице оплаты, курс фиксируется на один час.
3. Что запускает оплаченный заказ. Отправка, лицензионный ключ, доступ к контенту. Решите, что происходит в момент завершения платежа.
4. Что делать, когда что-то пошло не так. Неполные платежи, возвраты, клиент, заплативший не в той сети. Запишите правило сейчас.

Шаги интеграции

Готовых плагинов для магазинов у Qvard пока нет, поэтому магазин подключается через API. Это два куска серверного кода.

1. Создайте платёж, когда клиент выбирает крипту. POST на https://api.qvard.com/api/v1/payment, где ваш номер заказа в id, а сумма заказа в долларах США в price, с авторизацией вашим API-ключом. В ответе будет redirectUrl; отправьте клиента туда.
2. Получите результат. Сохраните callback URL в кабинете. Когда платёж завершён, Qvard отправляет POST с номером заказа и статусом. Отметьте заказ оплаченным и запустите выполнение. Отвечайте ровно HTTP 200.
3. Сделайте обработчик безопасным. Он может прийти более одного раза, поэтому повтор не должен ничего менять.

Подробные версии: как принимать криптоплатежи на сайте для общего процесса, WordPress и WooCommerce для этих платформ и API для криптоплатежей как справочник.

Сопоставьте статусы с состояниями заказа

У платежа четыре статуса: wait, partial, completed и rejected. Заказу нужны соответствующие состояния, а webhook приходит только на completed.

• Созданный и неоплаченный заказ соответствует wait.
• Неполный платёж соответствует partial: держите заказ в ожидании и попросите клиента доплатить.
• Оплаченный заказ соответствует completed: выполняйте его.
• rejected: считайте платёж неудавшимся и дайте клиенту повторить.

Полное сопоставление с кодом в материале криптоплатежи для интернет-магазина.

Формулировки на чекауте

Большинство обращений в поддержку по крипте вызвано неясными формулировками. На шаге оплаты:

• назовите принимаемые монеты и сети;
• скажите, что сумму нужно отправить полностью и по сети, указанной на странице оплаты;
• укажите, что курс фиксируется на один час;
• объясните, как работают возвраты и где получить помощь.

URL возврата Qvard пока не предоставляет, поэтому клиент попадает на страницу оплаты, а что будет дальше, объясняете вы. Понятная страница заказа, которая обновляется после webhook, и письмо с подтверждением заменяют редирект.

Тест и запуск

Sandbox пока нет, поэтому тестируйте небольшими реальными суммами.

1. Оплатите небольшую реальную сумму и проследите весь путь: платёж создан, клиент заплатил, webhook получен, заказ отмечен оплаченным.
2. Один раз заставьте точку вернуть ошибку и убедитесь, что повтор (пять попыток примерно за шесть минут) не выполняет заказ дважды.
3. Выведите небольшую сумму на свой кошелёк, чтобы проверить этот шаг. Он стоит только сетевую комиссию.
4. Добавьте крипту на чекаут и понаблюдайте за первыми заказами.

После запуска ведите короткую рутину; список в материале операционный чек-лист продавца криптоплатежей. Стоимость: абонентской платы нет, а комиссия, индивидуальная для проекта, по странице тарифов начинается с 1% и может быть снижена до 0,1%.

FAQ