# Документация blockwallets: способы интеграции > Выберите способ интеграции: платёжные ссылки, POS и кнопки без кода; API, совместимый с Cryptomus, или собственный REST API; совместимые API для Cryptomus, NOWPayments и Coinbase Commerce; промпты для ИИ, AGENTS.md и MCP. > > HTML: https://blockwallets.io/docs?lang=ru · English: https://blockwallets.io/docs.md?lang=en ## Документация blockwallets принимает USDT и USDC, а также BTC, LTC и родные монеты сетей (зачисляются в долларах США по зафиксированному курсу). Любая из интеграций ниже создаёт одинаковый счёт на одной и той же странице оплаты, с теми же подтверждениями, комиссиями и балансом; различается только то, как ваша система общается с нами. Выберите подходящую и перейдите на её страницу. ### Выберите способ интеграции Сгруппировано по тому, с чего вы начинаете. Каждая карточка открывает полное руководство. #### Без кода Принимайте платежи прямо из кабинета продавца; ничего устанавливать не нужно. - [Платёжные ссылки](https://blockwallets.io/docs?lang=ru#links): Введите сумму (или дайте плательщику ввести её) и поделитесь ссылкой или QR-кодом. Каждый переход создаёт новый счёт. - [POS для магазинов](https://blockwallets.io/docs?lang=ru#pos): Сотрудник открывает POS-ссылку на телефоне или планшете и вводит сумму, а клиент сканирует QR-код. - [Кнопка для сайта](https://blockwallets.io/docs?lang=ru#embed): Вставьте кнопку «Оплатить» или «Поддержать» на любой сайт: обычный HTML или HTML с одним тегом script. #### Новая интеграция по API Вы пишете интеграцию с нуля. - [Собственный REST API](https://blockwallets.io/docs/api?lang=ru): Ключ Bearer, суммы в центах, идемпотентный `ref`, вебхуки HMAC-SHA256 и API событий. Ключи создаются самостоятельно в кабинете. - [API, совместимый с Cryptomus](https://blockwallets.io/docs/cryptomus?lang=ru): POST + JSON с подписью md5. Учётные данные создаются в кабинете самостоятельно, у каждого основного эндпоинта есть панель «Попробовать». #### Переход с другого шлюза Код остаётся прежним: API совместимы, поэтому меняются только базовый URL и ключи. - [С Cryptomus](https://blockwallets.io/docs/cryptomus?lang=ru#cryptomus): Замените `https://api.cryptomus.com` на `https://blockwallets.io` и используйте новые merchant и API key. Пути, параметры, `sign` и вебхуки остаются прежними. - [С NOWPayments](https://blockwallets.io/docs/nowpayments?lang=ru): Замените `https://api.nowpayments.io/v1` на `https://blockwallets.io/nowpayments/v1` и используйте новые API key и IPN secret. `x-nowpayments-sig` остаётся прежним. - [С Coinbase Commerce](https://blockwallets.io/docs/coinbase-commerce?lang=ru): Укажите `https://blockwallets.io/coinbase/` как базовый URL SDK и используйте новые API key и webhook shared secret. `X-CC-Webhook-Signature` остаётся прежним. #### Пусть интегрирует ИИ Для тех, кто не пишет код, но пользуется ИИ-инструментом для программирования. - [Генератор промптов](https://blockwallets.io/docs/ai?lang=ru): Выберите сайт, способ оплаты и ИИ-инструмент; скопируйте готовый промпт для Claude Code, Codex, Cursor или ChatGPT. - [AGENTS.md](https://blockwallets.io/agents.md): Правила интеграции, частые ошибки и чек-лист приёмки; сохраните в корне проекта для агентов-программистов. - [MCP-сервер](https://blockwallets.io/docs/mcp?lang=ru): Позвольте ИИ-инструменту искать по этой документации и напрямую создавать тестовые счета. #### Инструменты Помощь в отладке прямо в браузере. - [Проверка подписи](https://blockwallets.io/docs/sign?lang=ru): Вставьте тело запроса или вебхука и увидите каждый шаг подписи и место, где ваш результат отличается. API key не покидает ваш браузер. ### Совместимый с Cryptomus или собственный? Оба создают одинаковые счета на одной странице оплаты, с теми же комиссиями и балансом. Различаются стиль запросов, формат вебхуков и способ получения учётных данных. | | Совместимый с Cryptomus | Собственный REST | | --- | --- | --- | | Учётные данные | Создаются самостоятельно в кабинете, в разделе «Разработчикам › Интеграция и ключи» (один набор для Live и один для Test) | Тоже создаются самостоятельно в кабинете, в разделе «Разработчикам › Интеграция и ключи»: ключ Live и ключ Test (`bw_live_…` / `bw_test_…`) и секреты подписи их вебхуков | | Запросы | Каждый вызов — `POST` + JSON, с заголовками `merchant` и `sign` = `md5(base64(тело запроса) + API key)` | REST (`GET` / `POST`) с `Authorization: Bearer`; префикс ключа определяет Live или Test | | Суммы | Десятичные строки вида `"42.00"`, в USD, USDT или USDC (все 1:1) | Целые числа в центах США, например `4200`; только USD | | Повторы | Тот же `order_id` возвращает существующий счёт | Тот же `ref` с теми же параметрами возвращает существующий счёт; другие параметры дают 409 | | Вебхуки | Отправляются на `url_callback` каждого счёта; подпись — поле `sign` в теле | Отправляются на URL вебхука из кабинета; `X-BW-Signature` = HMAC-SHA256 с меткой времени; список и повторная отправка через `/v1/events` | | Статические адреса | `/v1/wallet`: одна сеть за вызов | `/v1/deposit-accounts`: сразу все сети для одного клиента | | Инструменты | Панели «Попробовать», проверка подписи, промпты для ИИ и MCP-сервер; существующие SDK и плагины Cryptomus работают | Этот справочник и примеры кода | Начинаете с нуля? Берите нативный REST API: суммы в центах, идемпотентный `ref`, подпись вебхуков с меткой времени и ключи, которые вы создаёте сами в кабинете. Уже работаете с Cryptomus или хотите использовать готовый SDK или плагин Cryptomus? Берите API, совместимый с Cryptomus. ### Быстрый старт От нуля до тестового платежа за пять шагов (для API, совместимого с Cryptomus; остальные API проходят те же шаги со своими учётными данными). - Запросите доступ на [главной странице](https://blockwallets.io/?lang=ru#join). После одобрения войдите в [кабинет продавца](https://blockwallets.io/dashboard). - Откройте в кабинете «Разработчикам › Интеграция и ключи», создайте merchant и API key в колонке Test и добавьте домены своего сайта. - Ваш сервер создаёт счёт через `POST /v1/payment` и перенаправляет клиента на `result.url`. - Оплатите его кнопкой «Симулировать оплату» на странице оплаты, затем убедитесь, что обработчик вебхука проверяет `sign` и зачисляет по `payment_amount_usd`. - Переключитесь на учётные данные из колонки Live и один раз оплатите небольшую настоящую сумму («Пробный платёж» на главной странице кабинета). ```http POST https://blockwallets.io/v1/payment 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](https://blockwallets.io/docs/cryptomus?lang=ru#api); если хотите поручить это ИИ, начните с [генератора промптов](https://blockwallets.io/docs/ai?lang=ru). ### Платёжные ссылки (без кода) Кабинет продавца → «Платежи › Платёжные ссылки» → введите описание и сумму (зафиксируйте сеть или дайте клиенту выбрать) → создайте. У каждой ссылки есть URL и QR-код. - Каждое открытие ссылки создаёт новый счёт, поэтому одну ссылку можно использовать многократно (например, «Членство $99»). - Каждый платёж виден в разделе «Платежи › Транзакции»; выводите деньги на свой кошелёк в разделе «Средства › Баланс и вывод». - Если вы создали учётные данные и URL вебхука в разделе «Разработчикам › Интеграция и ключи», о платежах по ссылкам тоже приходят уведомления — в [формате вебхуков, совместимом с Cryptomus](https://blockwallets.io/docs/cryptomus?lang=ru#webhooks). - Чтобы прекратить приём, нажмите «Отключить» — ссылка перестанет работать сразу. ### POS для магазинов Для касс и прилавков: кабинет продавца → «Платежи › POS-касса» → откройте терминал и получите POS-ссылку. Сотрудник открывает её на телефоне или планшете, вводит сумму, и появляется QR-код для оплаты; когда клиент платит, на экране появляется «Paid». - Счёт POS действует 30 минут. Платежи поступают на ваш баланс и отображаются в разделе «Платежи › Транзакции», а уведомления приходят на URL вебхука так же, как для платёжных ссылок. - POS-ссылка позволяет только принимать платежи: она не показывает баланс, выводы, другие заказы, настройки и учётные данные. - Потеряли устройство или сотрудник уволился? Отзовите этот терминал в кабинете, и его ссылка сразу перестанет работать. ### Кнопка для сайта Кабинет продавца → «Платежи › Платёжные ссылки» → «Кнопка для сайта»: выберите текст, цвет, размер и форму и скопируйте код. Нажатие на кнопку открывает страницу оплаты этой платёжной ссылки. - Обычный HTML: одна оформленная ссылка без скрипта, поэтому работает везде, где можно вставить HTML (конструкторы сайтов, форумы, подписи в письмах). - Со скриптом: добавьте `data-blockwallets` и один тег `/embed.js`; на компьютере страница оплаты открывается в небольшом окне по центру, на телефоне — обычным образом. - Скрипт не отправляет запросов, не ставит cookie и не добавляет iframe. Если страница его блокирует, кнопка остаётся обычной рабочей ссылкой. В примерах ниже замените `/l/pl_…` адресом своей платёжной ссылки. #### Обычный HTML ```html Pay with crypto ``` #### HTML + скрипт ```html Pay with crypto ```