Tutorial
How to receive PIX via API with FlipDepix
2026-03-01 · 6 min read
Step-by-step guide to integrate programmatic PIX charges that settle DePix in your Liquid wallet.
1. Create account and Liquid wallet
Sign up on FlipDepix and register a Liquid address (lq1…) via dashboard or POST /v1/api/wallets. DePix will be sent to this address after PIX confirmation — no intermediary custody.
2. Generate API key
In Integrations, create a Bearer token (fdpx_*) with deposit:create and read:transactions scopes. Store the key securely — it is shown only once.
3. Create PIX charge
POST /v1/api/deposit with Idempotency-Key, amountCents, payerTaxId and liquidAddressId. Response includes PIX QR code and depositId for polling or webhook.
4. Confirm via webhook
Register POST /v1/api/webhook-endpoints and validate X-Webhook-Signature (HMAC-SHA256). deposit.confirmed event indicates DePix sent on-chain — don't rely on polling alone.