Лучшие API криптоплатежей

Почему этот список игнорирует общий балл#

Он сортируется по одному критерию интеграций, а не по взвешенному итогу: разработчику, оценивающему API, безразлично, что провайдер хорошо рассчитывается и быстро проверяет. Вопрос в том, достаточно ли хороша документация, чтобы дойти до тестовой транзакции ни с кем не разговаривая.

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

Три вещи, которые решают исход интеграции#

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

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

Тестовый режим есть не у всех, и его отсутствие дорого#

Одни провайдеры дают песочницу, ведущую себя как боевая среда; другие предполагают, что вы отправите настоящие деньги в дешёвой сети и посмотрите, что будет. Второй подход работает — и он медленнее, грязнее и непригоден для прогона в непрерывной интеграции.

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

Недоплата — случай, под который не пишут первым#

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

Решите, что должен делать ваш поток заказов в этом случае, прежде чем писать обработчик, и проверьте, что провайдер такое поведение действительно поддерживает. Почему это так часто случается, объясняет статья о недоплате, — и это самая частая причина обращений в поддержку во всей криптокассе.

Окна фиксации курса различаются сильнее, чем ставки#

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

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

Провайдеры с одним только API и что это значит#

B2BINPAY, BVNK, 0xProcessing и Triple-A называют среди интеграций API и почти ничего сверх него. Для разработчика это нейтральная информация; для бизнеса, спрашивающего о сроках, это значит, что каждая поверхность будет написана с нуля.

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

Что документация должна позволять сделать без посторонней помощи#

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

Чаще всего размытой оставляют именно проверку подписи, а она и важна для безопасности. Обработчик вебхуков, действующий по непроверенным данным, — это способ получать «платежи» от любого, кто угадает URL, и место этому исправлению в первой версии, а не во второй.

Прежде чем выделять время разработки#

Читайте каталог ошибок, а не быстрый старт. Быстрый старт показывает путь, где всё получается, — тот самый, на который вы потратите меньше всего времени; ошибки показывают, как провайдер предполагает обрабатывать всё остальное, и их отсутствие — тревожный знак.

Затем прогоните шорт-лист через чек-лист интеграции. Он короче, чем платёжная интеграция заслуживает, и ловит те сбои, которые дорого обнаруживать после запуска.

Читайте каталог ошибок, а не быстрый старт#

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

Её отсутствие — само по себе вывод. Платёжное API без описанной поверхности сбоев обойдётся вам разницей в обращениях в поддержку.

Проверке подписи место в первой версии#

Обработчик вебхуков, действующий по непроверенным данным, — это способ получать «платежи» от любого, кто угадает URL. Подписывают свои колбэки здесь все, и проверка занимает несколько строк.

Это пункт, который откладывают чаще прочих, и у него худший сценарий отказа. Пишите его до того, как заработает счастливый путь, а не после.