Как принимать криптоплатежи в BNB Chain: руководство для продавцов

Чтобы принимать криптоплатежи в BNB Chain, недостаточно опубликовать адрес кошелька. Надежный процесс должен однозначно указывать сеть и актив, запрашивать правильную сумму, распознавать перевод, дожидаться подходящего статуса платежа и связывать платеж с одним заказом, не исполняя его дважды.

Основная сеть BNB Smart Chain совместима с EVM и имеет идентификатор сети 56. Ее нативный актив BNB используется для оплаты газа. Знакомая архитектура EVM делает сеть доступной для пользователей многих кошельков, но одновременно создает серьезный риск при оплате: одинаково выглядящий адрес 0x может использоваться в Ethereum и нескольких других сетях. Клиент способен отправить настоящий токен на действительный адрес, но выбрать для заказа не ту сеть.

В этом руководстве рассказано, как принимать BNB, USDT и другие поддерживаемые активы в BNB Chain, контролируя риски, связанные с контрактами токенов, подтверждениями, вебхуками, возвратами и бухгалтерским учетом. Прежде чем предлагать какую-либо комбинацию, убедитесь, что именно этот токен и эта сеть доступны в настройках вашего действующего аккаунта после входа. На общедоступной странице Yolfi о BNB Chain описаны возможности продукта, однако публичная или автоматически созданная страница не доказывает, что каждый актив доступен для любого аккаунта.

Какие данные должен определять платеж в BNB Chain

BNB Smart Chain, которую часто сокращенно называют BSC, — это сеть смарт-контрактов в экосистеме BNB Chain. В официальной документации BNB Smart Chain она описана как платформа для децентрализованных приложений, а в официальном введении в BSC указаны совместимость с EVM и роль BNB в оплате газа.

Полноценный платежный запрос продавца должен содержать следующие поля:

Сеть и актив вместе образуют один способ оплаты. Указания «USDT» недостаточно, а «USDT в BNB Chain» уже позволяет совершить платеж. Фраза «отправьте на этот адрес 0x» тоже неполна, поскольку формат адреса EVM не сообщает кошельку, какую сеть нужно использовать.

Когда стоит выбрать BNB Chain

BNB Chain стоит протестировать, если клиенты уже хранят в ней BNB или стейблкоины, могут выводить средства в эту сеть с привычной биржи и пользуются совместимыми кошельками. Она может подойти для тарифов SaaS, цифровых товаров, счетов агентств, платных сообществ и других онлайн-продуктов, рассчитанных на активную криптовалютную аудиторию. Совместимые с EVM инструменты, поддержка BEP-20, прозрачность обозревателя блокчейна и потенциально невысокая стоимость транзакций могут быть преимуществами, но не гарантируют фиксированную комиссию.

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

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

Выбор между BNB и стейблкоинами

Первое операционное решение — какой актив в BNB Chain принимать.

Прием нативного BNB

Платежи в BNB подходят клиентам, которые уже хранят BNB в BNB Smart Chain, и компаниям, которые намеренно устанавливают цены в BNB. В этом процессе BNB выполняет две функции: служит активом для оплаты покупки и используется для оплаты сетевой комиссии.

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

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

Прием USDT или другого стейблкоина

Стейблкоин, привязанный к доллару, упрощает понимание счета, выставленного в долларах. Например, при использовании USDT не нужно менять отображаемую цену при каждом колебании курса BNB. В руководстве по приему платежей в USDT объясняется, как один и тот же тикер может существовать в нескольких сетях.

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

На общедоступной странице Yolfi о BNB Chain сейчас упоминаются нативный BNB, USDC, USDT и другие основные стейблкоины. Используйте это как общую информацию о продукте, а затем проверьте точные варианты в своем авторизованном аккаунте. Не заявляйте, что принимаете любой токен BEP-20, лишь потому, что технически любой токен можно перевести на адрес.

Краткое сравнение BNB и стейблкоинов

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

Разберитесь в контрактах BEP-20 до подключения токенов

BEP-20 — интерфейс токенов, широко используемый в BNB Smart Chain. Для приема платежей ключевым идентификатором служит адрес контракта, а не название, логотип или тикер токена.

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

Перед подключением актива BEP-20:

