Referencias - solicitar - Payday Public API

Solicita una referencia para la cotizacion actual y deja el flujo esperando confirmacion.

Esta ruta envia una solicitud de referencia para que un tercero confirme o rechace la referencia del cliente. Es un paso obligatorio antes de pasar a ofertas cuando la cotizacion aun no cumple el minimo de referencias aceptadas.

Que recibe

Parametro de ruta:

id: ObjectId de la cotizacion.

No recibe query params.

Body:

telefono: string requerida.

referencia: string requerida.

bodyVariables: arreglo opcional de strings para la plantilla.

Que devuelve

cotizacion: resumen actualizado.

referencia: objeto con id, estado y telefono enmascarado.

Cuando usarla

Usala despues de que la cotizacion termine identidad/buro y el proceso permita avanzar a referencias.

Reglas y consideraciones

Solo puede usarse cuando la cotizacion esta en etapa referencias.

Si se usa fuera de etapa, la respuesta esperada es 409.

El telefono se normaliza automaticamente con prefijo 52.

No se puede repetir el mismo telefono dentro de la misma cotizacion.

El minimo actual para pasar a ofertas es al menos una referencia aceptada.

Errores frecuentes

409 si la cotizacion no esta en etapa referencias.

422 si faltan campos requeridos o si el telefono es invalido.

curl --location 'https://integrations.paydaymx.com/public-api/v1/sales-process/cotizaciones/69fa7b48e65c5ec021a8aeb0/referencias' \ --header 'X-Timestamp;' \ --header 'X-Nonce;' \ --header 'X-Signature;' \ --header 'X-Api-Key: <api-key>' \ --header 'Content-Type: application/json' \ --data '{ "telefono": "5568726342", "referencia": "Maria Lopez", "bodyVariables": ["Guillermo Gutierrez"] }'

{ "cotizacion": { "id": "69e8ef5ab9ba4c3ba47ba54d", "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": "67fd2dc8-1318-4013-b158-a5097e4659c8", "url": "https://01kpttzjwecx2tdkf61m2sxzjx.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-04-22T16:15:05.074Z", "updated_at": "2026-04-22T16:15:05.074Z" } }

Referencias - solicitar

Solicitud

Respuestas