Para sua loja. Para sua próxima integração.

RECEBA PAGAMENTOS EM CRIPTO COM UMA CHAMADA HTTP

Sem cadastro, sem conta, sem chave de API. Informe o endereço da sua carteira e uma URL de callback e receba em cripto.

Um pagamento do início ao fimHTTP

Solicite um endereço de depósito

curl -G "https://api.suawave.com/trc20/usdt/create/" \
  --data-urlencode "address=TXyzPayoutAddressExample0000000000000" \
  --data-urlencode "callback=https://shop.example/hook?order=1001&nonce=7f3a9c"

O que enviamos após o repasse

{
  "coin": "trc20_usdt",
  "pending": "0",
  "value_coin": "100.000000",
  "value_forwarded_coin": "98.500000"
}
Chega à sua carteira98.50 USDT

Pagamento de exemplo. Exibição de alguns campos do callback.

  1. Um cliente escaneia um QR code com o celular para pagar em um carrinho de café

    Pagando100.00 USDT

  2. Mãos seguram um celular com capa vermelha alaranjada
    Pagamento enviado100.00 USDTtrc20/usdt
  3. A dona de uma loja de cerâmica sorri ao ver uma boa notícia na tela

    +98.50 USDTrecebidos

  4. Amigos riem juntos em um terraço sob um amplo céu azul

    Callback200 OK

  5. Um vendedor fecha uma caixa de envio com fita e sorri para o celular

    Pedido pago100.00 USDT

  6. Uma ilustradora sorri ao receber uma boa notícia na área externa de um café

    Repasse recebido98.50 USDT

  7. Um vendedor de comida de rua mostra uma placa com QR code sobre a grelha

    Escaneie para pagartrc20/usdt

  8. Uma mulher escaneia um QR code com o celular em uma feira de flores

    Pagamento confirmado21 confirmações

Uma mão segura um celular contra o céu, com uma solicitação de pagamento na tela
Pagar100.00 USDTtrc20/usdtTDepos…0000Aguardando pagamento

DO CHECKOUT À SUA CARTEIRA

  1. Solicite um endereço

    Envie o endereço da sua carteira e a URL em que sua loja recebe atualizações de pagamento. Retornamos um endereço de pagamento para seu cliente e o valor mínimo que podemos encaminhar.

  2. Seu cliente paga

    Seu cliente envia o pagamento para esse endereço. É só isso que ele precisa fazer.

  3. O valor vai para você

    Detectamos o pagamento, aguardamos a confirmação da rede e encaminhamos o valor para sua carteira, descontadas as taxas. Em seguida, notificamos sua loja.

  4. Você confirma

    Sua loja verifica se a atualização foi assinada por nós e corresponde ao pedido, processa o evento uma única vez e confirma o recebimento.

CONECTE À SUA LOJA

Cada plugin mostra ao cliente o valor, o endereço e um QR code, e só marca o pedido como pago após um callback assinado e confirmado.

Plugins para lojas

  • Woo

    WooCommerce

    Um plugin para WordPress. O valor, o endereço e o QR code aparecem na página de agradecimento e no e-mail do pedido.

  • Magento 2

    Converte o total do pedido para o token no checkout e gera a fatura quando o pagamento é confirmado.

  • OpenCart

    Uma extensão para OpenCart 4 que recebe pagamentos de pedidos na moeda escolhida por você.

  • PrestaShop

    PrestaShop

    Um módulo para PrestaShop 8 e 1.7.8. Pagamentos menores se somam até atingir o total do pedido.

Ferramentas para desenvolvedores

  • Model Context Protocol

    Servidor MCP

    Permite que um agente de IA crie endereços de depósito, consulte registros de pagamento e estime taxas pela API pública.

  • Go

    Cliente Go

    Usa apenas a biblioteca padrão. Cria endereços de depósito e verifica a assinatura de cada callback.

  • JavaScript

    Cliente JavaScript

    Tipado e sem dependências de execução. Chama a API no Node ou no navegador e verifica callbacks no Node.

UMA CHAMADA. O VALOR NA SUA CARTEIRA.

