Eventos de reconciliación

GET /api/v1/events — histórico de eventos de negocio para reconciliar lo que recibiste por webhook con la API.

Cómo funciona

Cada evento tiene un id determinístico (evt_...) que es exactamente el mismo que se envía firmado en los webhooks salientes (header vexorpay-Event-Id). Por eso puedes:

1. Recibir un webhook payment.completed con evt_abc.
2. Si tienes dudas o se perdió el POST, consultar GET /api/v1/events y encontrar el mismo evt_abc.
3. Deduplicar: procesar cada evt_ una sola vez.

Los eventos de ventas de Polar (payment.completed, payment.refunded, payment.disputed) y de retiros de Polar (payout.paid) se pueden reconstruir desde la API en orden cronológico descendente.

Request

GET /api/v1/events

Parámetros

Ejemplo

curl "https://api.vexorpay.com/api/v1/events?type=payment.completed&limit=5" \
  -H "Authorization: Bearer vxp_live_tu_clave"

Respuesta exitosa

200 OK

{
  "data": [
    {
      "id": "evt_6c2314a4fb4a408c07c2",
      "type": "payment.completed",
      "created": "2026-01-02T12:05:00.000Z",
      "sandbox": false,
      "data": {
        "object": {
          "charge": {
            "id": "67f1c1e2c8a4b0d1f2e3a4b5",
            "provider": "polar",
            "reference": "ORD-1001",
            "metadata": null,
            "polarOrderId": "59f4a98b-7034-437d-92b7-f463758ba69f",
            "polarCheckoutId": "8150f7d1-6404-48c2-8797-842e71a500ad",
            "amountCents": 1900,
            "currency": "usd",
            "status": "paid",
            "sandbox": false,
            "refundedCents": 0,
            "paidAt": "2026-01-02T12:05:00.000Z"
          },
          "payment_link": {
            "id": "66f1c1e2c8a4b0d1f2e3a4b5",
            "slug": "a1b2c3d4e5",
            "title": "Ebook UX en 30 días",
            "reference": "CATALOGO-UX"
          }
        }
      }
    }
  ],
  "has_more": false,
  "total_count": 1,
  "url": "/v1/events?limit=5"
}

El objeto dentro de data.object tiene la misma forma que el payload del webhook (charge + payment_link, o payout), más el campo sandbox —presente tanto en el evento raíz como dentro de charge—. charge.id es el id de la venta en GET /api/v1/orders/{id}, amountCents es el total que pagó el comprador y refundedCents lo reembolsado. charge.reference es tu referencia de la venta y payment_link.reference la del link. En payout.paid, payout es el retiro de Polar (misma forma que en Retiros).

Errores