
Suawave e CoinPayments: migração da API de pagamentos
Fontes consultadas em
Resumo da escolha
| Suawave: Escolha quando... | CoinPayments: Escolha quando... |
|---|---|
| Você quer um fluxo com endereço de depósito, informando carteira de repasse e callback em cada novo mapeamento de pedido. | Você precisa do modelo documentado de carteiras com endereços permanentes ou temporários. A CoinPayments documenta carteiras com endereços permanentes ou temporários na nova plataforma. [cp-wallet] |
Antes de avaliar uma alternativa à CoinPayments, identifique qual API sua aplicação usa. Trate o fluxo antigo cmd e a nova API JSON como adaptadores diferentes. A integração Suawave usa ticker, endereço de repasse e URL de callback.
Integre com a SuawaveDiferenças entre as APIs
| Aspecto | Suawave | CoinPayments |
|---|---|---|
| Requisições antigas | Use as rotas GET aceitas diretamente, começando por /{ticker}/create/. | Requisições antigas da CoinPayments usam POST /api.php com operações cmd codificadas como formulário. [cp-legacy] |
| Criação de novo pagamento | GET /{ticker}/create/ retorna address_in para a tela de pagamento. | A CoinPayments documenta POST Invoice com JSON para o novo fluxo de criação de pagamentos. [cp-create] |
| Assinatura de requisições | Endpoints GET públicos da Suawave dispensam autenticação; a verificação do callback é uma etapa separada. | A CoinPayments autentica chamadas protegidas com X-CoinPayments-Client, X-CoinPayments-Timestamp e X-CoinPayments-Signature usando HMAC-SHA256. [cp-auth] |
| Identificador da moeda | Escolha um ticker na lista gerada de ativos da Suawave e preserve sua rede. | A nova plataforma CoinPayments identifica moedas por IDs em vez de símbolos. [cp-currency] |
| Modelo de endereços | Crie um mapeamento permanente ticker/callback que encaminha depósitos elegíveis a um único endereço. | A CoinPayments documenta carteiras com endereços permanentes ou temporários na nova plataforma. [cp-wallet] |
Crie um adaptador Suawave com seus próprios campos de provedor, endereço de depósito e identidade de callback. A aplicação deve exibir o checkout, armazenar o valor esperado e decidir se os depósitos confirmados acumulados quitam o pedido. A Suawave cria um endereço de encaminhamento; não importa histórico de carteira ou faturas.
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
Identifique o adaptador e substitua sua interface de pagamentos
Registre provedor e versão da API de cada pedido em aberto. Nos novos pedidos Suawave, escolha ativo e rede na lista gerada de tickers e consulte o mínimo. Vincule sua referência interna à URL de callback, sem tratar um identificador de fatura do provedor como transferível.
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 CoinPayments lista os modos To Balance, ASAP e Nightly, com taxas de rede para ASAP e Nightly. [cp-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
Qual versão da CoinPayments este comparativo cobre?
A tabela identifica separadamente as requisições antigas e o novo fluxo de pagamento. Confira a linha correspondente ao seu adaptador antes de planejar a mudança; o fluxo de destino na Suawave é o mesmo nos dois casos.
A troca de provedor copia o histórico da carteira?
Este guia trata de novos endereços Suawave e do processamento de pedidos. Concilie pagamentos históricos no provedor original e mantenha os identificadores e registros ligados a esses pedidos.
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.
- [cp-wallet] CoinPayments: Migração da API antiga. Fontes consultadas em .
- [cp-legacy] CoinPayments: Migração da API antiga. Fontes consultadas em .
- [cp-create] CoinPayments: Migração da API antiga. Fontes consultadas em .
- [cp-auth] CoinPayments: Autenticação. Fontes consultadas em .
- [cp-currency] CoinPayments: Migração da API antiga. Fontes consultadas em .
- [cp-fees] CoinPayments: Taxas de processamento de pagamentos. Fontes consultadas em .
Redes e taxas para pagamentos em USDT · Plugins para lojas e ferramentas para desenvolvedores · Guias de integração de pagamentos