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"
{
"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
}
}
Entregas e Reenvios
Reenviar entrega
Enfileira novamente uma entrega específica
POST
/
v1
/
webhooks
/
deliveries
/
{deliveryId}
/
resend
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"
{
"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
}
}
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 exigemX-API-Key com uma chave que começa com zeriq_.
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-Keyem 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
{
"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 retornaitems 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.