Pular para o conteúdo

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.

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.

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.

Janela do terminal
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.

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.