Listar entregas

GEThttps://api.copayex.com/api/v1/webhooks/deliveries

Parámetros de solicitud

Campo	Tipo	Ubicación	Requerido	Descripción
`subscriptionId`	string	Query	No	ID (string convertible a number).
`status`	`"pending" \| "ok" \| "fail" \| "max_retries_reached"`	Query	No	Estado de entrega.

Estados:

pending: encolado para reintento.
ok: confirmado por el receptor.
fail: último intento falló pero quedan reintentos.
max_retries_reached: agotó reintentos automáticos.

Parámetros de respuesta

Devuelve una lista de entregas ([{ ... }]) con estos campos:

Campo	Tipo	Descripción
`id`	string	Identificador del delivery.
`subscriptionId`	number	Suscripción a la que corresponde.
`eventId`	number	Evento que disparó el delivery.
`attempt`	number	Número de intento actual.
`status`	`"pending" \| "ok" \| "fail" \| "max_retries_reached"`	Estado del delivery.
`nextAttemptAt`	string \| null	Fecha del próximo intento automático, `null` si no habrá más.
`createdAt`	string (ISO8601)	Timestamp de creación.
`attempts`	Attempt[]	Historial de intentos para el mismo delivery.

Tabla de Attempt:

Campo	Tipo	Descripción
`attempt`	number	Número de intento (1, 2, …).
`status`	`"fail" \| "ok"`	Resultado del intento.
`responseCode`	number \| null	Código HTTP devuelto por el receptor.
`errorMessage`	string \| null	Detalle del error; si no está vacío, indica qué falló.
`requestBody`	object	JSON enviado en ese intento (incluye `type`, datos del evento, etc.).
`responseBody`	object \| null	Cuerpo devuelto por el receptor, si aplica.
`durationMs`	number	Duración del intento en milisegundos.
`nextAttemptAt`	string \| null	Fecha programada para el siguiente intento.
`createdAt`	string (ISO8601)	Timestamp del intento.

Ejemplos de solicitud

curl -G "https://api.copayex.com/api/v1/webhooks/deliveries" \
  -H "Authorization: Bearer <client_access_token>" \
  --data-urlencode "status=pending"

const response = await fetch(
  "https://api.copayex.com/api/v1/webhooks/deliveries",
  {
    method: "GET",
    headers: {
      Authorization: "Bearer <client_access_token>",
    },
  }
);
 
const data = await response.json();
console.log(data);

import requests
 
headers = {
    "Authorization": "Bearer <client_access_token>"
}
 
response = requests.get(
    "https://api.copayex.com/api/v1/webhooks/deliveries",
    params={"status": "pending"},
    headers=headers,
    timeout=10,
)
response.raise_for_status()
print(response.json())

Respuesta de ejemplo

[
  {
    "id": "27",
    "subscriptionId": 5,
    "eventId": 23,
    "attempt": 2,
    "status": "fail",
    "nextAttemptAt": "2025-11-11T21:53:45.000Z",
    "createdAt": "2025-11-12T00:50:36.613Z",
    "attempts": [
      {
        "deliveryId": "27",
        "subscriptionId": 5,
        "attempt": 2,
        "status": "fail",
        "responseCode": null,
        "errorMessage": "Error; connect ECONNREFUSED ::1:3443; connect ECONNREFUSED 127.0.0.1:3443",
        "requestBody": {
          "data": {
            ...
          },
          "type": "payments.item.partial_payment",
          "version": "1.0",
          "occurredAt": "2025-11-11T21:50:36.605Z"
        },
        "responseBody": null,
        "durationMs": 8,
        "nextAttemptAt": "2025-11-11T21:53:45.000Z",
        "createdAt": "2025-11-12T00:51:41.075Z"
      },
      {
    ...
      }
    ]
  }
]

Eliminar suscripción Reintentar entrega