Seu cliente paga
100.00 USDT
Chega à sua carteira
98.50 USDT
Taxas
1.50 USDT
Solicite um endereço de depósito
curl -G "https://api.suawave.com/trc20/usdt/create/" \
  --data-urlencode "address=TXyzPayoutAddressExample0000000000000" \
  --data-urlencode "callback=https://shop.example/hook?order=1001&nonce=7f3a9c" \
  --data-urlencode "pending=1"
O que você recebe de volta
{
  "status": "success",
  "address_in": "TDepositAddressExample0000000000",
  "address_out": "TXyzPayoutAddressExample0000000000000",
  "callback_url": "https://shop.example/hook?order=1001&nonce=7f3a9c",
  "minimum_transaction_coin": "10.000000",
  "fee_percent": "0.50",
  "fee_fixed_coin": "0.050000",
  "fee_network_coin": "1.000000"
}
O que enviamos após o repasse
{
  "uuid": "8c4e2a61-5b3d-47f9-a0e2-1d6c9b7f3e45",
  "address_in": "TDepositAddressExample0000000000",
  "address_out": "TXyzPayoutAddressExample0000000000000",
  "txid_in": "9f2c1a0e5b7d4c3a8e6f1b2d3c4a5e6f7a8b9c0d1e2f30415263748596a7b8c9",
  "txid_out": "1a2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d6e7f809",
  "coin": "trc20_usdt",
  "pending": "0",
  "confirmations": "21",
  "value_coin": "100.000000",
  "value_forwarded_coin": "98.500000",
  "fee_coin": "1.500000"
}

Em um pagamento de 100.00 USDT, as taxas são descontadas antes de o restante chegar à sua carteira. Os valores acima mostram quanto seu cliente paga, quanto você recebe e o total de taxas.

Consulte a referência da API para ver todas as opções de requisição e os detalhes dos pagamentos.

QUANTO MAIS VOCÊ RECEBE, MENOS PAGA

A taxa de serviço diminui conforme o volume recebido nos últimos 30 dias. Sem taxa de adesão, mensalidade ou taxas ocultas.

Sua taxa será

0.50%para menos de $250,000 recebidos nos últimos 30 dias

0.45%para um volume de $250,000 a $999,999 recebido nos últimos 30 dias

0.40%para um volume de $1,000,000 a $2,499,999 recebido nos últimos 30 dias

0.35%para um volume de $2,500,000 a $4,999,999 recebido nos últimos 30 dias

0.30%para um volume de $5,000,000 a $9,999,999 recebido nos últimos 30 dias

0.20%para um volume de $10,000,000 a $19,999,999 recebido nos últimos 30 dias

0.13%para $20,000,000 ou mais recebidos nos últimos 30 dias

A taxa fixa de rede do ativo é cobrada à parte. Taxas de rede por ativo

Um pagamento detalhado trc20/usdt

Seu cliente paga
100.00 USDT
Taxas
1.50 USDT
Chega à sua carteira
98.50 USDT

Exemplo com a taxa inicial de serviço, incluindo taxas de rede: 0.50%

Selecione seu volume mensal
Volume nos últimos 30 diasTaxa de serviço
Abaixo de $250,0000.50%
De $250,000 a $999,9990.45%
De $1,000,000 a $2,499,9990.40%
De $2,500,000 a $4,999,9990.35%
De $5,000,000 a $9,999,9990.30%
De $10,000,000 a $19,999,9990.20%
$20,000,000 ou mais0.13%

Taxas em perspectiva

Compare além da porcentagem

Dados do concorrente em:

Taxa inicial de serviço antes de descontos por volume e taxas mínimas. Suawave: 0.50% · cryptapi.io: 1%

TRON TRC20

Suawave

1.00USDT

Taxa fixa de rede

Depósito mínimo
10.00 USDT
Taxa mínima de serviço
0.05 USDT

cryptapi.io

≈12.90USDT

Custo estimado de rede

Depósito mínimo
10 USDT

BNB Smart Chain BEP20

Suawave

0.05USDT

Taxa fixa de rede

Depósito mínimo
1.00 USDT
Taxa mínima de serviço
0.05 USDT

cryptapi.io

≈0.01USD

Custo estimado de rede

Depósito mínimo
1 USDT

Ethereum ERC20

Suawave

Não consta na nossa lista atual de ativos aceitos.

cryptapi.io

≈0.58USD

Custo estimado de rede

Depósito mínimo
2 USDT

