Skip to content

API Intermediarios (1.0.0)

Bienvenido al API de Intermediarios

El API de Intermediarios ha sido diseƱado para que puedas acceder e integrar fƔcilmente las principales funcionalidades que ofrecemos a nuestros socios y aliados.

Con esta API podrƔs:

  • Cotizar productos de Salud, Generales y Vida
  • Emitir pĆ³lizas de manera digital
  • Consultar tus pĆ³lizas, facturas, consumos y mĆ”s

Todo en un solo lugar, con seguridad, rapidez y disponibilidad 24/7.

ĀæQuĆ© encontrarĆ”s en esta documentaciĆ³n?

En esta pĆ”gina encontrarĆ”s toda la informaciĆ³n necesaria para comenzar a usar el API, incluyendo:

  • DescripciĆ³n general del API
  • EspecificaciĆ³n OpenAPI en formato YAML, lista para ser utilizada en Postman, Swagger u otras herramientas
  • Ejemplos prĆ”cticos de uso para integrarte mĆ”s rĆ”pido
  • GuĆ­as paso a paso para autenticaciĆ³n, cotizaciĆ³n, emisiĆ³n y consulta de informaciĆ³n

Primeros pasos

  1. Consulta la especificaciĆ³n OpenAPI
  2. Explora los endpoints disponibles en la secciĆ³n de referencia
  3. Integra las funcionalidades en tus sistemas internos para comenzar a operar

Beneficios clave

šŸ”„ AutomatizaciĆ³n

AutomatizaciĆ³n de procesos de cotizaciĆ³n y emisiĆ³n.

šŸ”’ Seguridad

Seguridad con estĆ”ndares modernos de autenticaciĆ³n.

āš” Disponibilidad 24/7

Siempre tengas acceso a tu informaciĆ³n.

šŸ“ˆ Escalabilidad

Lista para crecer con tus operaciones.

Download OpenAPI description
index.json
index.yaml
Overview
Equipo de APIs Humano Seguros
apis@humano.com.do
License
MIT
Languages
Servers
Mock server
https://intermediarios-api.humano.com.do/_mock/apis
DEV API
https://devapi.humano.com.do/api
Production API
https://huapi.humano.com.do/api

Servicio de PĆ³lizas

Endpoints para consultar informaciĆ³n de tus pĆ³lizas

Operations

Servicio de Facturas

Endpoints para consultar informaciĆ³n de facturas

Operations

Servicio de Comisiones

Endpoints para consultar comisiones generadas

Operations

Servicio de Cobros

Endpoints para consultar cobros e ingresos aplicados a pĆ³lizas

Operations

Servicio de CatƔlogos

Endpoints para consultar catƔlogos y datos de referencia

Operations

Servicio de Cotizaciones

Endpoints para gestionar cotizaciones

Operations

Servicio de VehĆ­culos

Endpoints para consultar informaciĆ³n de vehĆ­culos (marcas, modelos, versiones)

Operations

Servicio de Buen Viaje

Endpoints para cotizar, emitir pĆ³lizas y pagar el seguro de viaje Buen Viaje

Operations

Obtener clave pĆŗblica (PEM) para pago encriptado

Request

Devuelve la clave pĆŗblica asociada al kid indicado en formato PEM.

Se utiliza para cifrar el payload sensible del pago con JWE (RSA-OAEP-256 + A256GCM). Flujo criptogrƔfico tƭpico:

  1. ObtĆ©n la clave pĆŗblica por kid
  2. Cifra JSON sensible con JWE
  3. Firma el JWE con JWS (RS256)
  4. EnvĆ­a el POST de pago
Security
Ocp-Apim-Subscription-Key and x-user-key and x-codigo-mediador
Path
kidstringrequired

Identificador de la clave pĆŗblica (por ambiente y cliente)

Example: crt-pago-buen-viaje-pub
curl -i -X GET \
  https://intermediarios-api.humano.com.do/_mock/apis/v2/productos/buen-viaje/crypto/publickey/crt-pago-buen-viaje-pub \
  -H 'Ocp-Apim-Subscription-Key: YOUR_API_KEY_HERE' \
  -H 'x-codigo-mediador: YOUR_API_KEY_HERE' \
  -H 'x-user-key: YOUR_API_KEY_HERE'

Responses

Clave pĆŗblica en formato PEM

Bodytext/plain
string(PublicKeyPem)

Clave pĆŗblica en formato PEM

Response
text/plain
-----BEGIN PUBLIC KEY-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A...
-----END PUBLIC KEY-----

Pagar pĆ³liza Buen Viaje

Request

Procesa el pago de una pĆ³liza/factura de Buen Viaje.

