Registrar Webhook para cotizacion

Registra o actualiza un webhook para recibir notificaciones del proceso de una cotizacion.

Esta ruta permite que la integracion reciba cambios del flujo sin hacer polling constante. Los webhooks se registran por cotizacion y pueden limitarse a eventos especificos o escuchar todos los eventos disponibles.

Que recibe

Parametro de ruta:

id: ObjectId de la cotizacion.

No recibe query params.

Body:

url: string requerida, debe ser URL valida.

secret: string opcional. Si se envia, debe tener longitud minima valida.

events: arreglo opcional de eventos. Si no se envia, el backend puede usar ['*'].

active: boolean opcional. Default true.

Que devuelve

cotizacion.id

cotizacion.process

webhook: objeto con id, url, events, active, created_at y updated_at.

Cuando usarla

Usala justo despues de crear la cotizacion si tu integracion quiere enterarse de los cambios por callback en vez de depender solo de polling.

Reglas y consideraciones

Si ya existe un webhook con la misma URL o id, el backend lo actualiza.

El webhook queda asociado a la cotizacion, no a toda la empresa.

secret vacio se trata como omitido.

Errores frecuentes

422 si la URL no es valida.

404 si la cotizacion no existe.

curl --location 'https://integrations.paydaymx.com/public-api/v1/sales-process/cotizaciones/69fa7b48e65c5ec021a8aeb0/notificaciones/webhooks' \ --header 'X-Timestamp;' \ --header 'X-Nonce;' \ --header 'X-Signature;' \ --header 'X-Api-Key: <api-key>' \ --header 'Content-Type: application/json' \ --data '{ "url": "https://01kqx7hkx5ad6d3y4wr7bcvddg.hooks.webhookrelay.com", "events": [ "quote.created", "quote.updated", "reference.requested", "reference.accepted", "reference.rejected", "offer.previewed", "offer.selected", "contract.signed", "imei.validated" ], "active": true }'

{ "cotizacion": { "id": "69fa7b48e65c5ec021a8aeb0", "process": { "state": "waiting", "next_action": "wait_identity_validation", "pause_reason": "identity_validation_pending", "can_continue": false, "checkpoints": { "referencias_validadas": false, "oferta_seleccionada": false, "contrato_firmado": false, "imei_validado": false } } }, "webhook": { "id": "5b144e25-ac1f-4309-8c84-26c5ee423772", "url": "https://01kqx7hkx5ad6d3y4wr7bcvddg.hooks.webhookrelay.com", "events": [ "quote.created", "quote.updated", "reference.requested", "reference.accepted", "reference.rejected", "offer.previewed", "offer.selected", "contract.signed", "imei.validated" ], "active": true, "created_at": "2026-05-05T23:29:31.958Z", "updated_at": "2026-05-05T23:29:31.958Z" } }

Registrar Webhook para cotizacion

Solicitud

Respuestas