Os valores de cryptapi.io são um retrato datado da API, considerando stablecoins a 1 USD, sem desconto por volume e com uma transação de repasse. Os custos reais de rede variam. As taxas e os mínimos da Suawave acima vêm dos dados publicados atualmente; aplicam-se taxas mínimas de serviço. Com o custo de rede TRC20 informado, o pagamento mínimo anunciado não deixaria um repasse positivo.

Veja as informações de taxas de cryptapi.io

VOCÊ SÓ PAGA QUANDO RECEBE

Uma pilha de moedas azuis e brancas com uma moeda laranja apoiada ao lado
  • bep20/usdcBSC

    Depósito mínimo
    1.00 USDC
    Taxa mínima de serviço
    0.05 USDC
    Taxa de rede
    0.05 USDC
  • bep20/usdtBSC

    Depósito mínimo
    1.00 USDT
    Taxa mínima de serviço
    0.05 USDT
    Taxa de rede
    0.05 USDT
  • trc20/usdtTRON

    Depósito mínimo
    10.00 USDT
    Taxa mínima de serviço
    0.05 USDT
    Taxa de rede
    1.00 USDT

Cada pagamento tem uma taxa de serviço conforme sua faixa de volume, com um pequeno valor mínimo, mais uma taxa fixa de rede para o envio à sua carteira. Ambas são descontadas do pagamento. Cada atualização informa o total de taxas.

As taxas são calculadas por pagamento. Consulte Taxas e valores mínimos para ver a tabela completa e Tickers e redes para ver o pagamento mínimo de cada moeda.

ATUALIZAÇÕES DE PAGAMENTO PARA SUA LOJA

Quando um pagamento chega à sua carteira, notificamos sua loja com os detalhes, o total de taxas e o valor recebido.

Um feirante e uma cliente riem olhando para um celular em uma feira ensolarada

Callback 200 OK+98.50 USDT encaminhados

Sua loja recebe atualizações na URL de callback. Você também pode solicitar uma notificação assim que um pagamento for detectado, antes da confirmação.

Cada atualização tem uma assinatura digital para sua loja verificar que veio de nós. Sua loja precisa confirmar o recebimento em até 30 segundos; caso contrário, tentamos novamente.

A mesma atualização pode chegar mais de uma vez. Sua loja deve registrar os eventos processados para concluir cada pedido uma única vez. Consulte Verificação de assinaturas de callbacks para ver exemplos de código e Como os callbacks funcionam para entender a entrega e as novas tentativas.

O QUE SABER ANTES DE INTEGRAR

  • Cada pedido recebe seu próprio endereço de pagamento

    Adicione o número do pedido à URL de callback, por exemplo, https://shop.example/hook?order=1001. A Suawave fornece um endereço de depósito para esse pedido. Ao solicitar novamente com a mesma URL e moeda, você recebe o mesmo endereço, sem criar outro ao atualizar a página. Quando o pagamento chega, chamamos essa URL para você saber qual pedido foi pago.

    URL do pedidohttps://shop.example/hook?order=1001
    Endereço de pagamentoTDepos…0000
    Como os callbacks funcionam
  • Escolha a carteira de destino de cada pedido

    Para enviar os pagamentos de um pedido a outra carteira, use uma nova URL de callback ao solicitar o endereço de pagamento.

    Saiba mais na documentação
  • Mostre o valor mínimo desde o início

    Pagamentos abaixo do mínimo não são encaminhados à sua carteira e sua loja não recebe uma atualização de pagamento.

    Vale o mínimo vigente quando o pagamento é detectado pela primeira vez.

    Saiba mais na documentação
  • Use a moeda e a rede corretas

    Cada endereço aceita apenas a moeda e a rede escolhidas. Outros tokens não são encaminhados e sua loja não recebe uma atualização de pagamento.

    Saiba mais na documentação
  • Cada pagamento é independente

    O endereço de pagamento permanece o mesmo. Cada pagamento tem suas próprias taxas, transferência e atualizações, mesmo quando vários chegam ao mesmo tempo.

    Saiba mais na documentação

Dúvidas antes do primeiro pagamento

Tire suas dúvidas sobre pagamentos em cripto com a Suawave, da criação do endereço de depósito ao processamento do callback confirmado.

