1. Proceso de Venta
Payday Public API
  • Proceso de Venta
  • Autenticacion y Firma HMAC
  • Proceso de Venta
    • Cotizacion - crear
      POST
    • Referencias - solicitar
      POST
    • Ofertas - previsualizar
      POST
    • Ofertas - seleccionar
      POST
    • Contrato - renderizar
      POST
    • Contrato - firma
      POST
    • Validar ICCID + IMEI
      POST
    • Finalizar venta
      POST
  • Productos
    • Marcas
      GET
    • Modelos y Prefijos por marca
      GET
  • Medios de Notificacion
    • Registrar Webhook para cotizacion
      POST
    • Polling Cotizacion
      GET
    • Historial de Eventos
      GET
  • Eventos Webhook
    • Evento quote.updated
    • reference.requested
    • reference.accepted
    • imei.validated
    • contract.signed
    • offer.selected
    • offer.previewed
  1. Proceso de Venta

Contrato - firma

POST
https://integrations.paydaymx.com/public-api/v1/sales-process/cotizaciones/{COTIZACION_ID}/contrato/firma
Registra la evidencia minima de firma del contrato para permitir que la cotizacion avance a validacion de IMEI.
Esta ruta guarda la evidencia de que el cliente acepto y firmo el contrato. El backend registra la informacion necesaria para auditoria y avanza la cotizacion hacia el tramo de validacion de linea y equipo.
Que recibe
Parametro de ruta:
1.
id: ObjectId de la cotizacion.
No recibe query params.
Body:
1.
contrato_base64: string opcional.
2.
firmado_en: datetime opcional.
3.
contrato_texto: objeto opcional.
4.
source: string opcional.
El body debe incluir al menos una evidencia minima entre contrato_base64, firmado_en o contrato_texto.
Que devuelve
1.
cotizacion actualizada.
2.
contrato.firmado
3.
contrato.signed_at
Cuando usarla
Usala inmediatamente despues de que el cliente revise y acepte el contrato renderizado.
Reglas y consideraciones
1.
Solo puede usarse cuando la cotizacion esta en etapa contrato.
2.
ip_firma no debe enviarse; el backend la toma de la request.
3.
El evento contract.signed queda registrado en el proceso.
Errores frecuentes
1.
409 si la cotizacion no esta en etapa contrato.
2.
422 si no se envia evidencia minima de firma.

Solicitud

Autorización
Agregar parámetro en header
X-Api-Key
Ejemplo:
X-Api-Key: ********************
Parámetros de ruta

Parámetros de Header

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢200Éxito
application/json
Bodyapplication/json

Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location 'https://integrations.paydaymx.com/public-api/v1/sales-process/cotizaciones/69fa7b48e65c5ec021a8aeb0/contrato/firma' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Signature;' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "contrato_base64": "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
Respuesta Ejemplo de Respuesta
{}
Modificado en 2026-05-08 18:22:42
Anterior
Contrato - renderizar
Siguiente
Validar ICCID + IMEI
Built with