Binance Smart Chain API для платежей BNB и BEP-20

Если вы искали «Binance Smart Chain RPC», вы, вероятно, ожидали URL ноды. Официальная документация на docs.bnbchain.org перечисляет публичные конечные точки JSON-RPC, и они работают. Но они оставляют сложную часть вам. Сырое RPC-соединение понимает eth_call и eth_sendRawTransaction; кодирование ABI и управление nonce происходят в вашем коде, как и обработка ключей. Публичные конечные точки также агрессивно ограничивают скорость под нагрузкой, что как раз тогда, когда ваша платёжная система нуждается в них больше всего.

Chaingateway находится на слой выше. Вы сообщаете API, какой токен отправить, сколько и кому. Он строит транзакцию и транслирует её в сеть; каждая транзакция, созданная через API, перечислена вместе с хэшем под GET /api/v2/bsc/transactions, так что вы можете направить пользователей прямо на BscScan.

Компромисс честен: если вам нужны произвольные вызовы контракта или запросы архивной глубины, запускайте ноду или используйте RPC-провайдера. Если вам нужны платежи — то есть депозиты и выплаты, — слой REST убирает большую часть кода, который вам иначе пришлось бы писать и обслуживать самостоятельно.

BSC нацелена на блоки в 0,75 секунды с хардфорка Maxwell 30 июня 2025 года, а gas остаётся дешёвым, типично от 0,1 до 1 gwei по трекеру BscScan. Стандартный перевод BEP-20 расходует от 50 000 до 65 000 gas, что при этих ценах составляет долю цента.

Факты о сети быстро устаревают, поэтому вот более полные цифры с датами. По состоянию на начало июля 2026 года:

Целевой интервал блока — 0,75 секунды. Хардфорк Maxwell установил его 30 июня 2025 года, и BscScan измерил среднее около 0,8 секунды вскоре после активации. Ранее в 2025 году хардфорк Lorentz уже уполовинил прежний трёхсекундный интервал до 1,5 секунды, так что BSC сократила своё время блока в четыре раза в течение одного года.

Gas дёшев и остаётся дёшевым. Трекер gas от BscScan держался в диапазоне 0,1–1 gwei в течение 2026 года, со средним дневным значением около 0,63 gwei в марте 2026 года. Стандартный перевод BEP-20 потребляет порядка 50 000–65 000 gas, что при этих ценах составляет примерно 0,00004 BNB. Проверьте текущую цену BNB самостоятельно перед тем, как называть клиентам комиссии, но результат годами держится в области низких центов.

Для страницы кассы практическое следствие таково: перевод USDT клиента попадает в блок примерно за секунду, а после ещё нескольких блоков, в сумме нескольких секунд, вы можете зачислить заказ. Сравните это с mainnet Ethereum, где один слот занимает 12 секунд.

Работает каждый стандартный контракт BEP-20. USDT, USDC и DAI работают из коробки, с суммами в единицах токена, а не в сырых базовых единицах. Если вы запустили собственный токен, передайте адрес его контракта тому же эндпоинту, и он будет вести себя как любой другой. Поскольку API идентичен для всех сетей, код, который вы пишете для BSC, также работает против Ethereum, Polygon или Arbitrum, как только вы поменяете сегмент сети в URL.

Комиссии в BSC сидят намного ниже mainnet Ethereum, что важно, когда вы обрабатываете много мелких платежей, а не несколько крупных. Субсекундное время блока держит кассовые потоки быстрыми. DeFi-экосистема вокруг PancakeSwap даёт BEP-20-токенам глубокую ликвидность, а сеть годами несла высокую дневную активность, так что её сценарии сбоев хорошо изучены, а инструментарий зрел.

Платёжная интеграция в BSC следует одному циклу:

1. Дайте каждому пользователю депозитный адрес. Если ваша система уже управляет ключами, зарегистрируйте их через POST /api/v2/bsc/addresses/import.
2. Прикрепите вебхук к адресу. Настройка занимает несколько минут и описана в руководстве по вебхукам.
3. Клиент отправляет USDT на адрес. Перевод попадает в блок примерно за секунду, и Chaingateway отправляет декодированное событие на вашу конечную точку.
4. Ваш сервер проверяет HMAC-подпись и зачисляет счёт. Это весь поток.

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

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

