Solana e Tron
As redes Solana e Tron aparecem em GET /api/v1/networks junto com as redes EVM, com family definido como solana ou tron. Leia seus tokens, casas decimais e minimum_payment pela API; não mantenha sua própria lista. Endereços nessas redes usam seu próprio formato base58 em requisições, respostas e webhooks.
Como elas diferem da EVM
Seção intitulada “Como elas diferem da EVM”| EVM | Solana | Tron | |
|---|---|---|---|
| Endereço de pagamento | Um endereço de contrato. O destinatário fica fixado na blockchain quando o endereço é criado. | Uma chave por pagamento, mantida pelo signatário do Invoise. | Uma chave por pagamento, mantida pelo signatário do Invoise. |
| Custódia | Os fundos só podem ir para o destinatário fixado na blockchain, menos a taxa. | O Invoise só retém um pagamento até repassá-lo ao seu destinatário. | O Invoise retém um pagamento até repassá-lo. Não há contrato de pagamento. |
| Destinatário | O recipient da loja |
PUT /shops/{shop_id}/solana-recipient |
PUT /shops/{shop_id}/tron-recipient |
| Delegado | Opcional | Nenhum | Nenhum |
| Loja sandbox | Sim | Não: 400 solana_sandbox_unavailable |
Sim |
Por padrão, um lojista pode manter 100 endereços de depósito Solana ativos ao mesmo tempo; a equipe do Invoise pode definir outro limite para um lojista. Desative os ociosos para liberar espaço: veja Limites.
Defina o destinatário
Seção intitulada “Defina o destinatário”Uma loja precisa de um destinatário Solana ou Tron antes de poder emitir nessa rede. Sem um, criar uma fatura ou depósito retorna 400 solana_setup_required ou 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>"}'Use /tron-recipient para a Tron. Defini-lo exige uma sessão de proprietário; uma chave de API da loja só pode lê-lo. GET no mesmo caminho retorna {"address":"..."}, com um endereço vazio até que um seja definido.
O destinatário é definido uma única vez. Enviar o mesmo endereço novamente funciona; outro endereço retorna 400 shop_addresses_immutable. Verifique o endereço antes de salvá-lo.
| Rede | Regras |
|---|---|
| Solana | Use uma carteira comum, não um endereço derivado de programa e não um endereço do Invoise: invalid_solana_address. A carteira já deve ter uma conta para o token; caso contrário, criar uma fatura ou depósito retorna solana_recipient_token_account_required. Receba esse token nela uma vez primeiro. |
| Tron | Um endereço malformado, inclusive com checksum incorreto, retorna invalid_tron_address; um endereço do Invoise retorna invalid_tron_recipient. Se o Invoise desativou a Tron para o lojista, salvar retorna merchant_network_disabled. |
Pagando na carteira Invoise
Seção intitulada “Pagando na carteira Invoise”A carteira Invoise vive em redes EVM. Uma loja cujos repasses em Solana ou Tron vão para a carteira ainda recebe um endereço de pagamento em Solana ou Tron, e o Invoise faz a ponte de cada pagamento até a carteira na Arbitrum. GET /merchants/{merchant_id}/networks mostra wallet_bridge: true em uma rede Solana ou Tron que pode fazer a ponte.
Quando a ponte não é possível, emitir nessa rede retorna 400 solana_bridge_unavailable ou 400 tron_bridge_unavailable, e escolher a carteira para a Tron é recusado com tron_bridge_unavailable. Lojas que repassam Solana ou Tron para o próprio endereço não são afetadas.
Escolha por família de rede com PATCH /shops/{shop_id}: solana_payout_target e tron_payout_target aceitam address ou wallet. Veja a referência da API.