Modelo de identidade

​

Campos centrais

​

Regras de refund (crítico)

Para devolver um recebimento, o path é: POST /api/pix/refund-in/{id} onde {id} é o id (UUID) do cash-in retornado em POST /api/pix/cash-in, não o transactionId do parceiro. Para consultar um refund-in após a criação, use o UUID do refund em GET /api/pix/refund/{id} (ver documentação de detalhe).

​

O que persistir (recomendação operacional)

1. Sempre o id (UUID) retornado no 201 de cada recurso.
2. O externalId que você enviou (cópia de negócio).
3. transactionId e endToEndId quando retornados ou presentes no webhook, para rastreio e conciliação com o parceiro.
4. Em devoluções parciais, o id do refund-in (via 201 de refund-in ou GET de lista) para auditoria e deduplicação de eventos de estorno.

​

Implicações

​

Referência

• Ciclo de vida
• Assumir PENDING/PAID corretamente