Emitir un fixture de webhook | Documentación API de Recurrente

Persiste una Activity de prueba y entrega el evento por la misma aplicación Svix del Sandbox autenticado. Acepta cualquier tipo del catálogo público y es útil para validar firmas, routing, reintentos e idempotencia del consumer.

La respuesta contiene el payload base normalizado. Recurrente genera y reemplaza los campos reservados data.id y data.created_at, aunque el request envíe otros valores. La entrega Svix agrega data.event_type y data.sandbox_id como contexto estándar.

El fixture no crea el grafo de dominio del evento. Por ejemplo, dispute.create entrega el contrato del webhook, pero no crea una disputa ni movimientos financieros. Para validar comportamiento end-to-end, ejecuta el flujo real y observa sus webhooks naturales.

Este endpoint solo existe para llaves de Sandboxes nombrados. Una llave LIVE recibe 404 para evitar que una suite de pruebas emita fixtures en producción.

Persiste una `Activity` de prueba y entrega el evento por la misma aplicación Svix del Sandbox autenticado. Acepta cualquier tipo del catálogo público y es útil para validar firmas, routing, reintentos e idempotencia del consumer. La respuesta contiene el payload base normalizado. Recurrente genera y reemplaza los campos reservados `data.id` y `data.created_at`, aunque el request envíe otros valores. La entrega Svix agrega `data.event_type` y `data.sandbox_id` como contexto estándar. El fixture no crea el grafo de dominio del evento. Por ejemplo, `dispute.create` entrega el contrato del webhook, pero no crea una disputa ni movimientos financieros. Para validar comportamiento end-to-end, ejecuta el flujo real y observa sus webhooks naturales. Este endpoint solo existe para llaves de Sandboxes nombrados. Una llave LIVE recibe `404` para evitar que una suite de pruebas emita fixtures en producción.

Authentication

X-SECRET-KEYstring

Tu clave secreta de API.

Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.

Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.

Tu clave secreta de API. Una llave de cuenta (`sk_live_...`, `sk_test_...`) opera sobre su propia cuenta y, con `X-ACCOUNT-ID`, sobre sus cuentas conectadas. Una llave de organización (`sk_org_live_...`, `sk_org_test_...`) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con `X-ACCOUNT-ID`; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde `403` con `code: organization_key_unsupported`.

Request

This endpoint expects an object.

event_typeenumRequired

Tipo de evento publicado que debe emitir el fixture.

datamap from strings to anyOptionalDefaults to {}

Campos del payload de prueba. Recurrente reemplaza id y created_at con la identidad y fecha persistidas del fixture.

Response

Fixture persistido y encolado para entrega

idstringformat: "^swe_"

event_typeenum

Tipo de evento publicado que debe emitir el fixture.

datamap from strings to any

Payload base normalizado, incluidos id y created_at. La entrega Svix agrega event_type y sandbox_id.

created_atdatetime

Errors

400

Bad Request Error

404

Not Found Error

422

Unprocessable Entity Error

Este endpoint solo existe para llaves de Sandboxes nombrados. Una llave LIVE recibe 404 para evitar que una suite de pruebas emita fixtures en producción.

$	curl -X POST https://app.recurrente.com/api/test_helpers/webhook_events \
>	-H "X-SECRET-KEY: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"event_type": "dispute.create",
>	"data": {
>	"status": "needs_response",
>	"integration_case": "chargeback-v1"
>	}
>	}'

1	{
2	"id": "swe_abc123",
3	"event_type": "dispute.create",
4	"data": {
5	"status": "needs_response",
6	"integration_case": "chargeback-v1",
7	"id": "swe_abc123",
8	"created_at": "2026-07-21T18:30:00Z"
9	},
10	"created_at": "2026-07-21T18:30:00Z"
11	}