
Suawave e Plisio: APIs de faturas e endereços de depósito
Fontes consultadas em
Resumo da escolha
| Suawave: Escolha quando... | Plisio: Escolha quando... |
|---|---|
| Você quer mostrar o endereço no seu checkout e acompanhar pedidos pela URL de callback. | Você precisa de uma URL de fatura retornada pelo provedor. A Plisio documenta txn_id e invoice_url na resposta de criação de fatura. [p-invoice] |
Ao avaliar uma alternativa à Plisio, comece pelos dados que sua tela de pagamento usa. A Suawave retorna um endereço e oferece um endpoint de QR. Mantenha valor, referência e estado de entrega do pedido na aplicação.
Integre com a SuawaveDiferenças entre as APIs
| Aspecto | Suawave | Plisio |
|---|---|---|
| Requisições | Endpoints GET públicos dispensam autenticação e retornam JSON. | A Plisio documenta requisições GET com api_key na consulta e respostas JSON em /api/v1. [p-auth] |
| Criação | GET /{ticker}/create/ recebe address e callback. | A Plisio documenta GET /api/v1/invoices/new com order_name, order_number e api_key. [p-create] |
| Identidade da resposta | Salve address_in com ticker, callback e referência interna do pedido. | A Plisio documenta txn_id e invoice_url na resposta de criação de fatura. [p-invoice] |
| Notificações | Callbacks GET por padrão; post=1 seleciona POST de formulário e json=1 seleciona POST JSON. | A Plisio envia atualizações por POST e permite que callback_url substitua a Status URL configurada. [p-callback] |
Na Suawave, a URL de callback faz parte da identidade permanente do mapeamento, além de ser o destino das notificações. Codifique nela a referência e o nonce e guarde a URL exata. A primeira chamada create fixa as opções do par ticker/callback. Um novo pedido precisa de outra URL de callback.
Ativos aceitos: bep20/usdc (BSC), bep20/usdt (BSC), trc20/usdt (TRON). Consulte a documentação para verificar os formatos atuais de requisição e resposta. Tickers e redes · Referência da API
Etapas de migração
Substitua a interface de faturas e a tela de pagamento
Escolha ativo e rede aceitos pela Suawave na lista gerada de tickers e consulte o mínimo. Salve o valor esperado no pedido. Mostre o endereço e o QR retornados, sem esperar uma URL de fatura hospedada. Crie um processador separado de callbacks Suawave que verifique a assinatura antes de tratar o evento.
Crie novos pedidos com endereço de repasse e callback
Envie address e um callback HTTPS codificado na URL para GET /{ticker}/create/. Inclua a referência do pedido e um nonce imprevisível na URL de callback e guarde-os no servidor. Salve o address_in retornado junto com o provedor e o ticker. Não reutilize endereços de depósito de outro provedor.
Substitua a verificação de callbacks e a liberação do pedido
Verifique x-ca-signature com a chave do endpoint GET /pubkey/ da Suawave. Preserve a URL original completa em callbacks GET e o corpo bruto em POST, antes de interpretá-lo. Confira pedido, nonce, ativo, endereço e valor e elimine duplicatas por uuid. Entregue o pedido somente com pending igual a 0 e confirme com HTTP 200 e *ok*.
Direcione novos pedidos e concilie os antigos
Mantenha o provedor original nos pedidos existentes e seu processador de callbacks ativo. Direcione apenas novos pedidos à Suawave. Teste assinaturas válidas e adulteradas, entregas duplicadas, eventos pendentes após confirmados, depósitos menores e falhas de callback antes de abrir o fluxo aos clientes. Use os logs da Suawave como alternativa de consulta periódica.
Consulte estes guias ao substituir o adaptador: Início rápido · Contrato de callbacks · Exemplos de verificação de assinatura
Taxas e valores mínimos
A Plisio lista Gateway API e White Label como opções de preço separadas. [p-fees]
Consulte a fonte de preços do provedor abaixo e nossa documentação de taxas para o ativo e o valor de depósito esperado. Taxas e valores mínimos
Perguntas frequentes
Posso manter meu próprio número de pedido?
Sim. Salve-o na aplicação e inclua-o no callback codificado na URL, junto com um nonce imprevisível. A Suawave devolve seus parâmetros de consulta nos callbacks; confira-os com o pedido armazenado.
Os callbacks da Suawave precisam usar GET?
Não. Defina post=1 para POST de formulário ou json=1 para POST JSON ao criar o mapeamento. JSON tem precedência se ambos estiverem definidos. Preserve o corpo bruto do POST para verificar a assinatura.
Os endereços de depósito existentes podem migrar com a integração?
Crie um endereço pela Suawave para cada novo par ticker e callback. Mantenha instruções existentes e pedidos em aberto no provedor original até concluir a conciliação.
Como comparar o custo total?
Consulte a fonte de preços do provedor e as taxas e os mínimos da Suawave para o ativo e o depósito esperados. Inclua taxa de serviço, taxa de rede e mínimos, em vez de comparar apenas a porcentagem anunciada.
Fontes e método
Este comparativo de documentação é publicado pela Suawave. As orientações se baseiam nos recursos documentados; não são um teste de desempenho de pagamentos. Cada nota aponta para a documentação pública ou página de preços do próprio provedor e informa a data da consulta.
- [p-invoice] Plisio: Criação de fatura. Fontes consultadas em .
- [p-auth] Plisio: Introdução. Fontes consultadas em .
- [p-create] Plisio: Criação de fatura. Fontes consultadas em .
- [p-callback] Plisio: Gerenciamento de atualizações de faturas e entradas. Fontes consultadas em .
- [p-fees] Plisio: Preços. Fontes consultadas em .
Redes e taxas para pagamentos em USDT · Plugins para lojas e ferramentas para desenvolvedores · Guias de integração de pagamentos