/api/v1/b2c/

Integra con contratos versionados.

Resumen de contratos de GestaProp y ejemplos de la API B2C v1. Cada operación indica si está soportada o no disponible; los esquemas versionados gobiernan la integración.

OpenAPI 3.1 v1 es · en · fr · pt

POST /api/v1/b2c/offers Datos ficticios

curl -X POST https://gestaprop.com/api/v1/b2c/offers \
  -H "Content-Type: application/json" \
  -H "Origin: https://hotel.example" \
  -H "X-Public-Site-Id: pst_hotel-demo" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "propertyId": 42,
    "checkInDate": "2026-11-14",
    "checkOutDate": "2026-11-16",
    "occupancy": { "adults": 2, "childrenAges": [] },
    "locale": "es",
    "currency": "MXN"
  }'

Obtén accessToken con POST /api/v1/b2c/access para el publicSiteId y el origen HTTPS verificados. Sustituye el sitio, la propiedad y las fechas del ejemplo; el token es efímero y no es una llave secreta de servidor.

Documentación v1

Soportada No disponible

01 Soportada

Autenticación y llaves Llave publicable por sitio, token efímero ligado al origen HTTPS exacto y secreto server-to-server que se guarda sólo como hash.

02 Soportada

Catálogo y ofertas Consulta de propiedades, unidades y cotización firmada: desglose por noche, descuentos, cupón, extras e impuestos, con vencimiento. El checkout siempre vuelve a cotizar. catalog.read · offers.quote

03 Soportada

Checkout alojado Devuelve una URL de pago idempotente a partir de una cotización verificable. No es una reserva pagada: sólo el webhook del proveedor confirma. checkout.initiate

04 Soportada

Widget Instalación por CDN versionado e inmutable, con integridad SRI y Shadow DOM. Prellenado de fechas y ocupación desde la URL. Migración desde gestawidget.

05 Soportada

Contratos y vectores Cada contrato público tiene su JSON Schema versionado y vectores de prueba: catálogo, oferta, cotización, referencia, lanzamiento de checkout y sesión. v1

06 Soportada

PMS Lectura de ARI publicado y reservas de GestaProp con alcance por propiedad y cursor; no incluye pagos, documentos ni datos fiscales. pms.read

07 No disponible

Webhooks Eventos firmados hacia tu servidor.

Errores y cuotas Códigos de error estables, límites por credencial, llave de idempotencia en cada escritura y reintentos seguros.

Changelog Cambios por versión. Lo incompatible va a /v2/.

Llaves de API

Las llaves se crean en la consola, no aquí.

Un Admin, Gerente o titular de Solo Pago crea y revoca llaves desde la consola de GestaProp, con alcance por propiedad.

Entrar a la consola

Visible una sola vezEl secreto se muestra al crearlo; después solo ves el sufijo.

Scopes explícitosCada llave tiene sólo los permisos que necesita.

Revocación inmediataSin expiración automática; se revoca en cuanto lo decides.

Nunca en el navegadorLos secretos server-to-server no van en snippets ni en el widget.

Origen verificadoEl widget sólo funciona en dominios que probaste controlar, por registro TXT o archivo verificado.

Sin escritura de tercerosNinguna llave crea una reserva confirmada ni declara un total; no existe pms.write.

catalog.read offers.quote checkout.initiate pms.read

Hablemos de tu operación

Escríbenos por WhatsApp o déjanos tus datos. Te responde una persona del equipo comercial.

Hablar por WhatsApp Escríbenos