Veja todas as perguntas sobre pagamentos
Como receber pagamentos em USDT TRC20 sem criar uma conta?

A Suawave permite receber pagamentos em USDT TRC20 sem cadastro, conta ou chave de API. Chame GET /trc20/usdt/create/ com o endereço da sua carteira e uma URL pública de callback HTTPS. Mostre ao pagador o address_in e o minimum_transaction_coin retornados, junto com o ativo e a rede do ticker escolhido.

Leia a documentação
Quais moedas e redes a Suawave aceita?

A Suawave aceita estas rotas de pagamento habilitadas: USDC na rede BNB Smart Chain BEP20 (bep20/usdc); USDT na rede BNB Smart Chain BEP20 (bep20/usdt); USDT na rede TRON TRC20 (trc20/usdt). Use o ticker exato em letras minúsculas para o token e a rede escolhidos; o endereço da carteira, sozinho, não identifica o padrão do token.

Leia a documentação
Quanto a Suawave cobra por pagamento?

A Suawave cobra cada depósito separadamente: uma taxa de serviço, sujeita a um mínimo, mais uma taxa de rede no token do pagamento. Faixas de serviço pelo volume em USD nos últimos 30 dias: Abaixo de $250,000: 0.50%; De $250,000 a $999,999: 0.45%; De $1,000,000 a $2,499,999: 0.40%; De $2,500,000 a $4,999,999: 0.35%; De $5,000,000 a $9,999,999: 0.30%; De $10,000,000 a $19,999,999: 0.20%; $20,000,000 ou mais: 0.13%. Taxas publicadas por token: BNB Smart Chain BEP20 USDC: taxa mínima de serviço de 0.05 USDC, taxa de rede de 0.05 USDC; BNB Smart Chain BEP20 USDT: taxa mínima de serviço de 0.05 USDT, taxa de rede de 0.05 USDT; TRON TRC20 USDT: taxa mínima de serviço de 0.05 USDT, taxa de rede de 1.00 USDT. As taxas são definidas por depósito; fee_coin e value_forwarded_coin informam a cobrança e o repasse efetivos.

Leia a documentação
Qual é o pagamento mínimo em cripto aceito pela Suawave?

A Suawave tem um depósito mínimo para cada token e rede: BNB Smart Chain BEP20 USDC: 1.00 USDC; BNB Smart Chain BEP20 USDT: 1.00 USDT; TRON TRC20 USDT: 10.00 USDT. Consulte minimum_transaction_coin em create ou info antes de mostrar uma solicitação de pagamento; o mínimo aplicável é registrado quando cada depósito é detectado pela primeira vez.

Leia a documentação
Quando posso marcar um pagamento da Suawave como pago?

Marque o pedido como pago somente após verificar um callback confirmado da Suawave com pending igual a 0 e conferir o pedido, token, endereço e valor. Esse evento indica que o depósito elegível foi encaminhado e a transação de repasse foi confirmada; um callback pendente, sozinho, não autoriza a entrega do pedido.

Leia a documentação
Como verificar a assinatura de um webhook da Suawave?

Verifique o cabeçalho x-ca-signature como uma assinatura RSA-SHA256 PKCS#1 v1.5 em base64, usando a chave pública da Suawave obtida em GET /pubkey/. Callbacks GET assinam a URL original completa; callbacks POST assinam o corpo bruto exato. Verifique antes de interpretar ou confiar nos campos, armazene a chave em cache e atualize-a uma vez se a verificação falhar, antes de rejeitar a requisição.

Leia a documentação
E se o cliente pagar menos que o total do pedido?

Sua loja decide se o valor confirmado atende ao total do pedido; o endpoint público create da Suawave não recebe um valor de fatura. Some os depósitos confirmados elegíveis usando value_coin para uma política de valor bruto ou value_forwarded_coin para valor líquido e elimine duplicatas pelos UUIDs dos callbacks. Cada depósito adicional deve atingir seu próprio mínimo e tem cobrança separada.

Leia a documentação
Como a Suawave encaminha pagamentos para minha carteira?

A Suawave encaminha cada depósito elegível separadamente para o único endereço de repasse informado em create, após descontar as taxas e verificar a rede. O callback confirmado inclui txid_out e value_forwarded_coin para seu servidor identificar a transação de repasse e o valor líquido recebido.

Leia a documentação