Перейти к содержимому
Crypto Merchant

Основы

Оплата

Клиенты платят на страницах, размещённых у Crypto Merchant. Сайт вам не нужен: делитесь страницей оплаты или платёжной ссылкой. Если сайт есть, создавайте счета через API и направляйте клиентов на страницу счёта.

Ваша страница оплаты

У каждого магазина есть собственная страница оплаты по адресу /pay/<store>, где <store> — короткое имя вашего магазина. Клиенты могут ввести там сумму или выбрать одну из ваших платёжных ссылок. Делитесь ею везде, где общаетесь с клиентами: на сайте, в соцсетях, чатах или письмах.

Ссылку можно найти в личном кабинете в разделе Ваша страница оплаты.

Страница счёта

У каждого счёта есть собственная страница по адресу /pay/i/<invoice_id>. API возвращает эту ссылку как checkout_url. На ней клиент:

  • выбирает монету и сеть из тех, что вы принимаете;
  • видит адрес для оплаты, созданный для этого счёта, с QR-кодом, и точную сумму к отправке по курсу, зафиксированному в этот момент;
  • может переключиться на другую монету, пока платёж не обнаружен;
  • в реальном времени следит за сменой статуса: ожидание, подтверждение, оплачено.

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

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

Платёжная ссылка — это многоразовая ссылка для одного товара, услуги или пожертвования по адресу /pay/l/<link_id>. Задайте ей название и либо фиксированную сумму, либо оставьте сумму пустой, чтобы её вводил клиент. Каждый платёж по ссылке становится отдельным счётом.

Создавайте ссылки в личном кабинете в разделе Платёжные ссылки или через API.

Превью ссылок

Когда вы делитесь платёжной ссылкой или своей страницей оплаты в WhatsApp, Telegram, Instagram, X и похожих приложениях, приложение показывает карточку предпросмотра. На ней указаны название вашего магазина, ваш подтверждённый домен, если он есть, и монеты, которые вы принимаете. Для платёжной ссылки также показываются товар и его цена.

Платёжные ссылки не индексируются поисковыми системами, поэтому ссылку увидят только те, с кем вы ею поделились.

Подтверждённый домен

Если вы подтвердили домен своего сайта, ваша страница оплаты, платёжные ссылки, страницы счетов и страницы возврата показывают его рядом с названием магазина, например shop.com · подтверждён. Это говорит клиентам, что магазин на странице управляет DNS этого домена. Узнайте, как подтвердить домен.

Курсы обмена

Цены в счетах указываются в валюте, например в долларах США. Когда клиент выбирает монету, сумма в этой монете рассчитывается по текущим ценам и фиксируется. Стейблкоины, такие как USDT и USDC, считаются равными одному доллару США. Если платёж впервые замечен, пока счёт ещё открыт, применяется зафиксированный курс.

Клиенты, которые платят с биржи

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

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

Не та монета или не та сеть

Иногда клиенты платят не той монетой, которую запросил счёт, или в другой сети. Crypto Merchant отслеживает каждый адрес счёта на все поддерживаемые монеты во всех поддерживаемых сетях, где используется этот адрес, поэтому такие платежи видны.

Один EVM-адрес работает в сетях Ethereum, BNB Smart Chain, Polygon, Base и Arbitrum One, и мы храним его ключ во всех них. Поэтому USDC, отправленные в сети Base на счёт, который запрашивал USDC в сети Ethereum, всё равно попадают на адрес под нашим контролем. Каждая из сетей Tron, Bitcoin, Litecoin, Solana, TON и XRP Ledger использует свой тип адреса. В этих сетях это касается другой монеты в той же сети, например TRX, отправленного на счёт в USDT в сети Tron.

Когда платёж засчитывается автоматически

Платёж сам засчитывается в счёт, если выполнены оба условия:

  • по счёту ещё ничего не было оплачено;
  • монеты покрывают сумму счёта с учётом вашего допуска недоплаты.

Затем счёт переключается на монету, которая была фактически отправлена. Страница счёта сообщает клиенту, какой монетой он заплатил вместо запрошенной. Вы видите поле Запрошенная монета в платеже и в письме о платеже. В API coin — то, чем заплатили, а requested_coin — то, что запрашивал счёт.

