Hosted-чекаут или собственный чекаут для криптоплатежей

Два способа принять платёж

• Hosted-чекаут. Вы создаёте платёж и отправляете клиента на страницу, которую ведёт провайдер. Провайдер показывает адрес, точную сумму и статус; результат вы получаете уведомлением.
• Собственный чекаут. Форма платежа живёт внутри вашего сайта или приложения. Вы сами показываете реквизиты платежа, следите за статусом и обрабатываете каждое состояние, которого может достичь клиент.

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

Что должен делать крипто-чекаут

Карточный чекаут в основном собирает несколько полей и вызывает API. У криптовалютного задач больше:

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

В каждом из этих мест ошибка стоит клиенту денег. Это самый сильный аргумент за размещённую страницу.

Почему Qvard сегодня работает через размещённую страницу

Платёжный процесс Qvard построен вокруг размещённой страницы. Вы создаёте платёж одним POST на https://api.qvard.com/api/v1/payment, и в ответе есть redirectUrl, адрес этой страницы. Клиент выбирает там актив и сеть, видит адрес и точную сумму и платит; курс зафиксирован на один час. См. как работает redirectUrl в крипто-чекауте.

Публичный API небольшой: он создаёт платёж, проверяет готовность способа оплаты и отправляет выплату. Он не отдаёт вам адрес для показа самостоятельно и не имеет маршрута для чтения статуса платежа, поэтому следить за платежом со своей страницы вы бы не смогли. Встроенный чекаут готов, SDK готовы; полностью собственный крипто-чекаут, с показом адреса и опросом статуса у вас, этот API по-прежнему не поддерживает.

Что вы всё равно можете оформить сами

Размещённая страница делает самое сложное. Опыт вокруг неё ваш:

• Шаг до. Выбор «Оплатить криптой», объяснение, что произойдёт, комиссии и правило возврата, своими словами и в своём дизайне.
• Шаг после. Страница заказа с реальным статусом (ожидает, неполный, оплачен), обновляющаяся в ожидании и подсказывающая клиенту, что делать дальше. Возвратных адресов пока нет, поэтому клиент возвращается через эту страницу.
• Сообщения. Письмо, которое вы отправляете при оформлении заказа, оплате или неполном платеже.
• Бизнес-логика. Какие статусы отпускают товар, что вы делаете с неполным платежом, как возвращаете деньги.

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

Как выбрать

• Выбирайте hosted, если хотите запуститься скоро, если команда небольшая, если не хотите отвечать за особые случаи блокчейна или просто нужно, чтобы работало. Именно это Qvard поддерживает сегодня.
• Используйте встроенный чекаут, если для продукта принципиален бесшовный опыт на странице. Его логика счёта совпадает с размещённой страницей, поэтому логика заказов, webhook и страница заказа не меняются.
• Не стройте собственную генерацию адресов и сканирование ради внешнего вида. Это самый тяжёлый и рискованный способ купить дизайн.

Что бы вы ни выбрали, серверная часть та же: создать платёж с номером заказа в id, помечать заказ оплаченным только из webhook (ровно HTTP 200, безопасно при двойном запуске) и сверяться. См. как принимать криптоплатежи на сайте и API для криптоплатежей. Размещённую страницу показывает демо-счёт.

FAQ