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

blockwallets принимает USDT и USDC, а также BTC, LTC и родные монеты сетей (зачисляются в долларах США по зафиксированному курсу). Любая из интеграций ниже создаёт одинаковый счёт на одной и той же странице оплаты, с теми же подтверждениями, комиссиями и балансом; различается только то, как ваша система общается с нами. Выберите подходящую и перейдите на её страницу.

Выберите способ интеграции

Сгруппировано по тому, с чего вы начинаете. Каждая карточка открывает полное руководство.

Без кода

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

Новая интеграция по API

Вы пишете интеграцию с нуля.

Переход с другого шлюза

Код остаётся прежним: API совместимы, поэтому меняются только базовый URL и ключи.

Пусть интегрирует ИИ

Для тех, кто не пишет код, но пользуется ИИ-инструментом для программирования.

Инструменты

Помощь в отладке прямо в браузере.

Совместимый с Cryptomus или собственный?

Оба создают одинаковые счета на одной странице оплаты, с теми же комиссиями и балансом. Различаются стиль запросов, формат вебхуков и способ получения учётных данных.

Начинаете с нуля? Берите нативный REST API: суммы в центах, идемпотентный ref, подпись вебхуков с меткой времени и ключи, которые вы создаёте сами в кабинете. Уже работаете с Cryptomus или хотите использовать готовый SDK или плагин Cryptomus? Берите API, совместимый с Cryptomus.

Быстрый старт

От нуля до тестового платежа за пять шагов (для API, совместимого с Cryptomus; остальные API проходят те же шаги со своими учётными данными).

1. Запросите доступ на главной странице. После одобрения войдите в кабинет продавца.
2. Откройте в кабинете «Разработчикам › Интеграция и ключи», создайте merchant и API key в колонке Test и добавьте домены своего сайта.
3. Ваш сервер создаёт счёт через POST /v1/payment и перенаправляет клиента на result.url.
4. Оплатите его кнопкой «Симулировать оплату» на странице оплаты, затем убедитесь, что обработчик вебхука проверяет sign и зачисляет по payment_amount_usd.
5. Переключитесь на учётные данные из колонки Live и один раз оплатите небольшую настоящую сумму («Пробный платёж» на главной странице кабинета).

POST https://blockwallets.io/v1/payment
merchant: <merchant>
sign: md5(base64(body) + API key)
Content-Type: application/json

{
  "amount": "42.00",
  "currency": "USD",
  "order_id": "order_1042",
  "url_callback": "https://shop.example/webhooks/crypto",
  "url_return": "https://shop.example/cart",
  "url_success": "https://shop.example/thanks?order=1042"
}

Код на Node.js, PHP и Python для каждого шага есть в документации API, совместимого с Cryptomus; если хотите поручить это ИИ, начните с генератора промптов.

Платёжные ссылки (без кода)

Кабинет продавца → «Платежи › Платёжные ссылки» → введите описание и сумму (зафиксируйте сеть или дайте клиенту выбрать) → создайте. У каждой ссылки есть URL и QR-код.

• Каждое открытие ссылки создаёт новый счёт, поэтому одну ссылку можно использовать многократно (например, «Членство $99»).
• Каждый платёж виден в разделе «Платежи › Транзакции»; выводите деньги на свой кошелёк в разделе «Средства › Баланс и вывод».
• Если вы создали учётные данные и URL вебхука в разделе «Разработчикам › Интеграция и ключи», о платежах по ссылкам тоже приходят уведомления — в формате вебхуков, совместимом с Cryptomus.
• Чтобы прекратить приём, нажмите «Отключить» — ссылка перестанет работать сразу.

POS для магазинов

Для касс и прилавков: кабинет продавца → «Платежи › POS-касса» → откройте терминал и получите POS-ссылку. Сотрудник открывает её на телефоне или планшете, вводит сумму, и появляется QR-код для оплаты; когда клиент платит, на экране появляется «Paid».

• Счёт POS действует 30 минут. Платежи поступают на ваш баланс и отображаются в разделе «Платежи › Транзакции», а уведомления приходят на URL вебхука так же, как для платёжных ссылок.
• POS-ссылка позволяет только принимать платежи: она не показывает баланс, выводы, другие заказы, настройки и учётные данные.
• Потеряли устройство или сотрудник уволился? Отзовите этот терминал в кабинете, и его ссылка сразу перестанет работать.

Кнопка для сайта

Кабинет продавца → «Платежи › Платёжные ссылки» → «Кнопка для сайта»: выберите текст, цвет, размер и форму и скопируйте код. Нажатие на кнопку открывает страницу оплаты этой платёжной ссылки.

• Обычный HTML: одна оформленная ссылка без скрипта, поэтому работает везде, где можно вставить HTML (конструкторы сайтов, форумы, подписи в письмах).
• Со скриптом: добавьте data-blockwallets и один тег /embed.js; на компьютере страница оплаты открывается в небольшом окне по центру, на телефоне — обычным образом.
• Скрипт не отправляет запросов, не ставит cookie и не добавляет iframe. Если страница его блокирует, кнопка остаётся обычной рабочей ссылкой.

В примерах ниже замените /l/pl_… адресом своей платёжной ссылки.

Обычный HTML

<a href="https://blockwallets.io/l/pl_…" target="_blank" rel="noopener nofollow"
   style="display:inline-flex;align-items:center;height:44px;padding:0 22px;border-radius:999px;background:#1f5a3d;color:#ffffff;font:600 16px/1 sans-serif;text-decoration:none">Pay with crypto</a>

HTML + скрипт

<a href="https://blockwallets.io/l/pl_…" target="_blank" rel="noopener nofollow"
   data-blockwallets data-color="green" data-size="m" data-shape="pill">Pay with crypto</a>
<script src="https://blockwallets.io/embed.js" async></script>