Solana і Tron
Мережі Solana і Tron перелічені в GET /api/v1/networks поряд з мережами EVM, з family, встановленим у solana або tron. Читайте їхні токени, кількість знаків після коми та minimum_payment з API; не тримайте власний список. Адреси в цих мережах використовують власний формат base58 у запитах, відповідях і вебхуках.
Чим вони відрізняються від EVM
Section titled “Чим вони відрізняються від EVM”| EVM | Solana | Tron | |
|---|---|---|---|
| Платіжна адреса | Адреса контракту. Отримувач фіксується в мережі під час створення адреси. | Ключ на кожен платіж, який тримає підписант Invoise. | Ключ на кожен платіж, який тримає підписант Invoise. |
| Зберігання коштів | Кошти можуть іти лише отримувачу, зафіксованому в мережі, за вирахуванням комісії. | Invoise тримає платіж лише до передачі вашому отримувачу. | Invoise тримає платіж до передачі. Платіжного контракту немає. |
| Отримувач | recipient магазину |
PUT /shops/{shop_id}/solana-recipient |
PUT /shops/{shop_id}/tron-recipient |
| Делегат | Опціонально | Немає | Немає |
| Магазин-пісочниця | Так | Ні: 400 solana_sandbox_unavailable |
Так |
За замовчуванням мерчант може мати 100 активних депозитних адрес Solana одночасно; персонал Invoise може встановити мерчанту інший ліміт. Вимикайте ті, що простоюють, щоб звільнити місце: див. Ліміти.
Задайте отримувача
Section titled “Задайте отримувача”Магазину потрібен отримувач 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 адресу й не адресу Invoise: invalid_solana_address. У гаманця вже має бути рахунок для токена; інакше створення рахунку або депозиту повертає solana_recipient_token_account_required. Спершу отримайте цей токен там один раз. |
| Tron | Неправильно сформована адреса, зокрема з хибною контрольною сумою, повертає invalid_tron_address; адреса Invoise повертає invalid_tron_recipient. Якщо Invoise вимкнув Tron для мерчанта, збереження повертає merchant_network_disabled. |
Оплата в гаманець Invoise
Section titled “Оплата в гаманець Invoise”Гаманець 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.