> ## 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 entrega

> Enfileira novamente uma entrega específica

Enfileira um novo envio da entrega indicada. Envie `Idempotency-Key` para evitar que a mesma solicitação de reenvio seja colocada na fila mais de uma vez.

## 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/cmid_delivery/resend" \
  -H "X-API-Key: zeriq_sua_chave" \
  -H "Idempotency-Key: resend-cmid_delivery-001"

```

## Escopos necessários

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

## 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/{deliveryId}/resend`
* **Autenticação:** `X-API-Key`

## Exemplo de resposta

```json theme={null}
{
  "success": true,
  "message": "Reenvio do webhook enfileirado com sucesso.",
  "data": {
    "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"
    },
    "alreadyQueued": false
  }
}
```

## 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/{deliveryId}/resend
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/{deliveryId}/resend:
    post:
      tags:
        - Webhooks
      summary: Reenviar entrega
      description: >-
        Enfileira novamente uma entrega específica. **Escopo necessário:**
        `webhooks.retry`.
      operationId: resendWebhookDelivery
      parameters:
        - name: deliveryId
          in: path
          required: true
          description: ID da entrega.
          schema:
            type: string
        - name: Idempotency-Key
          in: header
          required: false
          description: Chave para evitar duplicidade do reenvio.
          schema:
            type: string
      responses:
        '202':
          description: Reenvio enfileirado.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse'
              example:
                success: true
                message: Reenvio do webhook enfileirado com sucesso.
                data:
                  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'
                  alreadyQueued: false
        '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.