Tutorial
Como receber PIX via API com FlipDepix
2026-03-01 · 6 min de leitura
Guia passo a passo para integrar cobranças PIX programáticas que liquidam DePix na sua carteira Liquid.
1. Criar conta e carteira Liquid
Registre-se na FlipDepix e cadastre um endereço Liquid (lq1…) via painel ou POST /v1/api/wallets. O DePix será enviado a este endereço após confirmação PIX — sem custódia intermediária.
2. Gerar chave de API
No painel Integrações, crie um token Bearer (fdpx_*) com escopo deposit:create e read:transactions. Guarde a chave com segurança — ela não é exibida novamente.
3. Criar cobrança PIX
POST /v1/api/deposit com Idempotency-Key, amountCents, payerTaxId e liquidAddressId. A resposta inclui QR code PIX e depositId para polling ou webhook.
4. Confirmar via webhook
Registre POST /v1/api/webhook-endpoints e valide X-Webhook-Signature (HMAC-SHA256). O evento deposit.confirmed indica DePix enviado on-chain — não dependa só de polling.