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

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

Arbitrum One использует привычные EVM-кошельки и адреса 0x, но это сходство может скрывать ошибки. Клиент может выбрать Ethereum, Base, Arbitrum Nova или другую совместимую сеть и по-прежнему видеть адрес, который выглядит корректным. Перевод действительно произойдет, но заказ в Arbitrum One оплачен не будет.

В этом руководстве описаны меры, которые позволяют надежно принимать платежи в Arbitrum One: настройка кошелька, работа с нативным и перенесенным через мост USDC, ETH для газа, обозначения на странице оплаты, правила подтверждения, идемпотентность вебхуков, возвраты и финансовый учет. На общедоступной странице платежей в Arbitrum Yolfi рассказывает о платежных ссылках, регулярных платежах, событиях и вебхуках, а также о прямом зачислении средств на кошелек продавца без их хранения посредником. Рассматривайте это как перечень возможностей продукта, а перед запуском обязательно проверьте точные сочетания активов и сетей в своей учетной записи.

Начните с точного выбора сети Arbitrum

«Arbitrum» может означать всю экосистему, а не единственную сеть для платежа. В этом руководстве рабочей сетью считается основная сеть Arbitrum One.

В официальном кратком руководстве по мосту Arbitrum указаны основные параметры кошелька:

Полный платежный запрос должен содержать не только адрес получателя. Сохраняйте:

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

Не сокращайте инструкцию для клиента до «отправьте через Arbitrum», если система ожидает именно Arbitrum One. У Arbitrum Nova и тестовых сетей Arbitrum другие идентификаторы. Один лишь EVM-адрес не позволяет увидеть это различие.

Определите, подходит ли Arbitrum One вашим клиентам

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

Важно не только то, способна ли сеть обрабатывать переводы токенов. Необходимо оценить весь путь клиента и продавца:

• Есть ли у клиентов нужный актив в Arbitrum One?
• Могут ли они выбрать Arbitrum One при выводе с биржи?
• Показывает ли кошелек сеть и контракт токена достаточно ясно?
• Сможет ли служба поддержки разобраться с переводом через неверную сеть или в неверном токене?
• Сможет ли финансовый отдел оценить актив и провести сверку?
• Сможет ли компания безопасно выполнять возвраты и переводы собственных средств?

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

Выберите актив до создания страницы оплаты

Поддержка сети и поддержка актива — разные вещи. Возможность кошелька работать с Arbitrum One не означает, что ваша платежная система принимает любой токен в этой сети.

Нативный USDC в Arbitrum One

USDC может стать удобным исходным активом для товаров и услуг с ценой в долларах США: запрошенную сумму в токенах проще понять, чем постоянно меняющуюся котировку в ETH. Однако сохраняются риски, связанные с эмитентом, контрактом, отклонением от привязки к доллару, регулированием, кошельком и сетью.

В официальном каталоге контрактов USDC Circle для нативного USDC в Arbitrum указан адрес:

0xaf88d065e77c8cC2239327C5EDb3A432268e5831

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

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

Нативный USDC и перенесенный через мост USDC не взаимозаменяемы

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

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

Контрольный список для безопасного запуска USDC:

1. Убедитесь, что в вашей учетной записи доступен нужный способ оплаты USDC в Arbitrum One.
2. Сохраните поддерживаемый контракт токена в настройках платежа.
3. Сопоставьте нативный USDC с актуальным каталогом контрактов Circle.
4. Дайте клиенту однозначное обозначение, например «Нативный USDC в Arbitrum One».
5. Выполните перевод небольшой суммы из кошельков, которыми, вероятнее всего, будут пользоваться клиенты.
6. Проверьте, что USDC.e или токен с другим контрактом отклоняется либо направляется на ручную проверку.
7. Подготовьте для службы поддержки письменный порядок действий при несовпадении контрактов.

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

ETH и другие токены

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

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

Объясняйте оплату газа в Arbitrum, не обещая фиксированную комиссию

При обычной транзакции в Arbitrum One отправитель платит за газ в ETH, находящемся в Arbitrum One. У клиента может быть достаточно USDC для оплаты счета, но не быть ETH для отправки перевода токенов.

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

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

Если в счете запрошено 60 USDC, клиент должен отправить 60 USDC и иметь дополнительные ETH в Arbitrum One для оплаты газа. Не следует вычитать комиссию в ETH из суммы в USDC.

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

В подсказке клиенту следует написать: «Для оплаты газа требуется ETH в Arbitrum One». ETH, находящийся только в основной сети Ethereum или другой сети, не подойдет для оплаты комиссии за транзакцию в Arbitrum One. Если ваш рабочий процесс использует иной механизм оплаты газа, покрытие комиссии или абстракцию, описывайте фактическое поведение в вашей учетной записи, а не исходите из обычной модели перевода.

Настройте процесс приема платежей

1. Проверьте фактическую доступность

Войдите в учетную запись продавца и проверьте как экран настроек, так и клиентскую страницу оплаты. Запишите точный список активов Arbitrum One, доступных вашей учетной записи. Если нужного токена и сети нет, не заявляйте об их поддержке.

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

