O Flow Builder público da Hodle mostra a origem, o destino e as etapas de integração. A imagem abaixo é uma captura real dessa ferramenta, com dados de exemplo. Consulte os guias de cada endpoint para os requisitos de execução.
Flow Builder da documentação Hodle, capturado em 22/09/2026. Visualização de integração; não representa uma transação executada ou um caso de cliente.
On-ramp converte reais em ativos digitais. Off-ramp converte saldo em ativos digitais para pagar em reais via Pix. Confira o suporte no endpoint escolhido: uma rede do catálogo não habilita todas as operações. Depósitos e payouts de terceiros dependem de aprovação específica, além da verificação cadastral. Referências conferidas em 22 de setembro de 2026.
| Fluxo | Ativo, rede e condição |
|---|---|
| Cobrança Pix por API | POST /api/deposit/asset. O depósito documenta USDT em Polygon/Arbitrum e USDC em Polygon/Base/Gnosis, sujeito à conta. A confirmação do Pix precede a conclusão da entrega do ativo. |
| Pagar Pix com saldo em stablecoin | POST /api/wallet/payout. USDT em Polygon, Solana ou Tron; USDC em Polygon, Base ou Solana. Tron exige habilitação adicional. Confira o ativo efetivamente selecionado e a taxa no fluxo de confirmação. |
| Receber automaticamente em carteira externa | Chave ou QR estático Pix → USDC na Base. Exige conta verificada, habilitação e carteira padrão externa na whitelist. Disponível só em produção. |
| Gateway Pix para USDT | Checkout com cobrança Pix dinâmica. É um fluxo diferente do recebimento automático por chave estática. |
| Lightning para Pix | POST /api/lightning/invoice emite uma invoice. Em produção, o pagamento dispara o fluxo de Pix; a invoice do sandbox não é pagável. |
A Hodle fornece software e API para conectar Pix e ativos digitais. Nas wallets auto-custodiais, o usuário controla as chaves. Os serviços financeiros e os fluxos de fundos regulados são executados por parceiros licenciados e/ou regulados. Referências conferidas em 19 de setembro de 2026.
| Critério | Como funciona na Hodle |
|---|---|
| Custódia | Wallets auto-custodiais: chaves sob controle do usuário. A Hodle não custodia fundos ou ativos de clientes. |
| KYC e KYB | Verificação de pessoa física ou jurídica e habilitação do fluxo são requisitos de produção. Testar no sandbox não aprova uma conta de produção. |
| Sandbox | Cadastro separado em app-sandbox.hodle.com.br e chave de teste. As operações suportadas usam Base Sepolia; Pix é simulado, sem movimentação de reais. |
| Produção | API em api.hodle.com.br, com chave de produção, conta aprovada e permissões para o fluxo contratado. A disponibilidade depende do ativo, da rede e da operação. |
| Integração white-label | Seu produto mantém a experiência e a relação com o cliente. Marca própria não transfere à Hodle as obrigações do seu modelo de negócio. |
On-ramp e off-ramp têm taxa de serviço publicada: de 2% a 0,5%, conforme a faixa de volume, com mínimo de R$ 0,75 por operação. O volume liquidado no mês anterior define a faixa do mês seguinte; compra e venda contam juntas. Condições do contrato assinado prevalecem sobre a tabela.
| Serviço | Preço de tabela e condição |
|---|---|
| On-ramp e off-ramp | 2% até R$ 100 mil de volume mensal; faixas intermediárias de 1,6%, 1,25%, 0,95% e 0,7%; 0,5% acima de R$ 5 milhões. Mínimo de R$ 0,75 por operação. |
| Exemplo de taxa de serviço | Uma operação de R$ 1.000 na faixa de 2% tem R$ 20 de taxa de serviço. Isso não é uma cotação de câmbio nem uma promessa de quantidade líquida de tokens. |
| Emissão de conta nominal PJ | Setup de R$ 15.000, uma única vez, para habilitar a emissão. Esse setup não é necessário para usar on-ramp e off-ramp. |
| Conversão e envio entre redes | Sem tabela pública única. Confirme o par, a rede e a condição comercial antes de executar. |
Comece por uma cotação no sandbox e valide também rejeições, estados pendentes e conciliação. As rotas suportadas mantêm o mesmo caminho em produção; credenciais, dados e permissões são separados.
Substitua a variável por sua chave de teste no backend. Este exemplo consulta o preço de R$ 100 em USDC via Base; não movimenta dinheiro. Os valores do sandbox são de teste e não devem ser usados como preço de produção.
curl --request POST \
--url https://sandbox-api.hodle.com.br/api/quote \
--header "Authorization: Bearer $HODLE_SANDBOX_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"inputCurrency": "BRL",
"inputPaymentMethod": "PIX",
"outputCurrency": "USDC",
"outputPaymentMethod": "BASE",
"inputAmount": "100.00"
}'Seu sistema deve liberar o pedido apenas após o estado final esperado. Uma chamada HTTP aceita, um Pix recebido e uma entrega on-chain são etapas distintas.
| Situação | Tratamento na integração |
|---|---|
| Operação pendente | Guarde o identificador e acompanhe o status. Não crie um novo pagamento só porque a primeira consulta continua pendente. |
| Webhook repetido | Verifique a assinatura e deduplique o evento antes de produzir efeitos no pedido ou no saldo. |
| Resposta 401 ou 403 | Confira host e chave do ambiente. Um 403 pode indicar permissão de fluxo, KYC/KYB ou habilitação ausente; não repita indefinidamente. |
| Resposta 429 | Respeite Retry-After quando presente e use retentativas com espera. |
| Timeout após o envio | Resultado desconhecido não equivale a falha. Consulte a operação existente antes de considerar qualquer novo envio. |
A validação precisa cobrir a criação da cobrança, o processamento de eventos, a consulta do estado final e o fechamento da operação no seu sistema. Escolha o guia conforme a etapa que está implementando.
Condições para escolher a infraestrutura e começar a integração.
Sim. A API conecta cobrança Pix à entrega de ativos digitais e permite pagar Pix a partir de saldo em stablecoin. Ativo, rede, habilitação e verificação variam por fluxo. Consulte o endpoint antes de escolher a integração.
Não. A Hodle fornece software e wallets auto-custodiais, com chaves sob controle do usuário. Os serviços financeiros e fluxos regulados são executados por parceiros licenciados e/ou regulados.
Não. A taxa de serviço de on-ramp e off-ramp é pública: de 2% a 0,5%, conforme volume, com mínimo de R$ 0,75 por operação. A tabela completa fica em /precos. Conversões e envios entre redes exigem consulta da condição aplicável; contratos negociados podem prevalecer.
Não. O sandbox usa operações de teste em Base Sepolia nos fluxos suportados e simula a etapa Pix. É necessário cadastro separado e chave de sandbox. A aprovação de produção e a disponibilidade de cada módulo são independentes.
Não. O suporte deve ser conferido por ativo, rede e operação. Por exemplo, o recebimento automático por chave Pix estática entrega USDC na Base; isso não significa suporte automático a USDT ou a todas as outras redes nesse mesmo fluxo.
Os requisitos dependem do seu modelo de negócio. A Hodle é uma empresa de software, não é banco nem instituição financeira. A integração não substitui a análise jurídica da sua operação nem transfere as licenças de parceiros para sua empresa.