1. Запишите точное название токена и вариант BNB Chain из рабочих настроек продавца.
2. Получите контракт из официального источника эмитента токена.
3. Посимвольно сравните его с поддерживаемым контрактом.
4. Проверьте количество знаков после запятой и отображение перевода по надежным данным контракта или обозревателя блокчейна.
5. Проведите платеж на небольшую сумму тем же способом, которым будут пользоваться клиенты.
6. Убедитесь, что в платежной записи распознан именно этот контракт.
7. Опишите порядок действий службы поддержки при получении другого токена или токена-двойника.

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

Понятно объясните оплату газа в BNB

Для обычной транзакции в BNB Smart Chain требуется BNB для оплаты газа. Это относится и к платежам BEP-20: у клиента может быть достаточно USDT для оплаты счета, но без BNB в этой сети кошелек не сможет отправить токены.

Разделяйте следующие суммы:

• сумму, которую должен получить продавец;
• сетевую комиссию в BNB, рассчитанную кошельком;
• любую отдельную комиссию поставщика услуг или компании, указанную на странице оплаты.

При запросе на 80 USDT сообщите клиенту, что нужно отправить 80 USDT и оставить в кошельке отправителя достаточно BNB для оплаты газа. Не предлагайте вычитать комиссию, выраженную в BNB, из суммы в USDT.

Пишите «для оплаты газа требуется BNB в BNB Smart Chain», а не просто «вам нужен BNB». Баланс, относящийся к другой сети или продукту, может быть недоступен для оплаты газа в BSC. Не публикуйте постоянную оценку комиссии или гарантированное время подтверждения: условия проведения платежей и правила управления рисками могут меняться.

Как настроить платежи в BNB Chain

1. Проверьте доступные комбинации токена и сети

Откройте настройки аккаунта продавца после входа и запишите все комбинации с BNB Chain, которые собираетесь предложить. Проверьте не только страницу настроек, но и реальный экран оплаты для клиента. Если BNB, USDT, USDC или другой актив там недоступен, не предлагайте этот способ оплаты.

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

2. Настройте подконтрольный компании кошелек

Используйте совместимый с BNB Smart Chain расчетный кошелек, который находится под контролем компании согласно ее внутренним правилам. Независимо проверьте адрес назначения до публикации способа оплаты. Определите:

• кто может просматривать или менять расчетный адрес;
• как защищаются и резервируются закрытые ключи или устройства для подписи;
• требуется ли второй согласующий для изменений с высоким риском или возвратов;
• как регистрируются и тестируются изменения адреса;
• как компания поддерживает достаточный запас BNB для одобренных исходящих транзакций;
• как финансовый отдел отделяет балансы в BNB Chain от похожих активов в других сетях.

Yolfi описывает свой процесс приема платежей в BNB Chain как модель без хранения средств поставщиком: средства отправляются напрямую в кошелек продавца. Прямое зачисление исключает этап вывода средств от поставщика услуг, но управление ключами, доступом к кошельку, возвратами и активами остается обязанностью продавца.

3. Выберите платежные ссылки или встроенный процесс оплаты

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

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

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

На общедоступной странице Yolfi о BNB Chain сейчас описаны платежные ссылки, регулярные платежи, платежные события, вебхуки и прямое зачисление в кошелек. Если продукту подходит регулярный биллинг, изучите криптовалютные подписки, а затем проверьте, какой именно актив в BNB Chain доступен в интерфейсе после входа в аккаунт. Не считайте, что регулярный платеж означает автоматическое списание с кошелька. Для фактической реализации определите правила напоминаний о продлении, сроков оплаты, льготных периодов, отмены, изменения доступа и обработки повторных событий.

4. Сделайте выбор сети максимально заметным

Повторяйте «BNB Smart Chain» или «BNB Chain» рядом с активом, суммой, QR-кодом и кнопкой перехода в кошелек. Указывайте идентификатор сети 56 в настройках кошелька или технической справке, но не заставляйте клиентов ориентироваться только на число.

Понятный текст на странице оплаты может выглядеть так:

• «Отправьте 80 USDT в BNB Smart Chain».
• «Используйте только основную сеть BNB Smart Chain (идентификатор сети 56)».
• «Для оплаты сетевой комиссии требуется BNB в BNB Smart Chain».
• «Не отправляйте этот токен через Ethereum или другую сеть».

