Perguntas Frequentes
Esclarecemos suas principais dúvidas sobre nossa plataforma de infraestrutura cripto para empresas.
O que é a Hodle?
A Hodle é uma empresa de software e API que conecta Pix e ativos digitais para empresas que operam com o Brasil. A entidade principal é a Hodle LLC, em Wyoming, e a entidade operacional brasileira é a HODLE TECNOLOGIA LTDA. Os serviços financeiros são conduzidos por parceiros licenciados e/ou regulados. O produto é entregue em duas frentes: um painel para o time de operações e uma API REST para o time de engenharia.
Para quem é a plataforma?
A Hodle é ideal para empresas SaaS, agentes de IA, fintechs, marketplaces e negócios que precisam de infraestrutura cripto confiável. Oferecemos APIs robustas para integração direta, além da plataforma visual para gerenciamento. Se a sua empresa recebe em real e precisa guardar ou pagar em dólar, ou recebe em dólar e precisa pagar em real, o caso de uso é este.
Quem autoriza as operações das wallets?
Depende do modelo de assinatura. Na integração por API com PIN, a plataforma fornece o PIN e a chave protegida da wallet selecionada para autorizar a assinatura temporária no servidor. A plataforma é responsável por proteger as credenciais e obter a autorização do titular. Existem também fluxos de assinatura pelo usuário; consulte os requisitos de cada modelo.
Como funciona a API?
Nossa API REST é completa e documentada, permitindo integração com seu sistema em minutos. Autenticação por API key no header, webhooks assinados com HMAC e uma especificação OpenAPI 3.1 pública com operationId, schema de resposta e descrição em cada operação — o formato que ferramentas de function calling e agentes de IA consomem direto.
Como pagar um Pix usando saldo em stablecoin?
Um POST em /api/wallet/payout inicia o pagamento Pix com saldo habilitado em Polygon (USDT, USDC, BRLA), Base (USDC, BRLA), Tron (USDT) ou Solana (USDT, USDC, BRS), conforme permissões da conta. A resposta inicial não confirma liquidação. Acompanhe o status e os webhooks e confira a tarifa e a cotação da operação.
Como funciona o invoice Lightning que liquida em Pix?
Um POST em /api/lightning/invoice devolve um invoice BOLT11. Quando o pagador liquida esse invoice — de qualquer lugar do mundo, em Bitcoin —, a Hodle dispara automaticamente o payout Pix para a chave do recebedor no Brasil. Quem paga não precisa ter conta no Brasil e quem recebe não precisa saber o que é Lightning.
Como funciona a conta PJ?
A conta PJ é aberta em nome da sua empresa junto a bancos parceiros regulados pelo Banco Central. Permite receber e enviar Pix, TED e boletos, com compliance e KYC automatizados para agilizar o processo. O saldo dessa conta conversa com a mesa de conversão, então receber em real e guardar em dólar é uma operação e não duas.
Como funciona o pagamento de QR codes com stablecoins?
Você pode pagar qualquer QR code Pix utilizando stablecoins como USDT ou USDC. A conversão para BRL é automática e a liquidação é instantânea, sem que o recebedor precise saber que o pagamento veio de cripto. Para o lojista o crédito é um Pix comum, com o mesmo comprovante e a mesma conciliação.
Quais ativos e redes vocês suportam?
USDT em Polygon, Base, Solana, Tron, Arbitrum e Spark. USDC em Base, Polygon, Solana, Arbitrum e Spark. Bitcoin em Lightning, on-chain e Liquid. Real tokenizado em BRLA e BRS. A tarifa pode variar por ativo, rede, operação e condição da conta; confira a cotação e a documentação do fluxo.
Quanto tempo demora a liquidação?
Pagamentos via Lightning Network e Liquid são praticamente instantâneos (menos de 1 minuto). Pix liquida em segundos. Transações on-chain de Bitcoin dependem do tempo de mineração do bloco, cerca de 10 minutos. Transferências de stablecoin em Polygon, Base, Solana, Arbitrum e Tron liquidam em segundos.
Quais são as taxas cobradas?
A página de preços publica uma tabela comercial por volume de 2% a 0,5%, com mínimo de R$ 0,75, para operações abrangidas pela condição contratada. API payout, Lightning e wallet podem ter tarifas próprias; confirme taxa e total na cotação do fluxo. Transferência entre carteiras Hodle na mesma rede é sem custo nas combinações previstas na página de preços.
A Hodle é regulada?
A Hodle é uma empresa de software e API: não é banco, não é instituição financeira, não emite moeda eletrônica, não emite cartões diretamente e não custodia fundos ou ativos de clientes. O fluxo de fundos regulados e os serviços financeiros são conduzidos por parceiros licenciados e/ou regulados. O uso de ativos digitais no Brasil é regido pelo Marco Legal das Criptomoedas (Lei nº 14.478/2022). Os requisitos aplicáveis ao seu caso dependem do seu modelo de negócio.
Como funciona o KYC dos meus usuários finais?
A API expõe endpoints para enviar e consultar o KYC dos usuários finais da sua plataforma, e o resultado chega por webhook quando o estado muda. O KYC é exigido para on-ramp e off-ramp. Você pode usar o embed pronto da Hodle ou enviar os dados pela API, mantendo a experiência dentro do seu produto.
Existe ambiente de sandbox para testar?
Sim. A API tem um ambiente de sandbox em sandbox-api.hodle.com.br, com USDB de teste na Base Sepolia e nenhum dinheiro real envolvido. As chaves de sandbox são criadas no painel e a especificação OpenAPI declara os dois servidores, produção e sandbox, para você apontar o cliente sem trocar código.