Hodle API: Pix, stablecoins and wallets

Build payment flows with endpoint examples, authentication, signed webhooks and reconciliation. Check each product’s requirements before selecting your environment.

Start integratingCheck sandbox coverageBrowse the API reference
Use cases

From the first call to settled BRL

Two end-to-end flows that cover most integrations. Each guide shows the screens, the API calls, and every failure mode.

Stable ↔ PIX

Pay PIX from a user's USDT (Polygon/Tron) or USDC (Base) balance. Gas is sponsored. One POST + one GET.

POST /api/wallet/payoutPolygon · Base · Tron
Read the flow

Lightning ↔ PIX

Issue a BOLT11 invoice; once paid, trigger a BRL payout via PIX. Customers anywhere in the world, recipients in Brazil.

POST /api/lightning/invoiceTrack settlement
Read the flow
Português

Guias de integração em português

Exemplos executáveis de Node.js, segurança de webhooks e conciliação de Pix, com requisitos de cada operação.

Integrar a API Pix com Node.jsValidar webhooks e tratar duplicatasConciliar Pix pela APICriar um link de pagamento Pix
Foundations

Core reference

Authentication

API keys, headers, and how requests are scoped per platform.

Read the guide

KYC

Submit and inspect KYC for end-users. Required for on-ramp and off-ramp.

Read the guide

Account statement

Balances per asset and a paginated list of operations over a window.

Read the guide
Wallet

Move money on user wallets

Wallet get

Read addresses per network and current balances for the API-key user.

Read the guide

Wallet keys

Fetch the protectedSymmetricKey needed for payouts and transfers. Cache once per user.

Read the guide

Wallet transfer

Move USDT to any address on Polygon, Base, or Tron — gas sponsored on EVM.

Read the guide
Ramp

On-ramp & off-ramp

Deposit asset

Convert BRL to Lightning, USDT, USDC, or USDCE and deliver to an address.

Read the guide

Lightning invoice

Issue a Lightning invoice that, once paid, triggers an automatic PIX payout.

Read the guide

Wallet payout

Trigger a PIX payout funded by USDT or USDC — one POST + one GET.

Read the guide
Events

Realtime notifications

Webhooks

Deposits, payouts, and KYC state changes — signed payloads with HMAC verification.

Read the guide