Вторая — идемпотентность. Доставка не строго однократна: неудачное уведомление, которое вы повторно отправляете через API, придёт снова целиком. Записывайте хэш транзакции каждого обработанного депозита с уникальным ограничением и позволяйте базе данных отклонять дубликаты. Логика зачисления, переживающая приход одного и того же события трижды, — это разница между механизмом повторной доставки, который вас защищает, и тем, который платит дважды.

Третья — политика подтверждений. Вебхук сообщает вам, что перевод в блоке. С блоками по 0,75 секунды десять дальнейших блоков приходят значительно быстрее десяти секунд, так что ожидание небольшого запаса безопасности почти ничего не стоит в пользовательском опыте. Для цифровой покупки на 5 USDT зачисление по уведомлению — разумное бизнес-решение. Для депозита на 50 000 USDT подождите ещё несколько секунд и перепроверьте транзакцию (GET /api/v2/bsc/transactions/{txid}), прежде чем что-либо отпускать.

Депозиты также со временем накапливаются на множестве адресов. Обычный ответ — периодическая выборка: запланированная задача, отправляющая накопленные балансы с депозитных адресов на ваш казначейский кошелёк, используя тот же вызов POST /api/v2/bsc/transactions/bep20 с депозитным адресом в поле from. Каждому выбираемому адресу нужна крупица BNB на gas, что при субgwei-ценах — округление до нуля.

Если ваша конечная точка была недоступна, пропущенные доставки не пропали: GET /api/v2/bsc/webhooks/notifications/failed перечисляет их, а POST /api/v2/bsc/webhooks/notifications/{id}/retry повторно отправляет каждую. Для сверки вы также можете перечислить всё, что API вам отправил:

curl https://app.chaingateway.io/api/v2/bsc/webhooks/notifications \
  -H "Authorization: Bearer $CHAINGATEWAY_API_KEY"

Этот единственный эндпоинт превращает вопрос «мы пропустили депозит?» из обращения в поддержку в сравнение с вашей собственной базой данных.

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

Валидируйте перед отправкой

Поток начинается до вызова API. Валидируйте адрес назначения в момент его отправки пользователем: правильная длина, префикс 0x и контрольная сумма EIP-55, если присутствуют буквы смешанного регистра. Ошибка контрольной суммы означает опечатку, и поймать её в форме ничего не стоит, а поймать после трансляции невозможно. API отклоняет некорректные адреса перед построением транзакции, но проверку контрольной суммы вам нужно выполнить самим — и к моменту, когда API ответит, пользователь уже покинул страницу.

Отслеживайте каждую выплату в вашей базе данных

Запишите выплату в вашу базу данных перед отправкой. Одна строка на выплату, со столбцом состояния: queued, sent, confirmed. Воркер забирает строки в очереди, делает ровно один вызов POST /api/v2/bsc/transactions/bep20 на строку и сохраняет ответ API рядом с ней. Хэш транзакции — ваша квитанция — появляется в GET /api/v2/bsc/transactions, списке всего, созданного через API. Покажите его пользователю как ссылку на BscScan, и он сможет наблюдать за подтверждением собственного вывода, что тихо устраняет самое частое обращение в поддержку в этой категории.

Обработка таймаутов

Важный случай сбоя — таймаут. Если ваш вызов API истёк по таймауту, вы не знаете, ушёл ли перевод. Не повторяйте вслепую. Сначала проверьте GET /api/v2/bsc/transactions и ваши собственные записи и повторяйте отправку только когда уверены, что ничего не было транслировано. Поскольку выплаты идут с горячего кошелька, держите резерв BNB на отправляющем адресе для gas; при текущих ценах BSC небольшое пополнение покрывает тысячи переводов, так что это ежемесячная рутина, а не операционный риск.

Каждый эндпоинт на этой странице работает против testnet BSC, если добавить один заголовок:

X-Network: testnet

Никакого второго аккаунта, отдельного API-ключа или изменений в коде помимо заголовка. Тестовый BNB бесплатно приходит из официального крана BNB Chain, так что вы можете отрепетировать весь цикл, от создания адреса через вебхук депозита до выплаты, без реальных средств. Форматы адресов и механика транзакций идентичны mainnet.

Стоящая репетиция — неприятная: отправьте депозит, пока ваша конечная точка вебхука отключена, восстановите её, затем повторно отправьте доставку из списка неудачных (POST /api/v2/bsc/webhooks/notifications/{id}/retry) и посмотрите, как она приходит. Подтвердите вашу обработку идемпотентности, воспроизведя уведомление против вашей же конечной точки. Десять минут преднамеренного тестирования сбоев в testnet экономят разбор инцидента в mainnet. Когда всё держится, удалите заголовок, и тот же код работает в продакшене.