Если продукт поддерживает несколько сетей, требуйте явно выбрать сеть до открытия кошелька. Не устанавливайте BNB Chain без предупреждения, показывая только символ токена. В руководстве для продавцов по предотвращению криптоплатежей через неверную сеть подробнее описаны меры на странице оплаты и сбор данных при разборе инцидента.

5. Протестируйте весь путь клиента

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

1. на странице оплаты указаны и токен, и BNB Chain;
2. кошелек использует основную сеть с идентификатором 56;
3. адрес назначения и запрошенная сумма совпадают;
4. при оплате токеном используется ожидаемый контракт BEP-20;
5. газ в BNB показывается отдельно;
6. после отправки платеж получает статус ожидания, а заказ не исполняется немедленно;
7. система заказов получает нужный подтвержденный статус;
8. повторная доставка вебхука не приводит к повторному исполнению заказа;
9. финансовый отдел может найти поступление в расчетном кошельке и обозревателе блокчейна;
10. контролируемая процедура возврата работает.

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

Подтверждайте платежи, не исполняя заказ дважды

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

Приемочная проверка продавца должна подтверждать:

• основную сеть BNB Smart Chain с идентификатором 56;
• запрошенный нативный актив или точный контракт BEP-20;
• настроенный адрес назначения;
• сумму, требуемую правилами заказа;
• обязательный подтвержденный статус в платежной системе;
• отсутствие привязки транзакции к другому заказу;
• отсутствие ранее исполненного заказа.

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

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

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

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

Подготовьтесь к исключениям, возвратам и сверке операций

Установите правила для исключительных ситуаций до первого платежа клиента:

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

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

Для бухгалтерского учета и сверки храните:

• идентификаторы заказа, счета, клиента и платежного запроса;
• сеть, нативный актив или токен и контракт токена;
• запрошенную и полученную суммы;
• стоимость в базовой валюте, источник курса и время оценки;
• адрес назначения и хеш транзакции;
• время создания запроса, обнаружения платежа, подтверждения и исполнения заказа;
• комиссии, учтенные компанией;
• историю статусов, исключения, возвраты и корректирующие транзакции.

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

Часто задаваемые вопросы

Как принимать криптоплатежи в BNB Chain?

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

Какой идентификатор у основной сети BNB Smart Chain?

Основная сеть BNB Smart Chain использует идентификатор 56. В официальной документации по настройке кошелька BNB также указан как символ сети. Используйте идентификатор 56 для проверки конфигурации, но при этом четко показывайте клиентам название сети.

Нужен ли клиентам BNB, чтобы отправить USDT в BNB Chain?

Для обычного перевода BEP-20 — да. В кошельке отправителя должен быть BNB в BNB Smart Chain для оплаты газа. Баланс для газа отделен от суммы USDT, которую запрашивает продавец.

Можно ли принимать любой токен BEP-20?

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

BNB Chain и Ethereum — это одна сеть?

Нет. BNB Smart Chain совместима с EVM, поэтому адреса и инструменты могут выглядеть знакомо, но это отдельная сеть с идентификатором 56, где газ оплачивается в BNB. Транзакция, отправленная через Ethereum, не становится платежом в BNB Chain.

Платежи в BNB Chain проходят мгновенно и сразу становятся окончательными?

Не обещайте этого. Отправка, включение в блок, подтверждение и принятие платежа компанией — разные статусы. Используйте подтвержденный статус платежного процесса и правила управления рисками, подходящие для заказа, вместо гарантий фиксированного времени или числа подтверждений.

Что выбрать: BNB или стейблкоин?

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

С чего начать: с платежных ссылок или интеграции процесса оплаты?

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

Можно ли вернуть платеж в BNB Chain?

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

Заключение

Самый безопасный способ принимать криптоплатежи в BNB Chain — считать каждую пару актива и сети отдельным контролируемым способом оплаты. Проверьте доступность варианта в рабочих настройках, используйте идентификатор сети 56, сверяйте каждый контракт BEP-20 с официальным источником эмитента и сообщайте клиентам, что газ оплачивается в BNB в сети BNB Smart Chain.

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