2. Настройте контролируемый кошелек для получения средств

Используйте совместимый с Arbitrum One кошелек, управление которым соответствует правилам компании. Независимо проверьте адрес назначения до начала приема платежей. Определите:

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

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

3. Выберите платежные ссылки, встроенную оплату или регулярный доступ

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

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

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

4. Устраните неоднозначность на странице оплаты

Указывайте сеть рядом с токеном, суммой, QR-кодом и кнопкой кошелька. Полезные инструкции:

• «Отправьте 60 нативных USDC в Arbitrum One».
• «Используйте только основную сеть Arbitrum One (идентификатор сети 42161)».
• «Для оплаты сетевой комиссии потребуется ETH в Arbitrum One».
• «Не отправляйте USDC.e или USDC из другой сети».

Если доступно несколько сетей, требуйте сделать явный выбор до открытия кошелька. Не показывайте только «USDC», незаметно выбирая Arbitrum One. В подробном руководстве по предотвращению криптоплатежей через неверную сеть описаны меры профилактики, сбор сведений и реагирование на такие случаи.

5. Проведите реальный платеж небольшой суммы

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

1. на странице указаны Arbitrum One и точный актив;
2. в кошельке выбрана сеть с идентификатором 42161;
3. адрес назначения и сумма совпадают с платежным запросом;
4. для нативного USDC используется ожидаемый контракт Circle;
5. плата за газ в ETH указана отдельно;
6. после отправки платеж получает состояние ожидания, а заказ не исполняется мгновенно;
7. нужное подтвержденное состояние передается в систему заказов;
8. повторное событие не приводит к повторному исполнению заказа;
9. финансовый отдел может сопоставить запрос, транзакцию, поступление на кошелек и заказ;
10. контролируемая процедура возврата выполняется полностью.

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

Рассматривайте подтверждение и окончательность как правило, а не лозунг

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

Прежде чем принять платеж, убедитесь, что:

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

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

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

Обеспечьте безопасную повторную обработку вебхуков

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

Сохраняйте как минимум:

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

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

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

Определите порядок обработки исключений и платежей через неверную сеть

Сформулируйте правила до того, как служба поддержки получит первое обращение по спорному платежу:

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

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

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

Спланируйте возвраты и сверку до запуска

Возврат в Arbitrum One — это новая исходящая транзакция, а не отмена первоначального поступления. Перед отправкой:

1. проверьте исходный заказ и подтвержденный платеж;
2. подтвердите одобренные актив и сумму возврата;
3. подтвердите личность клиента и адрес назначения через контролируемый канал;
4. укажите, кто оплачивает сетевую комиссию;
5. получите необходимое внутреннее согласование;
6. убедитесь, что на подписывающем транзакцию кошельке есть нужный токен и ETH в Arbitrum One;
7. отдельно зафиксируйте исходящую транзакцию.

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

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

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

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

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

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

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

Какой идентификатор сети у Arbitrum One?

Основная сеть Arbitrum One использует идентификатор 42161. В официальном кратком руководстве Arbitrum символом ее валюты указан ETH. Используйте идентификатор сети для проверки настроек кошелька и интеграции, но также явно пишите для клиентов «Arbitrum One».

Нужен ли клиентам ETH для отправки USDC в Arbitrum One?

Для обычного перевода токенов — да. На кошельке отправителя должен быть ETH в Arbitrum One для оплаты газа. Этот запас для газа не входит в запрошенную сумму USDC. Если фактический процесс оплаты предусматривает покрытие расходов на газ или другой механизм, проверьте его поведение.

Какой адрес у контракта нативного USDC в Arbitrum?

Circle указывает для нативного USDC в Arbitrum адрес 0xaf88d065e77c8cC2239327C5EDb3A432268e5831. Перед запуском сопоставьте его с актуальным каталогом Circle и контрактом, который распознается в вашей учетной записи продавца.

USDC.e — то же самое, что нативный USDC?

Нет. Нативный и перенесенный через мост USDC, обычно отображаемый как USDC.e, используют разные контракты в Arbitrum One. Принимайте только контракт, настроенный для выбранного способа оплаты, а перевод другого токена направляйте на проверку вместо автоматического присвоения заказу состояния «оплачен».

Платежи в Arbitrum One мгновенны и окончательны?

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

Можно ли принимать любой токен в Arbitrum One?

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

Можно ли вернуть платеж в Arbitrum One?

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

Заключение

Надежный способ оплаты в Arbitrum One — это контролируемый процесс, а не многократно используемый адрес 0x. Указывайте идентификатор сети 42161, называйте Arbitrum One на каждом этапе выбора клиента, проверяйте точный контракт токена и объясняйте, что для обычных переводов токенов нужен ETH в Arbitrum One для оплаты газа.

Нативный USDC — понятный исходный вариант для многих товаров и услуг с ценой в долларах, но только если контракт из каталога Circle соответствует активу в вашей учетной записи. Не смешивайте USDC.e и другие контракты. Затем полностью проверьте состояния ожидания и подтверждения, повторную доставку вебхуков, идемпотентное исполнение, сверку, исключения и согласованный возврат.

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