API & endpoints

Las cinco operaciones del producto Cyber Pro están validadas en integración. La API Ubiqs expone la capa simplificada; las operaciones financieras hablan directamente con la API del INS.

5 endpointsOpenAPI 3.0.3

Inventario de operaciones

POSTCOTIVALIDATEDUbiqs API

Cotización/cyberpro/v1 (action=COTI)

Cotiza el seguro Cyber Pro y devuelve los 4 planes con primas en CRC o USD y frecuencias Anual/Semestral/Trimestral/Mensual. Resuelve ubicación por nombre o código.

POSTEMIVALIDATEDUbiqs API

Emisión/cyberpro/v1 (action=EMI)

Emite la póliza Cyber Pro. Requiere consentimiento informado verbatim del cliente (consent.accepted=true + version + timestamp).

POSTPAGOVALIDATEDINS API

Cargo a Tarjeta/comercioelectronico/v1/pagos/cargotarjeta

Cobra el premio de la póliza con encriptación RSA PKCS1 v1.5 (2048-bit) campo por campo. Retorna NumeroAutorizacion + ConsecutivoPago.

POSTDEUDA_APLICARVALIDATEDINS API

Aplicar Deuda/cyberpro/v1 (action=DEUDA_APLICAR)

Registra la deuda asociada a la póliza con el ConsecutivoPago. Devuelve consecutivoDeuda y esAprobada=true cuando es aceptada.

POSTDEUDA_ESTADOVALIDATEDINS API

Estado de Deuda/cyberpro/v1 (action=DEUDA_ESTADO)

Consulta el estado asíncrono de la deuda registrada. CodEstado=2 indica pendiente; CodEstado=00 indica aplicada en transaccional.

Autenticación y seguridad

Capas de autenticación encadenadas para cada llamada al producto.

Canal → Ubiqs

x-api-key

Secreto único por canal (web, móvil, WhatsApp, voz). Rotable sin downtime.

Ubiqs → INS

OAuth2 client_credentials

Bearer token con expiración dinámica (expires_in), refresh interno automático.

Ubiqs → INS

subscription-key

Header obligatorio adicional del INS, gestionado por la capa de orquestación.

Ejemplos en vivo · COTI y EMI

Request y response reales del ambiente de integración.

Requestjson

{
  "action": "COTI",
  "currency": "CRC",
  "plan": 3,
  "client": {
    "idType": "0",
    "idNumber": "801170740",
    "firstSurname": "FUENTES",
    "secondSurname": "MUÑIZ",
    "firstName": "DAYSI",
    "secondName": "MARGARITA",
    "birthDate": "12/04/1982",
    "gender": "F"
  },
  "location": {
    "provinceName": "San José",
    "cantonName": "Tibás",
    "districtName": "San Juan"
  },
  "addressLine": "San Juan de Tibás, 200m norte del parque",
  "contact": {
    "email": "dfuentes@ejemplo.com",
    "phone": "88887777"
  },
  "requestId": "app-gm-coti-20260327-001"
}

Response 200json

{
  "ok": true,
  "action": "COTI",
  "currency": "CRC",
  "plan": 3,
  "numeroCotizacion": "CT-TMP-2026-04194329",
  "primas": [
    {
      "frecuencia": "Anual",
      "codigo": "A",
      "montoPrima": 37647
    },
    {
      "frecuencia": "Semestral",
      "codigo": "S",
      "montoPrima": 18824
    },
    {
      "frecuencia": "Trimestral",
      "codigo": "T",
      "montoPrima": 9412
    },
    {
      "frecuencia": "Mensual",
      "codigo": "M",
      "montoPrima": 3136
    }
  ],
  "coberturas": [
    {
      "codigo": "40A",
      "descripcion": "FRAUDE EN LINEA",
      "sumaAsegurada": 1350000,
      "prima": 33316,
      "impuesto": 0,
      "total": 33316
    },
    {
      "codigo": "40B",
      "descripcion": "RIESGO DEL SISTEMA DOMESTICO",
      "sumaAsegurada": 1350000,
      "prima": 0,
      "impuesto": 0,
      "total": 0
    },
    {
      "codigo": "40C",
      "descripcion": "ROBO DE IDENTIDAD",
      "sumaAsegurada": 1350000,
      "prima": 0,
      "impuesto": 0,
      "total": 0
    },
    {
      "codigo": "998",
      "descripcion": "IVA",
      "sumaAsegurada": 0,
      "prima": 0,
      "impuesto": 4331,
      "total": 4331
    }
  ]
}