> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeriqpay.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Reenviar falhas

> Enfileira novamente entregas com falha

Processa as entregas com status `FAILED` que correspondem aos filtros informados. Use `maxItems` para limitar a quantidade processada em cada solicitação.

## Autenticação

Todas as rotas exigem `X-API-Key` com uma chave que começa com `zeriq_`.

```bash cURL theme={null}
curl -X POST "https://api.zeriqpay.com.br/v1/webhooks/deliveries/resend-failed?maxItems=20&event=payment.failed" \
  -H "X-API-Key: zeriq_sua_chave"

```

## Escopos necessários

* Listagem e consulta: `webhooks.read`
* Reenvio individual ou em lote: `webhooks.retry`

## Filtros

`page`, `limit`, `status`, `event`, `dateFrom`, `dateTo`, `endpointId` e `search` podem ser usados nas rotas de listagem. O reenvio em lote também aceita `maxItems`.

## Boas práticas

* Responda rapidamente ao webhook original e processe o evento de forma idempotente.
* Consulte os detalhes da entrega antes de reenviar quando a causa da falha não estiver clara.
* Use `Idempotency-Key` em reenvios manuais e persista o resultado retornado.
* Reenvie somente depois de corrigir a causa da falha no seu endpoint.

## Referência

* **Método:** `POST`
* **Rota:** `/v1/webhooks/deliveries/resend-failed`
* **Autenticação:** `X-API-Key`

## Exemplo de resposta

```json theme={null}
{
  "success": true,
  "message": "Reenvio das falhas processado.",
  "data": {
    "requested": 1,
    "queued": 1,
    "items": [
      {
        "originalDeliveryId": "cmid_delivery",
        "status": "QUEUED",
        "delivery": {
          "id": "cmid_replay",
          "endpointId": "cmid_webhook",
          "userId": "cmid_user",
          "transactionId": "cmid_transaction",
          "event": "payment.failed",
          "status": "PENDING",
          "payload": {
            "id": "evt_123",
            "event": "payment.failed",
            "createdAt": "2026-10-28T12:00:00.000Z",
            "data": {}
          },
          "response": {
            "status": 500,
            "body": "upstream error",
            "error": "HTTP 500"
          },
          "attempts": 0,
          "lastAttemptAt": null,
          "lastResponseStatus": null,
          "lastResponseBody": null,
          "lastError": null,
          "deliveredAt": null,
          "replayedFromDeliveryId": "cmid_delivery",
          "replayReason": "MANUAL",
          "createdAt": "2026-10-28T12:03:00.000Z",
          "updatedAt": "2026-10-28T12:03:00.000Z"
        }
      }
    ]
  }
}
```

## Respostas

A operação de listagem retorna `items` e `pagination`. A consulta detalhada também retorna `payload`, `response` e `attempts`. As rotas de reenvio respondem com HTTP `202` porque a entrega é colocada em fila para processamento assíncrono.

A referência OpenAPI abaixo contém parâmetros, exemplos de request e response e códigos de erro.


## OpenAPI

````yaml POST /v1/webhooks/deliveries/resend-failed
openapi: 3.1.0
info:
  title: ZeriqPay API
  description: >-
    Referência da API v1 da ZeriqPay. As rotas de gerenciamento de webhooks não
    fazem parte desta documentação.
  version: 1.0.0
  contact:
    name: ZeriqPay
    url: https://api.zeriqpay.com.br
servers:
  - url: https://api.zeriqpay.com.br
    description: Produção
security:
  - apiKeyAuth: []
tags:
  - name: Conta
    description: Dados, taxas e limites da conta
  - name: Pagamentos PIX
    description: Cobranças PIX
  - name: Transações
    description: Consulta de transações
  - name: Transferências
    description: Saídas PIX, cripto e internas
  - name: Reembolsos
    description: Reembolsos de cobranças
  - name: Disputas MED
    description: Consulta e envio de evidências MED
  - name: Webhooks
    description: Cadastro e configuração dos endpoints de webhook
paths:
  /v1/webhooks/deliveries/resend-failed:
    post:
      tags:
        - Webhooks
      summary: Reenviar falhas
      description: >-
        Enfileira novamente entregas com status FAILED. **Escopo necessário:**
        `webhooks.retry`.
      operationId: resendFailedWebhooks
      parameters:
        - name: page
          in: query
          required: false
          description: Página iniciando em 1.
          schema:
            type: string
        - name: limit
          in: query
          required: false
          description: Quantidade por página, de 1 a 100.
          schema:
            type: integer
        - name: status
          in: query
          required: false
          description: PENDING, DELIVERED ou FAILED.
          schema:
            type: string
        - name: event
          in: query
          required: false
          description: Evento do webhook.
          schema:
            type: string
        - name: dateFrom
          in: query
          required: false
          description: Data inicial ISO 8601.
          schema:
            type: string
        - name: dateTo
          in: query
          required: false
          description: Data final ISO 8601.
          schema:
            type: string
        - name: endpointId
          in: query
          required: false
          description: Filtra por endpoint.
          schema:
            type: string
        - name: search
          in: query
          required: false
          description: Busca textual.
          schema:
            type: string
        - name: maxItems
          in: query
          required: false
          description: Máximo de falhas processadas, de 1 a 100.
          schema:
            type: integer
      responses:
        '202':
          description: Reenvios processados.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
              example:
                success: true
                message: Reenvio das falhas processado.
                data:
                  requested: 1
                  queued: 1
                  items:
                    - originalDeliveryId: cmid_delivery
                      status: QUEUED
                      delivery:
                        id: cmid_replay
                        endpointId: cmid_webhook
                        userId: cmid_user
                        transactionId: cmid_transaction
                        event: payment.failed
                        status: PENDING
                        payload:
                          id: evt_123
                          event: payment.failed
                          createdAt: '2026-10-28T12:00:00.000Z'
                          data: {}
                        response:
                          status: 500
                          body: upstream error
                          error: HTTP 500
                        attempts: 0
                        lastAttemptAt: null
                        lastResponseStatus: null
                        lastResponseBody: null
                        lastError: null
                        deliveredAt: null
                        replayedFromDeliveryId: cmid_delivery
                        replayReason: MANUAL
                        createdAt: '2026-10-28T12:03:00.000Z'
                        updatedAt: '2026-10-28T12:03:00.000Z'
        '401':
          description: API Key ausente ou inválida
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
        '403':
          description: Escopo insuficiente
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
        '404':
          description: Entrega ou endpoint não encontrado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
        '429':
          description: Limite da rota excedido
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
      security:
        - apiKeyAuth: []
components:
  schemas:
    GenericResponse:
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
        data:
          type: object
          additionalProperties: true
      required:
        - success
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: API Key ZeriqPay iniciada por `zeriq_`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.