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

Solana и Tron

Сети Solana и Tron есть в GET /api/v1/networks рядом с EVM-сетями, у них family равно solana или tron. Токены, decimals и minimum_payment получайте из API, а не храните свой список. Адреса в этих сетях записываются в их собственном формате base58 — в запросах, ответах и вебхуках.

EVM Solana Tron
Адрес для оплаты Адрес контракта. Получатель закрепляется в блокчейне при создании адреса. Отдельный ключ на каждый платёж, его хранит подписывающий сервис Invoise. Отдельный ключ на каждый платёж, его хранит подписывающий сервис Invoise.
Хранение средств Средства могут уйти только получателю, закреплённому в блокчейне, за вычетом комиссии. Invoise держит платёж, только пока не перешлёт его вашему получателю. Invoise держит платёж, пока не перешлёт его. Платёжного контракта нет.
Получатель recipient магазина PUT /shops/{shop_id}/solana-recipient PUT /shops/{shop_id}/tron-recipient
Делегат Необязателен Нет Нет
Sandbox-магазин Да Нет: 400 solana_sandbox_unavailable Да

По умолчанию у мерчанта может быть 100 активных депозитных адресов Solana одновременно; сотрудники Invoise могут задать мерчанту другой лимит. Отключайте простаивающие, чтобы освободить место: см. Лимиты.

Чтобы выпускать платежи в Solana или Tron, магазину нужен получатель в этой сети. Без него создание инвойса или депозита вернёт 400 solana_setup_required или 400 tron_setup_required.

Окно терминала
curl -X PUT 'https://platform.invoise.me/api/v1/shops/{shop_id}/solana-recipient' \
-H 'Authorization: Bearer <session-token>' \
-H 'Idempotency-Key: <saved-unique-key>' \
-H 'Content-Type: application/json' \
-d '{"address":"<your-solana-wallet>"}'

Для Tron используйте /tron-recipient. Задать получателя может только сессия владельца; API-ключ магазина может его только прочитать. GET по тому же пути возвращает {"address":"..."}, пока получатель не задан — с пустым адресом.

Получатель задаётся один раз. Тот же адрес повторно принимается, другой вернёт 400 shop_addresses_immutable. Проверьте адрес до сохранения.

Сеть Правила
Solana Нужен обычный кошелёк, не program-derived address и не адрес Invoise: иначе invalid_solana_address. У кошелька уже должен быть аккаунт для токена, иначе создание инвойса или депозита вернёт solana_recipient_token_account_required. Сначала один раз получите на него этот токен.
Tron Некорректный адрес, в том числе с неверной контрольной суммой, вернёт invalid_tron_address, адрес Invoise — invalid_tron_recipient. Если Invoise отключил Tron для мерчанта, сохранение вернёт merchant_network_disabled.

Кошелёк Invoise работает в EVM-сетях. Магазин, чьи выплаты в Solana или Tron идут в кошелёк, всё равно получает адрес для оплаты в Solana или Tron, а Invoise переводит каждый платёж в кошелёк в Arbitrum через мост. GET /merchants/{merchant_id}/networks показывает wallet_bridge: true у сети Solana или Tron, где мост работает.

Если мост недоступен, выпуск в этой сети вернёт 400 solana_bridge_unavailable или 400 tron_bridge_unavailable, а выбор кошелька для Tron будет отклонён с tron_bridge_unavailable. Магазинов, которые выплачивают Solana или Tron на собственный адрес, это не касается.

Выбор задаётся для каждого семейства сетей через PATCH /shops/{shop_id}: solana_payout_target и tron_payout_target принимают address или wallet. См. справочник API.