# Callbacks (entregas) (/docs/pix-processamento/endpoints/callbacks)



A PayZu envia callbacks automaticamente conforme as transações mudam de status. Esses endpoints servem para **inspecionar o histórico** e **reenviar** quando o seu lado falhou em receber.

<QuickLinks>
  <QuickLink href="/docs/pix-processamento/endpoints/callbacks/get_user_callbacks" title="Listar callbacks" method="GET" path="/user/callbacks" />

  <QuickLink href="/docs/pix-processamento/endpoints/callbacks/get_user_callback_by_id" title="Detalhe do callback" method="GET" path="/user/callbacks/{id}" />

  <QuickLink href="/docs/pix-processamento/endpoints/callbacks/resend_user_callback_single" title="Reenviar transação" method="POST" path="/user/callbacks/resend/{transactionId}" />

  <QuickLink href="/docs/pix-processamento/endpoints/callbacks/resend_user_callbacks" title="Reenviar em lote" method="POST" path="/user/callbacks/resend" />
</QuickLinks>

## Quando usar cada um [#quando-usar-cada-um]

| Pergunta                                                     | Endpoint                                                                                                                 |
| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| Quais callbacks foram tentados para minhas transações?       | [`GET /user/callbacks`](/docs/pix-processamento/endpoints/callbacks/get_user_callbacks)                                  |
| Qual foi o status code e response body desse callback?       | [`GET /user/callbacks/{id}`](/docs/pix-processamento/endpoints/callbacks/get_user_callback_by_id)                        |
| Meu endpoint estava fora, reenvia o callback dessa transação | [`POST /user/callbacks/resend/{transactionId}`](/docs/pix-processamento/endpoints/callbacks/resend_user_callback_single) |
| Reenvia callbacks de várias transações de uma vez            | [`POST /user/callbacks/resend`](/docs/pix-processamento/endpoints/callbacks/resend_user_callbacks)                       |

## Exemplos [#exemplos]

<Accordions type="single">
  <Accordion title="GET /user/callbacks, histórico paginado">
    ```bash
    curl "https://api.payzu.processamento.com/v1/user/callbacks?page=1&limit=50" \
      -H "Authorization: Bearer $TOKEN" \
      -H "Content-Type: application/json"
    ```
  </Accordion>

  <Accordion title="POST /user/callbacks/resend/{transactionId}, reenviar uma">
    ```bash
    curl -X POST "https://api.payzu.processamento.com/v1/user/callbacks/resend/PAYZU20251123104518DF75D20A8F" \
      -H "Authorization: Bearer $TOKEN" \
      -H "Content-Type: application/json"
    ```
  </Accordion>

  <Accordion title="POST /user/callbacks/resend, reenvio em lote">
    ```bash
    curl -X POST "https://api.payzu.processamento.com/v1/user/callbacks/resend" \
      -H "Authorization: Bearer $TOKEN" \
      -H "Content-Type: application/json" \
      -d '{
        "transactionIds": [
          "PAYZU20251123104518DF75D20A8F",
          "PAYZU20251123113207E51D67F2A3"
        ]
      }'
    ```
  </Accordion>
</Accordions>

## Fluxo de auditoria [#fluxo-de-auditoria]

<Mermaid
  chart="`
flowchart LR
  A[&#x22;Suspeita de callback perdido&#x22;] --> B[&#x22;GET /user/callbacks?clientReference=...&#x22;]
  B --> C[&#x22;GET /user/callbacks/{id}&#x22;]
  C --> D{&#x22;Status code?&#x22;}
  D -->|2xx| E[&#x22;Entrega confirmada&#x22;]
  D -->|4xx/5xx ou erro| F[&#x22;POST /resend/{transactionId}&#x22;]

  click B &#x22;/docs/pix-processamento/endpoints/callbacks/get_user_callbacks&#x22; &#x22;Listar callbacks&#x22;
  click C &#x22;/docs/pix-processamento/endpoints/callbacks/get_user_callback_by_id&#x22; &#x22;Detalhe&#x22;
  click F &#x22;/docs/pix-processamento/endpoints/callbacks/resend_user_callback_single&#x22; &#x22;Reenviar&#x22;

  style E fill:#14ce71,stroke:#0eb464,color:#ffffff
  style F fill:#f59e0b,stroke:#d97706,color:#ffffff
`"
/>

## Tutoriais e boas práticas [#tutoriais-e-boas-práticas]

<QuickLinks>
  <QuickLink href="/docs/pix-processamento/webhooks" title="Webhooks (referência)" />

  <QuickLink href="/docs/pix-processamento/best-practices/callbacks" title="Lidando com callbacks" />

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