
Migração da CryptAPI para a Suawave: diferenças entre APIs
Fontes consultadas em
Resumo da escolha
| Suawave: Escolha quando... | CryptAPI: Escolha quando... |
|---|---|
| Você quer um único endereço de repasse por pedido e pode processar pagamentos usando os tickers aceitos pela Suawave. | Você precisa dos recursos documentados de divisão de repasses ou escolha do número de confirmações. A CryptAPI documenta divisão de repasses, escolha de confirmações, priority e multi_token. [c-options] |
Este guia compara a CryptAPI de cryptapi.io com a Suawave. Nomes de rotas parecidos são apenas o ponto de partida: confira parâmetros, formatos de resposta e verificação de callbacks antes de alterar uma integração em produção.
Integre com a SuawaveDiferenças entre as APIs
| Aspecto | Suawave | CryptAPI |
|---|---|---|
| Criação | GET /{ticker}/create/ recebe address e callback; opções de consulta não suportadas são recusadas. | A CryptAPI cria endereços de pagamento com GET /{ticker}/create/ usando address e callback. [c-create] |
| Identidade do endereço | O par canônico ticker e callback identifica um endereço permanente; use outro callback para mudar as configurações de repasse. | A CryptAPI retorna o mesmo address_in para a mesma URL de callback e exige outra URL para mudar address_out. [c-reuse] |
| Controles de repasse | Um endereço de repasse; sem divisão, escolha de confirmações, prioridade ou aceitação de múltiplos tokens. | A CryptAPI documenta divisão de repasses, escolha de confirmações, priority e multi_token. [c-options] |
| Callbacks | RSA-SHA256 com x-ca-signature; obtenha a chave pública da Suawave e preserve os bytes originais assinados. | A CryptAPI documenta x-ca-signature como assinatura RSA-SHA256 em base64 sobre a URL GET completa ou o corpo bruto do POST. [c-signature] |
A CryptAPI exige um domínio de callback verificado para novos endereços; endereços existentes continuam funcionando. [c-domain]
A Suawave fixa as opções na primeira chamada create de cada par ticker e callback. Remova parâmetros não suportados, sem presumir que serão ignorados. A detecção pendente usa dados indexados da rede. Teste também a exibição do QR para o cliente, pois o tratamento da data URI é diferente.
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
Mapeamento de endpoints
Cada rota de origem corresponde a uma rota documentada da Suawave ou indica que não há equivalente, com a alternativa mais próxima. Leia as observações antes de migrar.
| CryptAPI: Documentação | Suawave: Rota | Verificação para migração |
|---|---|---|
| A CryptAPI cria endereços de pagamento com GET /{ticker}/create/ usando address e callback. [c-create] | GET /{ticker}/create/ | Revise cada opção de consulta; informe um endereço de repasse e o callback HTTPS codificado. |
| A CryptAPI oferece GET /{ticker}/logs/ com callback como parâmetro de consulta. [c-logs] | GET /{ticker}/logs/ | Consulte o mapeamento da Suawave usando o callback armazenado para esse provedor. |
| A CryptAPI oferece GET /info/ para informações do serviço. [c-info] | Sem equivalente. Alternativa mais próxima: GET /{ticker}/info/ | A Suawave não tem um endpoint info global. Escolha um ticker aceito na lista gerada de ativos e consulte suas informações individualmente. |
| A CryptAPI oferece GET /{ticker}/info/ para informações do ticker. [c-ticker-info] | GET /{ticker}/info/ | Consulte o mínimo atual e use strings decimais para valores. |
| A CryptAPI oferece GET /{ticker}/qrcode/ e documenta qr_code como imagem em base64 sem prefixo de data URI. [c-qr] | GET /{ticker}/qrcode/ | A Suawave retorna qr_code como uma data URI completa; não adicione o prefixo novamente. |
| A CryptAPI oferece GET /{ticker}/estimate/ para estimar taxas da rede, sem incluir a taxa de serviço. [c-estimate] | GET /{ticker}/estimate/ | A Suawave retorna um limite conservador configurado na moeda nativa; esse valor não é o desconto aplicado ao depósito. |
| A CryptAPI oferece GET /convert/ com value, from e to. [c-convert] | GET /convert/ | Confira os pares de conversão e o arredondamento da Suawave; cotações de conversão não trocam fundos. |
| A CryptAPI oferece GET /{ticker}/convert/ com value e from. [c-ticker-convert] | GET /{ticker}/convert/ | Use o ticker da Suawave e valide a string decimal retornada. |
| A CryptAPI publica sua chave de verificação de callbacks em GET /pubkey/. [c-pubkey] | GET /pubkey/ | Substitua a chave em cache pela chave da Suawave; usar o mesmo algoritmo não torna as chaves intercambiáveis. |
Etapas de migração
Liste as opções das requisições atuais
Liste todos os parâmetros de create enviados pela aplicação. Remova a sintaxe de divisão de repasses, confirmations, priority e multi_token do fluxo da Suawave; confira também cada parâmetro opcional na referência da API. Confirme o ativo na lista gerada de tickers e consulte seu mínimo. A Suawave funciona sem cadastro, sem conta e sem chave de API.
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 CryptAPI lista taxas de serviço por volume separadamente das taxas de rede. [c-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
Basta trocar o hostname da API?
Revise separadamente parâmetros não suportados, endereços gerados, data URI do QR e chave de verificação. Preserve os bytes exatos do callback para verificar a assinatura e adicione testes de regressão para os campos de resposta aceitos pela Suawave.
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.
- [c-options] CryptAPI: Criação de endereço de pagamento. Fontes consultadas em .
- [c-create] CryptAPI: Criação de endereço de pagamento. Fontes consultadas em .
- [c-reuse] CryptAPI: Criação de endereço de pagamento. Fontes consultadas em .
- [c-signature] CryptAPI: Verificação de assinaturas de webhooks. Fontes consultadas em .
- [c-logs] CryptAPI: Consulta de registros do endereço de pagamento. Fontes consultadas em .
- [c-info] CryptAPI: Informações do serviço CryptAPI. Fontes consultadas em .
- [c-ticker-info] CryptAPI: Consulta de informações do ticker. Fontes consultadas em .
- [c-qr] CryptAPI: Gerador de QR code de pagamento. Fontes consultadas em .
- [c-estimate] CryptAPI: Estimativa de taxas da rede. Fontes consultadas em .
- [c-convert] CryptAPI: Conversão de preço. Fontes consultadas em .
- [c-ticker-convert] CryptAPI: Conversão de preços por ticker. Fontes consultadas em .
- [c-pubkey] CryptAPI: Verificação de assinaturas de webhooks. Fontes consultadas em .
- [c-domain] CryptAPI: Criação de endereço de pagamento. Fontes consultadas em .
- [c-fees] CryptAPI: Taxas. Fontes consultadas em .
Redes e taxas para pagamentos em USDT · Plugins para lojas e ferramentas para desenvolvedores · Guias de integração de pagamentos