Eventos que te hemos enviado

GET/eventsProbar

ServidorURL base

API key x-api-keyRecordar la clave en este navegador (localStorage, no sale de aquí)

Parámetros de consultastatuspending | published | deadeventTypepayment.settled | payment.failed | payment.reversedlimitintegercursorstringid numérico del evento

La llamada la hace tu navegador, contra el servidor que elijas arriba. Si la documentación no está servida desde el mismo origen que la API, el navegador puede bloquear la respuesta por CORS: en ese caso abre estas páginas desde la propia API (/docs) o usa el curl de arriba.

GET

/events

const url = 'http://localhost:3000/v1/events?status=pending&eventType=payment.settled&limit=25';
const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'http://localhost:3000/v1/events?status=pending&eventType=payment.settled&limit=25' \
  --header 'x-api-key: <x-api-key>'

Scope events:read. El registro de cada webhook que te hemos mandado y cómo fue su entrega.

La entrega es at-least-once: deduplica por el id del cuerpo. status=dead es tu cola de fallidos — lo que no conseguimos entregarte tras 12 intentos, que no se pierde ni se marca como entregado.

El listado NO incluye payload: para verlo, pide el evento por su id. Aquí el cursor es el id numérico del evento, no el cursor de /payments ni el de /beneficiaries.

Authorizations

ApiKeyAuth

Parameters

Query Parameters

status

string

Allowed values: pending published dead

eventType

string

Allowed values: payment.settled payment.failed payment.reversed

limit

integer

default: 25 >= 1 <= 100

cursor

string

Id numérico del evento

Responses

200

Página de eventos

application/json

object

data

Array<object>

object

has_more

boolean

next_cursor

string

nullable

data

Array<object>

Registro de un webhook que te hemos enviado.

object

Deduplica por esto. También viaja en la cabecera x-event-id

string

event_type

string

Allowed values: payment.settled payment.failed payment.reversed

aggregate_type

string

aggregate_id

string format: uuid

status

dead = tu cola de fallidos, reentregable

string

Allowed values: pending published dead

attempts

integer

last_error

string

nullable

next_attempt_at

string format: date-time

nullable

published_at

string format: date-time

nullable

dead_at

string format: date-time

nullable

created_at

string format: date-time

Example

{
  "data": [
    {
      "id": "40545",
      "event_type": "payment.settled",
      "aggregate_type": "payment",
      "aggregate_id": "89920401-26da-4f69-b57d-bc20e0366ce2",
      "status": "published",
      "attempts": 3,
      "last_error": null,
      "next_attempt_at": null,
      "published_at": "2026-08-31T19:06:52.004Z",
      "dead_at": null,
      "created_at": "2026-08-31T19:06:44.120Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}