Skip to content

Blog

Pix via API: best practices for real-time reconciliation

Webhook patterns, idempotency, and event handling.

Pix (Brazil's instant payment system) changed how we reconcile payments: instead of batch files, we work with real-time events via webhooks.

Idempotency

Always handle each event with a unique key (endToEndId). Webhooks can be redelivered, and your system needs to absorb duplicates without double-counting.

Redelivery and queueing

  • Respond 2xx quickly and process asynchronously.
  • Implement retry with exponential backoff.
  • Keep an auditable log of every event received.

Ready to evaluate your case?

In a conversation with Baasic specialists, we assess the technical, regulatory, and commercial viability of embedded finance in your product.