Eventos de reconciliación

GET /api/v1/events — histórico de eventos de negocio, estilo Stripe, 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 podés:

1. Recibir un webhook payment.completed con evt_abc.
2. Si tenés 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 cobros (payment.completed, payment.failed, payment.refunded, payment.disputed) y de retiros (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_u_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",
            "reference": "ORD-1001",
            "amountCents": 1900,
            "currency": "usd",
            "status": "paid",
            "sandbox": false,
            "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—. En eventos payment.refunded se agregan refundedCents y recoveredCents, y en payment.disputed el objeto dispute (status, outcome, amountCents).

Errores