Migração da CryptAPI para a Suawave: diferenças entre APIs

Fontes consultadas em

Resumo da escolha

Escolha pelo fluxo de pagamento de que você precisa
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 Suawave

Diferenças entre as APIs

Comportamento documentado da API
AspectoSuawaveCryptAPI
CriaçãoGET /{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çoO 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 repasseUm 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]
CallbacksRSA-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.

Rota de origem e escopo da migração para a Suawave
CryptAPI: DocumentaçãoSuawave: RotaVerificaçã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

  1. 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.

  2. 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.

  3. 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*.

  4. 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.

Redes e taxas para pagamentos em USDT · Plugins para lojas e ferramentas para desenvolvedores · Guias de integração de pagamentos