/api/v1/b2c/

Intégrez avec des contrats versionnés.

Présentation des contrats de GestaProp et exemples de l’API B2C v1. Chaque opération indique son statut ; les schémas versionnés régissent l’intégration.

OpenAPI 3.1 v1 es · en · fr · pt

POST /api/v1/b2c/offers Données fictives

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": "fr",
    "currency": "MXN"
  }'

Obtiens accessToken via POST /api/v1/b2c/access pour le publicSiteId et l’origine HTTPS vérifiés. Remplace le site, l’établissement et les dates de l’exemple ; ce jeton éphémère n’est pas une clé secrète de serveur.

Documentation v1

Prise en charge Non disponible

01 Prise en charge

Authentification et clés Clé publiable par site, jeton éphémère lié à l’origine HTTPS exacte et secret serveur à serveur conservé uniquement sous forme de hash.

02 Prise en charge

Catalogue et offres Consultation des établissements, unités et cotation signée : détail par nuit, remises, coupon, extras et taxes, avec échéance. Le checkout recote toujours. catalog.read · offers.quote

03 Prise en charge

Checkout hébergé Renvoie une URL de paiement idempotente à partir d’une cotation vérifiable. Ce n’est pas une réservation payée : seul le webhook du prestataire confirme. checkout.initiate

04 Prise en charge

Widget Installation par CDN versionné et immuable, avec intégrité SRI et Shadow DOM. Préremplissage des dates et de l’occupation depuis l’URL. Migration depuis gestawidget.

05 Prise en charge

Contrats et vecteurs Chaque contrat public a son JSON Schema versionné et ses vecteurs de test : catalogue, offre, cotation, référence, lancement du checkout et session. v1

06 Prise en charge

PMS Lecture de l’ARI publié et des réservations de GestaProp, par établissement avec curseur ; sans paiements, documents ni données fiscales. pms.read

07 Non disponible

Webhooks Événements signés vers votre serveur.

Erreurs et quotas Codes d’erreur stables, limites par identifiant, clé d’idempotence à chaque écriture et nouvelles tentatives sûres.

Changelog Changements par version. Les ruptures passent en /v2/.

Clés d’API

Les clés se créent dans la console, pas ici.

Un Admin, un Gérant ou le titulaire Solo Pago crée et révoque les clés depuis la console GestaProp, par établissement.

Accéder à la console

Affiché une seule foisLe secret s’affiche à la création ; ensuite seul le suffixe est visible.

Portées explicitesChaque clé ne porte que les permissions nécessaires.

Révocation immédiatePas d’expiration automatique ; révoquez quand vous le décidez.

Jamais dans le navigateurLes secrets serveur à serveur ne vont ni dans les snippets ni dans le widget.

Origine vérifiéeLe widget ne fonctionne que sur les domaines dont vous avez prouvé le contrôle, par enregistrement TXT ou fichier vérifié.

Aucune écriture tierceAucune clé ne crée de réservation confirmée ni ne déclare de total ; pms.write n’existe pas.

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

Parlons de votre exploitation

Écrivez-nous sur WhatsApp ou laissez vos coordonnées. Une personne de l’équipe commerciale vous répond.

Écrire sur WhatsApp Nous écrire