
Suawave e NOWPayments: migração da API de pagamentos
Fontes consultadas em
Resumo da escolha
| Suawave: Escolha quando... | NOWPayments: Escolha quando... |
|---|---|
| Você quer mostrar um endereço no próprio checkout e encaminhar cada depósito elegível para um único endereço de repasse. | Você precisa de uma URL de fatura gerada pelo provedor para o cliente. POST /v1/invoice da NOWPayments retorna invoice_url para o cliente. [n-invoice] |
Ao avaliar uma alternativa à NOWPayments, compare o que seu checkout precisa: um endereço de depósito exibido por você ou um link de fatura hospedada. A Suawave fornece o endereço e callbacks assinados; sua aplicação controla o pedido e a tela de pagamento.
Integre com a SuawaveDiferenças entre as APIs
| Aspecto | Suawave | NOWPayments |
|---|---|---|
| Criação | GET /{ticker}/create/ com address e callback; sem necessidade de autenticação. | A NOWPayments cria pagamentos diretos com POST /v1/payment, JSON e cabeçalho x-api-key. [n-create] |
| Referência do pedido | Inclua a referência e o nonce em callback e salve o address_in retornado. | A criação de pagamentos na NOWPayments aceita price_amount, price_currency, pay_currency, ipn_callback_url e order_id. [n-fields] |
| Resposta de create | Salve address_in com ticker, endereço de repasse, callback e provedor. | A NOWPayments retorna payment_id e pay_address ao criar um pagamento direto. [n-result] |
| Tela do cliente | Mostre o endereço retornado, ativo, rede, valor e QR no seu checkout. | POST /v1/invoice da NOWPayments retorna invoice_url para o cliente. [n-invoice] |
| Conciliação | GET /{ticker}/logs/ usa a URL de callback armazenada. | A NOWPayments oferece GET /v1/payment/{payment_id} para consultar o status do pagamento. [n-status] |
| Verificação de callbacks | Verifique RSA-SHA256 sobre a URL original ou o corpo bruto do POST com a chave pública da Suawave. | A NOWPayments verifica IPNs com x-nowpayments-sig e HMAC-SHA512 sobre JSON ordenado, usando um segredo IPN. [n-signature] |
Reconstrua o adaptador em torno do par ticker e callback da Suawave. O valor do pedido permanece na aplicação: create retorna um endereço, não um ciclo de fatura. Substitua o mapeamento de status para entrega por callbacks verificados por depósito e acompanhe pagamentos parciais com aritmética decimal.
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
Defina o checkout e o fluxo de valores
Use a lista gerada de tickers da Suawave para escolher o ativo e a rede exatos que o cliente enviará. Consulte o mínimo. Exiba seu próprio checkout e armazene o valor esperado no pedido. Se precisar de cotação, consulte a documentação de conversão; uma cotação não troca os fundos depositados.
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 NOWPayments publica sua taxa de serviço na página de preços. [n-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
A Suawave retorna um link de fatura?
A resposta de create contém o endereço de depósito para seu checkout. Sua aplicação exibe as instruções e mantém o ciclo do pedido. Consulte o início rápido para o fluxo de endereço e QR.
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.
Quando minha loja deve marcar um pedido como pago?
Após validar a assinatura da Suawave e conferir pedido, nonce, ativo, endereço e valor, processe o callback confirmado com pending igual a 0. Salve uuid antes da entrega para que novas tentativas não repitam o trabalho.
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.
- [n-invoice] NOWPayments: Descrição da API e dos endpoints. Fontes consultadas em .
- [n-create] NOWPayments: Descrição da API e dos endpoints. Fontes consultadas em .
- [n-fields] NOWPayments: Descrição da API e dos endpoints. Fontes consultadas em .
- [n-result] NOWPayments: Descrição da API e dos endpoints. Fontes consultadas em .
- [n-status] NOWPayments: Descrição da API e dos endpoints. Fontes consultadas em .
- [n-signature] NOWPayments: IPN e configuração. Fontes consultadas em .
- [n-fees] NOWPayments: 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