Seguridad (pago encriptado v2):

  • Cifra datos sensibles del medio de pago con JWE (RSA-OAEP-256 + A256GCM)
  • Firma el JWE con JWS (RS256) usando firmaKid
  • EnvĆ­o de nonce Ćŗnico y timestamp UTC (anti-replay)

Prerrequisito: obtener la clave pĆŗblica del servidor: GET /v2/productos/buen-viaje/crypto/publickey/{kid}

Security
Ocp-Apim-Subscription-Key and x-user-key and x-codigo-mediador
Bodyapplication/jsonrequired
numeroFacturastringrequired
Example: "FAC-2026-001"
montonumberrequired
Example: 100.5
impuestonumberrequired
Example: 18.09
monedastringrequired

ISO 4217

Example: "USD"
metodoPagoobject(MetodoPagoDto)required
metodoPago.ā€‹tipostringrequired

Enum en snake_case (ej. tarjeta_credito)

Example: "tarjeta_credito"
metodoPago.ā€‹detallesobject(MetodoPagoDetallesDto)required
metodoPago.ā€‹detalles.ā€‹datosTarjetaCifradosobject(DatosTarjetaCifradosDto)required
metodoPago.ā€‹detalles.ā€‹datosTarjetaCifrados.ā€‹jwestringrequired

JWE compacto (RSA-OAEP-256 + A256GCM)

Example: "<JWE-compacto>"
metodoPago.ā€‹detalles.ā€‹datosTarjetaCifrados.ā€‹kidstringrequired

kid del servidor (clave pĆŗblica usada para cifrar)

Example: "crt-pago-buen-viaje-pub"
metodoPago.ā€‹detalles.ā€‹datosTarjetaCifrados.ā€‹noncestringrequired

GUID Ćŗnico por solicitud (anti-replay)

Example: "d3e7e5e8-8a26-4346-9a9c-8e5f8a7a1c1a"
metodoPago.ā€‹detalles.ā€‹datosTarjetaCifrados.ā€‹timestampstring(date-time)required

Timestamp ISO-8601 en UTC (con sufijo Z)

Example: "2026-01-19T14:35:00Z"
metodoPago.ā€‹detalles.ā€‹datosTarjetaCifrados.ā€‹firmaJwsstringrequired

JWS compacto RS256 firmado sobre el string del JWE

Example: "<JWS-compacto-sobre-JWE>"
metodoPago.ā€‹detalles.ā€‹datosTarjetaCifrados.ā€‹firmaKidstringrequired

kid de la clave pĆŗblica del cliente registrada para validar la firma

Example: "cliente-bv-firma-001"
metadatosobject

Metadatos opcionales (clave/valor)

curl -i -X POST \
  https://intermediarios-api.humano.com.do/_mock/apis/v2/productos/buen-viaje/pagos \
  -H 'Content-Type: application/json' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_API_KEY_HERE' \
  -H 'x-codigo-mediador: YOUR_API_KEY_HERE' \
  -H 'x-user-key: YOUR_API_KEY_HERE' \
  -d '{
    "numeroFactura": "FAC-2026-001",
    "monto": 100.5,
    "impuesto": 18.09,
    "moneda": "USD",
    "metodoPago": {
      "tipo": "tarjeta_credito",
      "detalles": {
        "datosTarjetaCifrados": {
          "jwe": "<JWE-compacto>",
          "kid": "crt-pago-buen-viaje-pub",
          "nonce": "d3e7e5e8-8a26-4346-9a9c-8e5f8a7a1c1a",
          "timestamp": "2026-01-19T14:35:00Z",
          "firmaJws": "<JWS-compacto-sobre-JWE>",
          "firmaKid": "cliente-bv-firma-001"
        }
      }
    },
    "metadatos": {
      "canal": "web",
      "campania": "promo_vuelta_clases",
      "extra": {
        "reintentos": 0
      }
    }
  }'

Responses

Pago procesado

Bodyapplication/json
numeroFacturastringrequired
Example: "FAC-2026-001"
numeroRecibostring
Example: "RC-2026-000123"
numeroAutorizacionstring
Example: "4F7A92"
montoPagadonumberrequired
Example: 118.59
monedastringrequired
Example: "USD"
mensajestringrequired
Example: "Pago procesado exitosamente"
fechaTransaccionstring(date-time)required
Example: "2026-01-19T14:35:41Z"
duracionMsinteger(int64)
Example: 842
Response
application/json
{
  "numeroFactura": "FAC-2026-001",
  "numeroRecibo": "RC-2026-000123",
  "numeroAutorizacion": "4F7A92",
  "montoPagado": 118.59,
  "moneda": "USD",
  "mensaje": "Pago procesado exitosamente",
  "fechaTransaccion": "2026-01-19T14:35:41Z",
  "duracionMs": 842
}