Registrar un webhook
curl -X POST https://faktura-test.cgallardo.me/v1/webhooks \ -H "Authorization: Bearer sk_test_..." \ -H "Content-Type: application/json" \ -d '{ "url": "https://erp.miempresa.pe/faktura/webhook", "events": ["document.accepted", "document.rejected"] }'use Illuminate\Support\Facades\Http;
$response = Http::withToken('sk_test_...') ->post('https://faktura-test.cgallardo.me/v1/webhooks', [ 'url' => 'https://erp.miempresa.pe/faktura/webhook', 'events' => ['document.accepted', 'document.rejected'], ]);
$data = $response->json();const response = await fetch('https://faktura-test.cgallardo.me/v1/webhooks', { method: 'POST', headers: { Authorization: 'Bearer sk_test_...', 'Content-Type': 'application/json', }, body: JSON.stringify({ url: 'https://erp.miempresa.pe/faktura/webhook', events: ['document.accepted', 'document.rejected'], }),});const data = await response.json();Método: POST
Endpoint
Sección titulada «Endpoint»POST https://faktura-test.cgallardo.me/v1/webhooksPOST https://faktura.cgallardo.me/v1/webhooks| Campo | Obligatorio | Descripción |
|---|---|---|
url |
Sí | HTTPS, accesible desde internet, sin usuario ni contraseña en la URL. |
events |
No | Lista de eventos; si se omite, recibe todos. |
Respuesta 201 Created
Sección titulada «Respuesta 201 Created»{ "id": "01a1d6b2-4c1e-7f30-9a2b-5d8e7c6b1a00", "url": "https://erp.miempresa.pe/faktura/webhook", "events": ["document.accepted", "document.rejected"], "is_active": true, "created_at": "2026-11-13T22:00:00+00:00", "secret": "whsec_3f9c…"}Guarda el secret: solo se muestra esta vez. Sirve para verificar la firma de cada aviso.
Errores
Sección titulada «Errores»| Estado | reason |
Causa |
|---|---|---|
409 |
TooManyWebhooks |
Tu empresa ya tiene 10 endpoints, el máximo. Elimina uno antes de registrar otro. |
422 |
InvalidWebhookUrl |
La URL no es HTTPS, lleva usuario o contraseña, o apunta a una red privada. |
422 |
ValidationFailed |
Falta url o events trae un evento desconocido. |
Los eventos y el formato del aviso están en Cómo funcionan los webhooks.