Монеты оцениваются так:

  • стейблкоины, такие как USDT и USDC, засчитываются по одному доллару США за монету;
  • для той же монеты в другой сети, например ETH в сети Base для счёта в ETH в сети Ethereum, сохраняется курс, который был показан клиенту;
  • любая другая монета оценивается по рыночной цене на момент поступления.

Это работает и для поздних платежей: когда срок счёта уже истёк, но его адрес ещё отслеживается — а это не менее 24 часов.

Меньшие суммы и случайные токены

Всё остальное никогда не меняет счёт: частичная оплата другой монетой, вторая монета на счёт, по которому уже есть платёж, или случайный токен. Такое поступление зачисляется на ваш баланс как платёж без счёта, за вычетом комиссии 1 %, а обращение в поддержку сообщает вам о нём, чтобы вы могли урегулировать вопрос с клиентом. Крошечный токен, отправленный на адрес, не может перехватить счёт.

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

Что всё ещё может быть потеряно

Монеты, которые Crypto Merchant не поддерживает, или монеты в неподдерживаемой сети, а также монеты, отправленные на любой адрес, кроме адреса счёта, не могут быть засчитаны и могут быть потеряны навсегда. Клиентам всё равно следует отправлять указанную монету в указанной сети.

Недоплаченные счета

Вы задаёте допуск недоплаты в настройках; мы рекомендуем не менее 1 $. Если подтверждённому платежу не хватает не больше величины допуска, счёт считается оплаченным.

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

Переплаченные счета

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

  • Счёт считается оплаченным, а излишек хранится для клиента. Клиент может вывести его на свой кошелёк со страницы счёта за вычетом комиссии сети за отправку.
  • Пока клиент его не вывел, Crypto Merchant хранит излишек для него. Он не зачисляется на баланс продавца и никогда не удерживается в качестве комиссии.

Возвраты после оплаты

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

  • Вы можете вернуть любую сумму в пределах того, что вы получили от этого платежа: суммы, зачисленной вам после комиссии 1 %, за вычетом прежних возвратов и ещё открытых ссылок на возврат. Комиссия 1 % не возвращается.
  • Сумма сразу резервируется на вашем балансе, поэтому её нельзя тем временем по ошибке выплатить.
  • Если в платеже есть эл. почта клиента, он получит письмо с личной ссылкой. Вы также можете скопировать ссылку и отправить её сами.
  • Клиент открывает ссылку, вводит свой адрес для этой монеты и сети, отмечает подтверждение и отправляет форму. Возврат отправляется с вашего кошелька-пула, а комиссия сети вычитается из суммы возврата.
  • Ссылка действует 14 дн. Если клиент не воспользуется ею вовремя или вы её отмените, сумма автоматически вернётся на ваш баланс. Каждой ссылкой можно воспользоваться один раз.

Частичный возврат оставляет платёж в статусе Оплачен и показывает возвращённую сумму. Возврат всего, что вы получили, переводит его в статус Возвращён. При каждом получении возврата отправляется вебхук invoice.refunded, а объект счёта показывает общую сумму в refunded_amount.

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

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

Комиссии

1 % от каждого оплаченного счёта удерживается при зачислении платежа на ваш баланс. Истёкшие и отменённые счета ничего не стоят.

Дополнительной комиссии за платёж, засчитанный после поступления в другой монете или в другой сети, нет. При возврате платежа комиссия 1 % не возвращается, а комиссия сети за возврат вычитается из суммы возврата.

Сумма к оплате также включает комиссию за газ при перемещении этого платежа в ваш кошелёк-пул, но никогда не больше 5 $. В большинстве сетей это несколько центов. USDT в сети Tron обходится дороже, потому что Tron сжигает энергию при каждом переводе токена. Страница оплаты показывает комиссию рядом с ценой, а API возвращает её как network_fee_amount и network_fee_usd. Она покрывает сбор этого платежа, не является вашей выручкой, и комиссия за платёж с неё не удерживается.