Конечная точка вебхука — это дверь в вашу учётную систему, так что относитесь к ней соответственно.

Проверяйте подпись прежде, чем разбирать что-либо ещё. Задайте личный секрет в настройках профиля; с этого момента Chaingateway отправляет заголовок X-Signature с каждым уведомлением — base64 от HMAC-SHA256 по txid payload, с ключом из этого секрета. Ваш сервер пересчитывает его из полученного txid и сравнивает с постоянным временем. Запрос, не прошедший проверку, получает 4xx и никакой дальнейшей обработки, независимо от того, насколько правдоподобен его payload. Механика, включая код проверки, — в руководстве по вебхукам.

Второй, отдельный замок охраняет другое направление: в панели аккаунта вы можете ограничить ваш API-ключ IP-адресами ваших собственных серверов. Этот белый список защищает доступ к API — утёкший ключ ничего не переместит откуда-либо ещё — но не конечную точку вебхука, поэтому он дополняет подпись, а не заменяет её.

Повторное воспроизведение — это атака, которую сам по себе HMAC не останавливает, поскольку записанное валидное уведомление остаётся валидным. Ваше ограничение идемпотентности закрывает эту дыру: хэш транзакции, который уже был зачислен, подтверждается и игнорируется. Обслуживайте конечную точку только по HTTPS и держите URL вебхука свободным от секретов, потому что URL попадают в логи систем, которые вы не контролируете.

Любая интеграция рано или поздно видит ошибки, и API сообщает о них обычными HTTP-кодами статуса, так что ваши существующие паттерны обработки ошибок применимы.

401 означает, что Bearer-токен отсутствует, истёк или неверен; проверьте заголовок Authorization и ключ в вашей панели. Ошибки валидации в диапазоне 4xx, например некорректный адрес или отсутствующее поле, приходят с телом JSON, объясняющим, что исправить. Не повторяйте их: один и тот же запрос провалится тем же образом, пока payload не изменится.

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

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

Многие команды запускают полную ноду BSC ровно для одной цели: отслеживания депозитов и трансляции выплат. Эта нода стоит реальных денег и внимания. Требования к хранилищу измеряются терабайтами NVMe, первоначальная синхронизация занимает дни без снапшота, и только 2025 год принёс два хардфорка, Lorentz и Maxwell, каждый — обязательное обновление клиента к сроку. Пропустите один, и ваша нода перестаёт следовать сети, что для платёжной системы означает, что депозиты тихо перестают приходить.

Если нода существует только для платежей, путь миграции короткий. Импортируйте ваши существующие ключи через POST /api/v2/bsc/addresses/import, замените цикл опроса eth_getLogs уведомлениями вебхука и направьте код выплат на POST /api/v2/bsc/transactions/bep20. Запустите обе системы параллельно неделю и сравните результаты; список уведомлений превращает это сравнение в запрос, а не в проект. Затем выведите ноду из эксплуатации и верните бюджет на оборудование.

Если вы хотите сохранить ноду, или решаете, строить ли её вообще, наше руководство по настройке ноды Binance Smart Chain честно проходит через оборудование, синхронизацию и обслуживание. Оба подхода также комбинируются: некоторые команды держат ноду для архивных запросов и вызовов контрактов, направляя платёжный трафик через API, потому что слой вебхуков API — это как раз та часть, которую по-настоящему утомительно строить заново.

Большинство команд на эндпоинтах BSC от Chaingateway используют один из двух паттернов. Первый — приём платежей: магазин или SaaS генерирует депозитный адрес на заказ, ждёт вебхука и отгружает продукт, с расчётом за секунды вместо банковских дней. Второй — операции с кошельками в масштабе: биржи и платформы, отслеживающие депозиты и обрабатывающие выводы на тысячах пользовательских адресов, всё через ту же горстку эндпоинтов.

Те же строительные блоки покрывают запуски токенов (airdrop и выплаты по вестингу, скриптованные как переводы BEP-20), трансграничные переводы, где банковский перевод занял бы дни, регулярные выплаты для биллинга по подписке и DeFi-продукты, которым нужно видеть транзакции в момент подтверждения.

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