Pagamentos com cripto em várias redes
Receba USDT e outras criptomoedas por API ou por uma página de checkout hospedada. Cada pedido recebe um endereço de recebimento e o valor exato em cripto a pagar; depois que o pagador faz o envio, a plataforma confirma a transferência na blockchain e envia um resultado assinado para a sua URL de callback. Use endereços mantidos pela plataforma ou importe endereços cuja chave privada você mesmo guarda.
Duas formas de manter endereços
Uma mesma conta pode usar os dois tipos de endereço. Eles diferem em quem guarda a chave privada, para onde o dinheiro vai primeiro e quando a taxa é cobrada.
- Chave privada: Custódia da plataforma: Gerada pela plataforma e guardada com criptografia; Autocustódia: Fica com você; a plataforma não a armazena
- Para onde vai o dinheiro: Custódia da plataforma: Primeiro para o endereço de recebimento e, após a consolidação na plataforma, para os seus ativos sacáveis; Autocustódia: Direto para o seu endereço; a plataforma não faz a consolidação
- Taxa: Custódia da plataforma: Descontada do valor consolidado no momento da consolidação; Autocustódia: Descontada do saldo da sua conta quando cada pedido é pago
- Como usar o dinheiro: Custódia da plataforma: Sacar para um endereço externo ou transferir para o saldo da sua conta; Autocustódia: Fica na sua própria carteira; movimente quando quiser
- Como obter endereços: Custódia da plataforma: Retire-os do pool de endereços da plataforma no console ou ative a alocação automática; Autocustódia: Importe-os no console e assine uma mensagem de verificação com a carteira de cada endereço para provar que ele é seu; até 100 por rede
- Atenção: Custódia da plataforma: Os fundos precisam ser consolidados antes do saque, e cada token tem um saque mínimo; Autocustódia: Só são aceitas as redes marcadas como importáveis na tabela de redes; enquanto o saldo da sua conta estiver abaixo de 0, esses endereços não recebem novos pedidos
Recursos
- API de pedidos: Seu servidor envia o ID do seu pedido, o valor, a moeda de precificação e o token, e recebe de volta um endereço de recebimento, o valor em cripto, um QR code e um link para a página de pagamento. Os pedidos podem ser consultados e encerrados. Um pedido dura 20 minutos por padrão e até 7 dias.
- Vários pedidos no mesmo endereço: Quando um endereço tem vários pedidos não pagos ao mesmo tempo, a plataforma ajusta os últimos dígitos de cada valor em cripto para que todos sejam diferentes e identifica cada pagamento pelo valor. A faixa e o sentido do ajuste podem ser definidos no console.
- Endereços fixos um para um: Vincule um endereço de recebimento fixo a cada usuário do seu sistema. Sempre que esse usuário enviar dinheiro para ele, um pedido pago é criado automaticamente e um callback é enviado. Indicado para recargas de conta.
- Página de checkout: Todo pedido vem com uma página de pagamento pronta. Você também pode abrir um link de checkout próprio, em que os pagadores informam o valor por conta própria, sem precisar de código. O nome da marca, o logotipo, a cor do tema e a faixa de valores podem ser personalizados.
- Preços em moeda fiduciária: Os pedidos podem ser precificados em USD, EUR, CNY, JPY e outras moedas fiduciárias, e a plataforma calcula o valor em cripto pela cotação ao vivo. As cotações são atualizadas a cada 5 minutos, aproximadamente, e nenhum pedido é criado quando não é possível obter a cotação.
- Callbacks assinados com novas tentativas: Assim que um pagamento chega, o resultado do pedido é enviado para a sua URL de callback, assinado com HMAC-SHA256; uma resposta 2xx conta como entregue. Envios com falha são repetidos após 30 segundos, 1 minuto, 2 minutos, 5 minutos e depois a cada 10 minutos, até 10 vezes, e cada envio pode ser consultado no console.
- Consolidação e saques: A cripto em endereços com custódia da plataforma pode ser consolidada automaticamente acima de um limite definido por você, ou manualmente. Depois da consolidação, saque pelo console, saque pela API aberta ou transfira para o saldo da sua conta.
- SDKs e MCP: SDKs de código aberto para PHP, Node.js, Python e Go, com verificação de assinatura dos callbacks. Clientes de IA também podem consultar pedidos, aplicativos, endereços e registros de envio por MCP.
Como começar
- Cadastre-se e abra o console de pagamentos: Basta uma conta Tovanix. Não há solicitação à parte nem documentos da empresa para enviar.
- Crie um aplicativo: Obtenha o app_id, o app_key e o segredo de assinatura dos callbacks, e informe a sua URL de callback. Se precisar de endereços fixos, ative o modo um para um no aplicativo.
- Prepare os endereços de recebimento: Retire endereços com custódia da plataforma do pool de endereços ou importe os seus próprios endereços e verifique-os com uma assinatura.
- Crie pedidos ou compartilhe um checkout: Seu servidor chama o endpoint de criação de pedido e entrega ao pagador a página de pagamento ou o endereço de recebimento retornado. Sem escrever código, você pode simplesmente enviar o seu link de checkout.
- Trate os callbacks e use os fundos: Verifique a assinatura de cada callback e depois faça a entrega ou o crédito ao seu usuário. Os fundos em endereços com custódia da plataforma podem ser sacados ou transferidos para o saldo da sua conta após a consolidação.
Regras
- Os valores dos pedidos são precificados em moeda fiduciária, com no máximo duas casas decimais; sem currency, o pedido é precificado em yuan chinês (CNY).
- Um pedido dura 20 minutos por padrão e pode ser configurado com o parâmetro timeout para até 7 dias; pedidos não pagos são encerrados automaticamente quando expiram.
- Um pagamento só é concluído, e o callback só é enviado, depois de atingir o número de confirmações indicado na tabela de redes.
- Uma resposta 2xx a um callback conta como entregue, e envios com falha são repetidos até 10 vezes. Trate os callbacks de forma idempotente por out_order_id, porque um mesmo pedido pode ser enviado mais de uma vez.
- Os endereços de autocustódia são cobrados do saldo da sua conta a cada pagamento; enquanto o saldo estiver abaixo de 0, eles não recebem novos pedidos, os pedidos existentes não são afetados, e eles voltam a funcionar quando o saldo é recarregado.
- Só podem ser sacados os fundos consolidados que estão nos seus ativos sacáveis, e cada token tem um saque mínimo. Se o controle de risco pedir que uma conta verifique a identidade, ela não pode sacar até concluir a verificação.
Redes e tokens
| Rede | Moedas aceitas | Confirmações até o crédito | Endereços de autocustódia |
|---|---|---|---|
| TRON | TRX / USDT | 19 blocos | Podem ser importados |
Quando a plataforma abre uma nova rede, ela aparece aqui automaticamente. As redes que não estão na lista ainda não podem ser usadas para pagamentos.
Taxas
- Endereços com custódia da plataforma: 0.5% ou mais
- Endereços de autocustódia: 1.5% (Mínimo de $0.01 por pedido)
- Transferência para o saldo da conta: Grátis
| Consolidado neste mês | Taxa percentual |
|---|---|
| $0 – $1,000 | 1.5% |
| $1,000 – $2,000 | 1.2% |
| $2,000 – $5,000 | 0.8% |
| $5,000 ou mais | 0.5% |
Taxa mínima por consolidação: 0.5 TRX (TRON), 1 USDT (TRON)
| Moeda | Taxa | Saque mínimo |
|---|---|---|
| TRX (TRON) | 1 TRX | 3 TRX |
| USDT (TRON) | 1.5 USDT | 3 USDT |
Estas são as taxas padrão. Se a sua conta tiver uma taxa própria, vale a taxa exibida no console. As taxas e as taxas mínimas são definidas pela plataforma, e esta página é atualizada automaticamente.
Perguntas frequentes
Quais moedas posso receber agora?
As que a tabela de redes e tokens desta página lista: são as redes e os tokens para os quais você pode criar pedidos neste momento. Novas redes aparecem na tabela automaticamente quando a plataforma as abre; as redes que não estão na lista ainda não podem ser usadas.
Custódia da plataforma ou autocustódia?
Escolha a custódia da plataforma se você não quer gerenciar chaves privadas e precisa de saques ou de transferências para o saldo da conta. Escolha a autocustódia se quer que o dinheiro vá direto para a sua própria carteira, sem que a plataforma toque nele. A autocustódia só funciona nas redes marcadas como importáveis na tabela, e as taxas saem do saldo da sua conta, então mantenha o saldo em 0 ou acima. Os dois tipos de endereço podem ser usados na mesma conta.
Como exatamente a taxa é calculada?
Custódia da plataforma: cada consolidação é cobrada pelo maior valor entre o valor consolidado multiplicado pela taxa da faixa deste mês e a taxa mínima por consolidação do token, e o restante entra nos seus ativos sacáveis. A faixa deste mês depende de quanto você já consolidou neste mês e é reiniciada no mês seguinte. Autocustódia: cada pedido pago é cobrado pelo valor em cripto multiplicado pela taxa, convertido em USD e descontado do saldo da sua conta, com um mínimo por pedido. As taxas e as taxas mínimas estão em Taxas, nesta página.
Preciso de verificação de identidade ou de uma empresa?
Você não precisa enviar documentos pessoais ou da empresa para começar; pode criar um aplicativo logo após o cadastro. Se o controle de risco considerar uma conta arriscada, ela pode ter de concluir a verificação de identidade e não pode sacar até que isso seja feito.
Quem paga a taxa de rede?
O pagador paga a taxa de rede da própria transferência. As taxas de rede da consolidação dos endereços com custódia da plataforma são pagas pela plataforma e não são cobradas de você.
Como verifico um callback?
Calcule o HMAC-SHA256 sobre os parâmetros do callback com o segredo de assinatura de callbacks do aplicativo (ou com o app_key, se nenhum segredo estiver definido), da mesma forma que as requisições são assinadas, e compare com sign. Os callbacks trazem notify_id, sign_ts e nonce para proteção contra repetição, e os SDKs incluem um método de verificação pronto.
Posso receber pagamentos sem escrever código?
Sim. Abra um checkout no console e envie o link aos pagadores, que informam o valor e pagam. Os pagamentos aparecem em pedidos de checkout, no console.
Como retiro o dinheiro?
Custódia da plataforma: após a consolidação, os fundos ficam nos seus ativos sacáveis; saque para um endereço externo no console (com taxa fixa por token), saque pela API aberta ou transfira para o saldo da sua conta. Autocustódia: o dinheiro já está na sua própria carteira e a plataforma nunca toca nele.
Páginas relacionadas: Aluguel de energia TRON · Verificação e risco de transações · Cartões virtuais · Documentação da API · Usar pagamentos multichain
Carregando…