# Boas práticas (/docs/pix-processamento/best-practices)



Padrões que economizam dor de cabeça em produção. Aplicados juntos, evitam cobranças duplicadas, perda de callbacks e erros de arredondamento em reais quando o volume cresce.

<QuickLinks>
  <QuickLink href="/docs/pix-processamento/best-practices/idempotency" title="Idempotência" />

  <QuickLink href="/docs/pix-processamento/best-practices/multi-tenant" title="Multi-tenant" />

  <QuickLink href="/docs/pix-processamento/webhooks" title="Callbacks" />

  <QuickLink href="/docs/pix-processamento/best-practices/pagination" title="Paginação" />

  <QuickLink href="/docs/pix-processamento/best-practices/money" title="Dinheiro" />

  <QuickLink href="/docs/pix-processamento/best-practices/security" title="Segurança" />

  <QuickLink href="/docs/pix-processamento/best-practices/errors" title="Tratamento de erros" />

  <QuickLink href="/docs/pix-processamento/best-practices/checklist" title="Checklist de produção" />
</QuickLinks>

## Por onde começar [#por-onde-começar]

| Se você é                                        | Comece por                                                                                                                           |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
| **Primeira integração**                          | [Idempotência](/docs/pix-processamento/best-practices/idempotency) → [Callbacks](/docs/pix-processamento/webhooks)                   |
| **Plataforma multi-loja / marketplace**          | [Multi-tenant](/docs/pix-processamento/best-practices/multi-tenant)                                                                  |
| **Migrando de outro PSP**                        | [Dinheiro](/docs/pix-processamento/best-practices/money) (reais vs centavos)                                                         |
| **Já em prod, refinando**                        | [Tratamento de erros](/docs/pix-processamento/best-practices/errors) → [Checklist](/docs/pix-processamento/best-practices/checklist) |
| **Reunindo evidências pra auditoria/compliance** | [Segurança](/docs/pix-processamento/best-practices/security)                                                                         |

## Visão geral [#visão-geral]

<Mermaid
  chart="`
flowchart TD
  A[&#x22;Integração PayZu&#x22;]
  A --> I[&#x22;Idempotência&#x22;]
  A --> C[&#x22;Callbacks&#x22;]
  A --> E[&#x22;Erros&#x22;]
  A --> S[&#x22;Segurança&#x22;]
  A --> M[&#x22;Multi-tenant&#x22;]
  A --> P[&#x22;Paginação&#x22;]
  A --> D[&#x22;Dinheiro&#x22;]

  click I &#x22;/docs/pix-processamento/best-practices/idempotency&#x22; &#x22;Idempotência com clientReference&#x22;
  click C &#x22;/docs/pix-processamento/webhooks&#x22; &#x22;Handler de webhook&#x22;
  click E &#x22;/docs/pix-processamento/best-practices/errors&#x22; &#x22;424, 4xx, 5xx, 429, timeout&#x22;
  click S &#x22;/docs/pix-processamento/best-practices/security&#x22; &#x22;Token, IP, DICT&#x22;
  click M &#x22;/docs/pix-processamento/best-practices/multi-tenant&#x22; &#x22;virtualAccount&#x22;
  click P &#x22;/docs/pix-processamento/best-practices/pagination&#x22; &#x22;page + limit&#x22;
  click D &#x22;/docs/pix-processamento/best-practices/money&#x22; &#x22;Reais, precisão decimal&#x22;

  style A fill:#14ce71,stroke:#0eb464,color:#ffffff
`"
/>