Best practices
Best practices
Collects the patterns that keep an integration running in production: idempotency, pagination, money, security, and errors.
Patterns that save headaches in production. Applied together, they prevent duplicate charges, lost callbacks, and rounding errors in reais as volume grows.
Where to start
| If you are | Start with |
|---|---|
| First integration | Idempotency → Callbacks |
| Multi-store platform / marketplace | Multi-tenant |
| Migrating from another PSP | Money (reais vs cents) |
| Already in prod, refining | Error handling → Checklist |
| Gathering evidence for audit/compliance | Security |