Hodle
DESENVOLVEDORES

A API que paga Pix com stablecoin

Uma API REST para os trilhos brasileiros: pagar Pix com saldo em stablecoin, receber por invoice Lightning, mover USDT entre redes e reconciliar por webhook assinado. O gas em redes EVM é nosso.

PixPix
USDTUSDT
USDCUSDC
LightningLightning
PolygonPolygon
TronTron

O que a API Pix stablecoin resolve

A API da Hodle conecta saldo em stablecoin ao sistema de pagamentos brasileiro. Você dispara um Pix financiado por USDT ou USDC, emite uma invoice Lightning que liquida em reais quando for paga, converte reais em stablecoin e move ativos entre redes — tudo por HTTP, com autenticação por API key com escopo por plataforma. São dois fluxos ponta a ponta que cobrem a maioria das integrações: stablecoin para Pix, e Lightning para Pix. Cada um está documentado com as telas, as chamadas e os modos de falha.

  • Pagar Pix com saldo em USDT (Polygon, Tron) ou USDC (Base).
  • Emitir invoice Lightning BOLT11 que dispara um payout Pix ao ser paga.
  • Converter reais em Lightning, USDT, USDC ou USDCE e entregar em um endereço.
  • Ler saldos por ativo e o extrato paginado de operações.
  • Receber webhook assinado com HMAC em depósito, payout e mudança de KYC.

A integração mais curta é um POST e um GET

O fluxo de pagamento não exige orquestração no seu lado. Você autentica, dispara, e escuta.

  1. 1Autenticação. API key nos headers, com escopo por plataforma. Guia em docs.hodle.com.br/docs/authentication.
  2. 2Chave da carteira. Um GET em /docs/wallet-keys devolve o protectedSymmetricKey usado para assinar payouts e transfers. Cache uma vez por usuário.
  3. 3Disparo. POST /api/wallet/payout para pagar um Pix com stablecoin, ou POST /api/lightning/invoice para emitir uma invoice que liquida em Pix.
  4. 4Confirmação. GET no recurso devolve o estado atual, e o webhook assinado com HMAC avisa cada transição — é o caminho recomendado para reconciliação.

Gas patrocinado nas redes EVM

Em Polygon e Base, a Hodle paga o gas dos transfers e dos payouts. Isso remove da sua integração o problema operacional de manter saldo em moeda nativa de cada rede, monitorar preço de gas e tratar transação que falhou por falta de fundo para taxa. Na prática, o seu usuário só precisa ter a stablecoin. A rede é detalhe de implementação.

  • Sem saldo nativo de Polygon ou Base para operar.
  • Sem monitoramento de preço de gas no seu backend.
  • Sem transação travada por falta de fundo para taxa.

Exemplo de chamada

A mesma API que roda o painel da Hodle é a que você consome. Autenticação por header, corpo em JSON, resposta com o estado da operação.

  • POST /api/wallet/payout — paga Pix com saldo em stablecoin.
  • POST /api/lightning/invoice — invoice BOLT11 que liquida em Pix em segundos ao ser paga.
  • GET /docs/wallet-get — endereços por rede e saldos do usuário da API key.
  • POST /docs/wallet-transfer — USDT para qualquer endereço em Polygon, Base ou Tron.

Redes e ativos disponíveis pela API

USDT em Polygon e Tron, USDC em Base, e as duas também em Arbitrum e Spark. Bitcoin on-chain e por Lightning. Reais entram e saem por Pix.

USDTUSDT
USDCUSDC
BitcoinBitcoin
LightningLightning
PolygonPolygon
TronTron
BaseBase
ArbitrumArbitrum
SparkSpark

Perguntas frequentes

Tire suas dúvidas sobre a API de Pix com stablecoin.

Como integrar uma API de Pix com stablecoin?

Autentique com uma API key nos headers, busque o protectedSymmetricKey do usuário uma vez, e dispare um POST em /api/wallet/payout com a chave Pix e o valor. Um GET no recurso devolve o estado e o webhook assinado avisa cada transição.

Como funciona o webhook de confirmação?

A Hodle envia um payload assinado com HMAC quando há depósito, payout ou mudança de estado de KYC. Você verifica a assinatura e usa o evento para reconciliar, em vez de ficar consultando o estado em loop.

Quem paga a taxa de rede nas transações?

Nas redes EVM, a Hodle. O gas de Polygon e Base é patrocinado, tanto em transfer quanto em payout, então o seu usuário só precisa ter a stablecoin.

Quais redes a API suporta?

USDT em Polygon e Tron, USDC em Base, ambas também em Arbitrum e Spark. Bitcoin on-chain e por Lightning Network. Reais por Pix.

Preciso de licença para usar a API?

A Hodle é uma empresa de software e API: não é banco, não é instituição financeira 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. Os requisitos aplicáveis ao seu caso dependem do seu modelo de negócio — trate isso com o seu jurídico e fale com o nosso time comercial.

Continue explorando

Pagar Pix com USDTCarteiras auto-custodiaisDocumentação da APIPerguntas frequentes

Pronto para começar?

Comece pela documentação ou fale com o time da Hodle.