Как работает интеграция онрампа

Три способа интегрировать онрамп: виджет, гостевая касса, API

Есть три распространённых способа интегрировать онрамп. Различаются они тем, сколько вы строите сами и сколько контроля получаете взамен. Виджет запускается быстрее всего, гостевой чекаут почти так же быстро. Полноценный API даёт максимум свободы и требует максимум работы. Какой подходит — зависит от вашей команды и сроков. Будьте честны с собой насчёт того, сколько ресурсов разработки можете выделить, ведь обычно именно это и решает.

Криптовиджет — это iFrame, который вы встраиваете в свою страницу, и вся покупка проходит внутри него, в ваших цветах. Hosted checkout ещё легче по фронтенду: вы отправляете пользователя на готовую страницу и встречаете его, когда он возвращается. Оба опираются на провайдера в сложных частях, поэтому небольшие команды обычно начинают отсюда.

Путь через API, иногда это host-to-host-подключение, позволяет собрать экраны самостоятельно и владеть каждым шагом. Это стоит реальных часов разработки, так что подходит командам, которым нужен кастомный вид или у которых уже есть платёжный стек. Ещё выбираете? Наш гайд о том, как выбрать крипто-онрамп для бизнеса, разбирает компромиссы.

Сравнение моделей для интеграции онрампа

Как подобрать модель под свою команду

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

Гостевой чекаут уместен, когда вы вообще предпочли бы ничего не встраивать, например ваш сайт работает под строгими правилами безопасности. Вы задаёте редирект и return URL — вот, по сути, и всё. По трудозатратам он между виджетом и API.

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

Технический процесс интеграции

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

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

Аккаунт, ключи и sandbox

Сначала вы регистрируетесь и проходите проверку бизнеса, а потом получаете API-ключи и sandbox. Sandbox ведёт себя как боевая система, но работает на тестовых деньгах, так что ничего настоящего не двигается, пока вы собираете.

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

Активы, способы оплаты и конвертация

Дальше — меню: какие монеты пользователи могут купить и какими фиатными способами платить, карты, банковские переводы и так далее. Провайдер делает обмен fiat-to-crypto и доставку on-chain, так что вы сами никогда не называете курс и не двигаете монеты.

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

Webhooks, тестирование и запуск

Webhooks — это то, как онрамп сообщает вашей системе, что только что произошло, так что завершённая или неудачная покупка сама обновляет статус в приложении. Вы даёте провайдеру endpoint, затем прогоняете тестовые покупки через sandbox и проверяете, что каждый статус долетает. Планируете давать покупать по графику? Прочитайте, зачем бизнесу регулярные криптоплатежи, прежде чем проектировать эту часть.

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

Что команды часто упускают

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

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

Разрываетесь между тремя моделями? Расскажите, как устроена ваша команда, и мы скажем, какая запустит вас быстрее. Свяжитесь с нами.

Требования к комплаенсу в процессе интеграции

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

Перед запуском ждите проверку Know Your Business (KYB). Вы передаёте документы компании, данные о тех, кто ею владеет или управляет, и сайт или приложение, где будет работать онрамп.

Ваши пользователи, в свою очередь, проходят Know Your Customer (KYC), и обычно это по уровням. Для небольшой покупки может хватить email и номера телефона; суммы побольше требуют документ, иногда ещё и подтверждение адреса. Всё это проводит провайдер, так что ни один из этих чувствительных документов никогда не лежит на ваших серверах.

Что подготовить для комплаенса

Сколько занимает верификация

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

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

Типичные уровни верификации пользователя

Стоимость интеграции онрампа

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

Полную раскладку по комиссиям здесь пропустим, ведь наша статья «Что такое онрамп» уже разбирает, куда уходит каждая её часть. Если коротко: курс, который вы видите, уже включает способ оплаты, стоимость сети и долю провайдера.

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

Зависит ли тарификация онрампа от типа интеграции?

Реальная стоимость – это время разработки, а не сборы

Раз комиссия одинакова для всех моделей, по-настоящему меняется ваше время на разработку. Виджет может быть работой на день. Полная интеграция на API может съесть недели времени разработчиков, если считать вместе с тестированием.

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

Как работает интеграция онрампа от Inqud

Онрамп от Inqud — это одна из частей более широкого криптоплатёжного шлюза, так что один аккаунт закрывает покупку крипты, её приём и расчёты. Онрамп от Inqud даёт вам все три модели интеграции — iFrame-виджет, страницу checkout и host-to-host API, и большинство команд запускаются меньше чем за два дня.

Пользователи могут купить Bitcoin, Ethereum, Solana, USDC и токены в сетях вроде Polygon, Tron, Optimism и Arbitrum, оплачивая через Visa, Mastercard или банковским переводом. Верификация, проверки на мошенничество и AML-скрининг идут тихо на фоне, а если один платёжный маршрут не сработал, схема с несколькими провайдерами повторяет попытку через другой и спасает продажу. Есть подписки в планах? Inqud проводит регулярные криптоплатежи на той же системе.

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

Онрамп от Inqud

Готовы показать пользователям онрамп? Поможем оценить объём работ и быстро всё запустить. Свяжитесь с командой Inqud.