Сценарии использования

Принимайте криптоплатежи в интернет-магазине без плагина

Интернет-магазин принимает криптовалюту с Crypto Merchant, создавая один счёт на заказ через REST API и отправляя клиента на размещённую у нас страницу оплаты этого счёта. Клиент выбирает монету, платит точную сумму по курсу, зафиксированному для этого счёта, а ваш сервер отправляет заказ, когда приходит подписанный вебхук invoice.paid. Комиссия — 1 % с оплаченного счёта. Плагина для WooCommerce, Shopify или Magento нет: интеграция — это один вызов API и один эндпоинт для вебхуков.

Обновлено 6 ноября 2026 г.

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

Кратко

Тема	Как это работает
Как платят клиенты	На размещённой у нас странице счёта: они выбирают монету и сеть из тех, что вы принимаете, видят точную сумму и адрес для оплаты, созданный для этого счёта, с QR-кодом и обратным отсчётом.
Что вы делаете	Один вызов `POST /invoices`, когда клиент выбирает криптовалюту, и один HTTPS-эндпоинт для вебхуков. Любой язык или фреймворк, способный отправить HTTPS-запрос.
Когда отправлять заказ	По событию `invoice.paid`, когда у платежа есть нужные подтверждения. Никогда по `invoice.confirming`.
Неверные суммы	Платёж, которому не хватает не больше вашего допуска, считается оплатой. Если не хватает больше, счёт становится `underpaid`: клиент может доплатить или забрать отправленное. Переплата всё равно считается оплатой, а излишек хранится для клиента.
Валюта цен	По умолчанию доллары США или другая поддерживаемая валюта, например EUR, GBP, TRY или BRL; сумма в монете рассчитывается по текущим ценам, когда клиент выбирает монету.
Плагины	Нет. Описанный ниже порядок работает с любой корзиной или собственным оформлением заказа, которые могут вызывать API.

Как это работает, шаг за шагом?

С момента, когда клиент выбирает «Оплатить криптовалютой», до отправки заказа с вашего склада:

1
Создайте счёт при оформлении заказа
Когда клиент выбирает криптовалюту, ваш сервер вызывает POST /invoices с суммой заказа, вашим order_id, эл. почтой клиента, redirect_url обратно на вашу страницу благодарности и любыми metadata, которые вы хотите получить обратно. В ответ приходит счёт с checkout_url.
2
Отправьте клиента на страницу счёта
Перенаправьте на checkout_url. На странице перечислены монеты, которые вы принимаете; когда клиент выбирает одну из них, сумма в этой монете рассчитывается по текущим ценам и фиксируется, а адрес для оплаты, созданный для этого счёта, показывается с QR-кодом. Счёт остаётся открытым столько, сколько вы задали, по умолчанию 30 минут.
3
Получайте подписанные вебхуки
Ваш эндпоинт получает invoice.confirming, когда платёж замечен в блокчейне, и invoice.paid, когда у него достаточно подтверждений. Проверьте заголовок CM-Signature, сохраните событие, ответьте 2xx в течение 10 секунд, затем отпустите заказ по сохранённой копии. События могут приходить дважды: используйте id события, чтобы отправить заказ один раз.
4
Обработайте три особых случая
invoice.expired: платёж не пришёл вовремя, предложите новый счёт. invoice.underpaid: клиент может отправить остаток на тот же адрес или получить возврат со страницы счёта. Переплаченный счёт всё равно оплачен; излишек хранится для клиента, который может вывести его со страницы счёта.
5
Получите выплату
Подтверждённые платежи зачисляются на ваш баланс за вычетом 1 % и собираются в кошелёк-пул вашего бизнеса. Выводите средства в любое время на собственные адреса, каждую монету как есть или всё с обменом на одну монету хранения.

Единственный нужный вызов API

Создать счёт при оформлении заказа

curl https://cryptomerchant.online/api/v1/invoices \
  -H "Authorization: Bearer $CM_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "64.00",
    "currency": "USD",
    "order_id": "ORD-20931",
    "description": "Order ORD-20931",
    "customer_email": "[email protected]",
    "redirect_url": "https://yourstore.example/orders/20931/thanks",
    "metadata": { "cart": "20931" }
  }'

# 201 → { "id": "inv_…", "status": "open", "checkout_url": "https://cryptomerchant.online/pay/i/inv_…", … }
# Send the customer to checkout_url. Ship on the "invoice.paid" webhook.

Сколько это стоит?

1 % с каждого оплаченного счёта, удерживается при зачислении платежа на ваш баланс. Нет платы за настройку, ежемесячной платы и платежа за активацию; истёкшие и отменённые счета ничего не стоят. За перемещение монет (сбор, обмен и выплаты) взимается комиссия за газ — с вашего баланса газа, если вы его пополнили, иначе из перемещаемых монет. Клиенты также платят комиссию за газ по каждому счёту: она добавляется к отправляемой сумме, показывается на странице оплаты и никогда не превышает 5 $. Курсы обмена включают сервисную наценку 1 %. Все расходы собраны в одной таблице на странице Цены.

Чего Crypto Merchant здесь не делает

Нет плагина для магазина. Модуля для WooCommerce, Shopify, Magento, PrestaShop или OpenCart нет. Вы сами добавляете вызов API или делитесь своей страницей оплаты и платёжными ссылками.
Нет автоматических возвратов и нет вызова возврата в API. Подтверждённый криптоплатёж окончателен, поэтому возврат — это новый перевод. При возврате товара администратор создаёт приватную ссылку на возврат из оплаченного платежа в личном кабинете; клиент вводит свой адрес, комиссия сети вычитается из суммы возврата, а комиссия 1 % не возвращается.
Кастодиальный, только криптовалюта. Crypto Merchant хранит ключи до вашей выплаты, а выплаты идут на ваши собственные адреса кошельков, а не на банковский счёт.

Кому это подходит?

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

Частые вопросы

Есть ли плагин Crypto Merchant для WooCommerce или Shopify?

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

Сколько времени занимает подтверждение криптоплатежа?

Зависит от сети. У каждой сети заданное число подтверждений, указанное в разделе «Монеты и сети». Стейблкоины в сетях Tron, Solana, BNB Smart Chain, Polygon, Base и Arbitrum обычно подтверждаются за несколько минут; Bitcoin требует 2 подтверждения, обычно около 20 минут.

Что будет, если клиент заплатит неверную сумму?

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

Нужен ли клиенту аккаунт в Crypto Merchant?

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

Могу ли я назначать цены заказов в евро или другой валюте?

Да. Счета по умолчанию выставляются в долларах США, а поле валюты принимает другие поддерживаемые валюты, например EUR, GBP, TRY или BRL. Сумма в монете рассчитывается по текущим ценам, когда клиент выбирает монету.

Другие сценарии

Все сценарии использования

Начните принимать криптовалюту сегодня

Бесплатная настройка, регистрация без документов, 1 % с оплаченного счёта и выплаты, когда захотите.

Создать аккаунт Читать документацию