API RéservPro

Vue d’ensemble

L’intégration partenaire sépare le panier et le paiement. Le partenaire ajoute ou modifie les réservations dans une session, puis crée un checkout. RéservPro calcule les montants, héberge la saisie du paiement et publie l’état autoritaire par API et par webhook.

Exemples pour les outils externes

Télécharger les exemples de réponses en JSON. Ce fichier contient uniquement des données fictives et illustre les structures. Les fiches détaillent les champs conditionnels, les types et les erreurs.

Authentification

Toutes les requêtes doivent être effectuées de serveur à serveur avec la clé du compte marchand. La méthode recommandée est l’en-tête HTTP Authorization: Bearer.

curl 'https://beta.reservpro.com/api/services?Limite=20' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer VOTRE_CLE_API'

Format de réponse standard

{
  "success": true,
  "error": false,
  "endpoint": "services",
  "IDEntreprise": 123,
  "request_id": "req_…",
  "data": { ... }
}

Où se trouvent les données?

Les schémas historiques ne sont pas uniformes. Les exemples de chaque fiche montrent le format effectivement servi. Les champs supplémentaires doivent être tolérés par les clients pour permettre les enrichissements compatibles.

Sécurité, formats et limites

Les réponses incluent un X-Request-ID. Les réponses limitées utilisent 429 et Retry-After; les réponses authentifiées exposent aussi X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset.

Contrat structuré de la bêta — 9 septembre 2026

Les périodes d’ouverture sont des objets avec DateDebut et DateFin. Les prix, frais, dépôts et taxes calculées sont des nombres JSON ou null, sans symbole monétaire. Les taux restent des pourcentages numériques. Les types tarifaires utilisent un slug stable et un libellé séparé.

Les intégrations utilisant l’ancienne bêta doivent adapter la lecture de DatesOuvertures, PeriodeReservationGenerale, PrixHoraire et des montants. PrixBaseFormate est retiré du contrat partenaire; utiliser PrixBase. Type_Tarification est remplacé par type_tarification et type_tarification_texte. Ces changements ne sont pas déployés en production.

Index des endpoints

Choisissez un domaine puis une fiche. Chaque endpoint conserve son lien direct.

Catégories

Retourne les catégories principales, précisions ou sous-précisions. Possibilité de filtrer les catégories ayant des services actifs.

Paramètres

Exemple

GET /api/categories?avecServiceActif=1
Authorization: Bearer VOTRE_CLE_API

Réponse HTTP 200 vérifiée

{
  "success": true,
  "error": false,
  "endpoint": "categories",
  "IDEntreprise": 9379,
  "data": {
    "details": [
      {
        "id": "C346",
        "titre": "Activités",
        "icone": "fa-basketball",
        "nbr_services": 4,
        "have_child": true,
        "parent_id": null,
        "parent_titre": null
      },
      {
        "id": "C303",
        "titre": "Camping",
        "icone": "fa-campground",
        "nbr_services": 5,
        "have_child": true,
        "parent_id": null,
        "parent_titre": null
      },
      {
        "id": "C304",
        "titre": "Chalet",
        "icone": "fa-house",
        "nbr_services": 1,
        "have_child": true,
        "parent_id": null,
        "parent_titre": null
      },
      {
        "id": "C371",
        "titre": "Événements ",
        "icone": "fa-calendar-day",
        "nbr_services": 4,
        "have_child": true,
        "parent_id": null,
        "parent_titre": null
      },
      {
        "id": "C362",
        "titre": "Passeport",
        "icone": "fa-passport",
        "nbr_services": 3,
        "have_child": true,
        "parent_id": null,
        "parent_titre": null
      }
    ]
  },
  "request_id": "req_exemple"
}

Les libellés et nombres de catégories ne remplacent pas la liste filtrée des services effectivement réservables. Charger /api/services pour construire le catalogue.

Liste des services

Retourne les services de l’entreprise avec recherche par mots-clés, pagination et filtres de visibilité/réservabilité.

Paramètres

Exemple

GET /api/services?Service_Publie=1&Service_Reservable_Public=1&Debut=0&Limite=20
Authorization: Bearer VOTRE_CLE_API

Structure de réponse et exemple HTTP 200

Réponse Démo Camping vérifiée le 9 septembre 2026 avec Limite=1, sans filtre de réservation publique. Les lignes sont dans data.Resultats; la pagination dans data.details.

{
  "success": true,
  "error": false,
  "endpoint": "services",
  "IDEntreprise": 9379,
  "data": {
    "details": {
      "Message": "",
      "Total": 18,
      "Debut": 0,
      "Limite": 1,
      "InclutServicesSupprimes": false,
      "InstructionAria": "",
      "TravailEnLot": []
    },
    "Resultats": [
      {
        "IDService": 31139,
        "Titre": "Inventaire Kayak",
        "Image": null,
        "Description_Courte": "",
        "Categorie_Texte": "",
        "IDCategorie": "",
        "IDSousCategorie": "",
        "IDSousSousCategorie": "",
        "TypeService": 2,
        "EstHebergement": false,
        "Prix": 0,
        "Quantite": 5,
        "Service_Publie": 1,
        "Service_Reservable_Public": 0,
        "Service_Reservable_Interne": 1,
        "Approbation_Manuelle": 0,
        "En_Vedette": 0,
        "NombreEmplacements": 5,
        "NombreHoraires": 0,
        "DatesOuvertures": []
      }
    ]
  },
  "request_id": "req_exemple"
}

Champs de data.Resultats[]

Une recherche par mot-clé peut se rabattre sur les emplacements : details.Message l’indique et les lignes peuvent être réduites à IDService, Titre, Categorie, TypeService, Prix (null) et Quantite (0). Charger alors la fiche détaillée.

Détail d’un service

Retourne les détails complets d’un service : description, tarification, images, dépôt, ouverture, taxes, options de réservation et rates OTA si applicables.

Paramètres

GET /api/service?IDService=35197
Authorization: Bearer VOTRE_CLE_API

Lire la réponse

Exemple de réponse HTTP 200

Réponse HTTP de Démo Camping vérifiée en bêta le 9 septembre 2026. Un seul attribut complémentaire est conservé pour la lisibilité et request_id est remplacé. Les valeurs peuvent évoluer; utilisez un IDService de votre compte.

{
  "success": true,
  "error": false,
  "endpoint": "service",
  "IDEntreprise": 9379,
  "data": {
    "Existe": true,
    "Service": {
      "IDService": 27644,
      "Titre": "Camping 1 service (eau)",
      "Categorie_Texte": "Camping > Camping 1 service",
      "IDCategorie": "C303",
      "IDSousCategorie": "P1680",
      "IDSousSousCategorie": "",
      "Description": "<p>\r\n\t86 sites de camping am&eacute;nag&eacute;s dont 28 sans service avec eau &agrave; proximit&eacute; et 58 sites avec 1 service (eau sur le site).</p>\r\n",
      "Quantité": 50,
      "TypeReservation": 0,
      "EstHebergement": true,
      "TypeJours": 0,
      "PrixBase": 38,
      "SourcePrixBase": "vit_pac.prop_price",
      "ReglePrixBase": "Pour un calcul fondé sur le prix de base du service, utiliser PrixBase. Ne pas le remplacer par un montant de DetailsComplementaires, une variation de calendrier, un tarif saisonnier ou un prix futur.",
      "Images": [
        {
          "IDPhoto": 50577,
          "URL": "https://beta.reservpro.com/pac/50577.png"
        }
      ],
      "Ouverture": "Arrivée possible tous les jours",
      "Tarification": [
        {
          "Montant": 38,
          "type_tarification": "par_nuit",
          "type_tarification_texte": "Prix par nuit",
          "SurDemande": false
        },
        {
          "Montant": 1370,
          "type_tarification": "saisonnier",
          "type_tarification_texte": "Prix saisonnier",
          "SurDemande": false
        }
      ],
      "DatesOuvertures": [
        {
          "DateDebut": "2026-03-01",
          "DateFin": "2026-12-31"
        }
      ],
      "PeriodeReservationGenerale": {
        "DateDebut": "2026-03-01",
        "DateFin": "2026-12-31"
      },
      "Reservation_en_ligne": "Activé",
      "Reservation_interne": "Activé",
      "Approbation_manuelle": "Désactivé",
      "Etat": "Publié",
      "Nuit_Minimum": 2,
      "Nuit_Maximum": 0,
      "Duree_Minimum_WEEK_END": 0,
      "Depot_En_Ligne_Pourcentage": 20,
      "Depot_Local_Pourcentage": 0,
      "Depot_En_Ligne": 0,
      "Depot_En_Ligne_Par_Nuit": 0,
      "Depot_En_Ligne_Par_Semaine": 0,
      "Demander_Age_Enfants": true,
      "Demander_Nombre_Participants": true,
      "Demander_Noms_Participants": false,
      "Appliquer_Les_Taxes_Locales": true,
      "Note_Sur_Facture": "",
      "Calendrier_ICS_Liaison": "",
      "Calendrier_ICS_Liaison_2": "",
      "Calendrier_ICS_Liaison_3": "",
      "Taxe_Hebergement": null,
      "Rates_OTA": [],
      "DetailsComplementaires": {
        "details": {
          "134": {
            "ID": 134,
            "IDAttribut": 134,
            "Parametre": "Nombre d'adultes inclus",
            "Suffixe": "",
            "Icone": "user-alt",
            "Aide": "Le nombre d'adultes inclus dans le prix journalier. Si il n'y a pas de différence en le prix par adulte et enfant n'inscrivez rien dans les sections enfants et adultes.",
            "Choix": [],
            "Reponse": "2"
          }
        }
      }
    }
  },
  "request_id": "req_exemple"
}

Enveloppe de réponse

Champs de data.Service

Respectez la casse et les accents. Les champs conditionnels peuvent être absents. Une chaîne vide, null, [] et une clé absente ne sont pas interchangeables.

Attributs dynamiques : DetailsComplementaires.details

details est un objet indexé par identifiant, par exemple data.Service.DetailsComplementaires.details["134"]. Sans attribut, il vaut []. La liste varie selon la catégorie et la configuration.

InclureParametresVides=0 (défaut) retire les attributs sans réponse ni choix sélectionné. Avec 1, ils sont conservés sans inventer de valeur. Cette option ne force pas les autres champs conditionnels à apparaître. Un attribut à choix conservé contient aussi les options non sélectionnées.

Plans tarifaires : Rates_OTA[]

Exemple de lecture en PHP

// $response = json_decode($body, true);
if (empty($response['success'])) {
    throw new RuntimeException($response['error_message'] ?? 'Erreur API');
}
if (empty($response['data']['Existe'])) {
    throw new RuntimeException('Fiche de service non disponible');
}
$service = $response['data']['Service'];
$prixBase = $service['PrixBase'];
$images = $service['Images'] ?? [];
$attributs = $service['DetailsComplementaires']['details'] ?? [];
$adultesInclus = $attributs[134]['Reponse'] ?? null;
foreach ($attributs as $attribut) {
    // Lire Reponse ou les Choix dont Select vaut true.
}

Erreurs et cas particuliers

{
  "success": false,
  "error": true,
  "error_code": "service_not_found",
  "error_message": "Service introuvable.",
  "request_id": "req_exemple"
}

Pour calculer une réservation

Cette fiche ne fournit ni un devis complet ni une confirmation de disponibilité. Consulter les unités, les variations tarifaires, le calendrier puis la disponibilité détaillée pour les dates et participants. Ne pas additionner les alternatives de Tarification pour reconstruire le total du séjour.

Types tarifaires stables

type_tarification sert aux conditions dans votre code. type_tarification_texte sert uniquement à l’affichage et peut varier avec la langue. N’utilisez pas le libellé comme identifiant.

Une gratuité retourne Montant=0 et SurDemande=false. Un tarif sur demande retourne Montant=null et SurDemande=true. Aucun montant ne contient de symbole monétaire.

Variations

Retourne les variations d’un service entre deux dates. Sur une courte plage, le résultat peut être détaillé jour par jour. Sur une plus grande plage, le résultat peut être regroupé par périodes homogènes.

Paramètres

GET /api/variations?IDService=35197&DateDebut=2026-07-01&DateFin=2026-07-31
Authorization: Bearer VOTRE_CLE_API

Réponse HTTP 200 — aucune variation configurée

{
  "success": true,
  "error": false,
  "endpoint": "variations",
  "IDEntreprise": 9379,
  "data": {
    "mode": "detail",
    "IDService": 27644,
    "IDRate": "",
    "SourceCalendrier": "standard",
    "total_jours": 3,
    "total": 0,
    "variations": [],
    "CouvertureLecture": {
      "lecture_complete": true,
      "DateDebutDemandee": "2026-09-15",
      "DateFinDemandee": "2026-09-17",
      "jours_demandes": 3,
      "jours_avec_variation": 0,
      "jours_sans_variation": 3,
      "calendrier_entierement_vide": true,
      "periodes_sans_variation": [
        {
          "DateDebut": "2026-09-15",
          "DateFin": "2026-09-17",
          "Etat": "vide_aucune_variation_configuree"
        }
      ],
      "signification_absence": "La date a ete verifiee. Aucune ligne de variation tarifaire ou de disponibilite n est configuree; utiliser les valeurs par defaut du service. Ce n est pas une erreur ni une plage non retournee."
    }
  },
  "request_id": "req_exemple"
}

Champs des variations et de params

Une période sans variation signifie que la lecture a bien couvert les dates et que les valeurs du service s’appliquent; elle n’est pas automatiquement fermée. La disponibilité détaillée reste l’autorité pour le prix réservable.

Emplacements

Retourne la liste des emplacements associés à un service. Possibilité d’inclure des dates pour obtenir une première lecture rapide de disponibilité par emplacement.

Paramètres

GET /api/emplacements?IDService=35197&DateDebut=2026-07-10&DateFin=2026-07-15
Authorization: Bearer VOTRE_CLE_API

Filtres complémentaires

Réponse HTTP 200 vérifiée — sans dates

{
  "success": true,
  "error": false,
  "endpoint": "emplacements",
  "IDEntreprise": 9379,
  "data": {
    "details": {
      "Total": 1,
      "TotalEmplacementsDisponibles": null,
      "Debut": 0,
      "Limite": 1
    },
    "services": [
      {
        "IDService": "27644",
        "TitreService": "Camping 1 service (eau)",
        "Categorie": "Camping Camping 1 service",
        "TypeService": "0",
        "Emplacements": [
          {
            "IDEmplacement": "8551",
            "Titre": "Frontenac # 01",
            "PlanX": "263",
            "PlanY": "903",
            "DateDebutValidite": "0000-00-00",
            "DateFinValidite": "0000-00-00",
            "EnLigne": true,
            "EstSaisonnier": false,
            "MinGrandeur": 0,
            "MaxGrandeur": 20,
            "MaxChien": -1,
            "MaxPerson": 0,
            "MaxAdulte": -1,
            "MaxEnfant": -1,
            "Menage": {
              "Statut": "inconnu",
              "Libelle": "Ménage non confirmé",
              "Pret": null,
              "TachesOuvertes": 0,
              "IDTaches": [],
              "DerniereCompletion": null
            }
          }
        ]
      }
    ]
  },
  "request_id": "req_exemple"
}

Avec dates, seules les unités sans chevauchement d’affectation sont retournées. Pour les capacités globales, les équipements et le tarif, utiliser /api/disponibilite. Le ménage ne bloque pas commercialement les réservations futures.

Calendrier rapide

Endpoint recommandé pour permettre à un partenaire de construire rapidement un calendrier de disponibilité sur les 30 prochains jours. Cet endpoint peut utiliser une fonction interne très rapide qui retourne les jours non disponibles d’un service, et optionnellement d’un emplacement précis via IDEmplacement.

Paramètres

Réponse HTTP 200 vérifiée

{
  "success": true,
  "error": false,
  "endpoint": "calendrier",
  "IDEntreprise": 9379,
  "data": {
    "success": true,
    "IDService": 27644,
    "IDEmplacement": 0,
    "jours": [
      {
        "date": "2026-09-15",
        "disponible": true
      },
      {
        "date": "2026-09-16",
        "disponible": true
      },
      {
        "date": "2026-09-17",
        "disponible": true
      }
    ]
  },
  "request_id": "req_exemple"
}

Les anciennes clés suggérées Jours, JoursComplets, Date et Disponible ne font pas partie de ce retour. Les valeurs par défaut sont aujourd’hui et DateDebut + 30 jours (31 dates avec les deux bornes). L’écart maximal entre les dates est de 62 jours. Valider le séjour complet via la disponibilité détaillée.

Disponibilité détaillée

Vérifie la disponibilité et calcule le prix d’un séjour ou d’une activité précise. Peut recevoir un IDEmplacement dans Details.

Corps JSON

{
  "IDService": 35197,
  "Details": {
    "Date_Debut": "2026-07-10",
    "Date_Fin": "2026-07-15",
    "Nbr_Adulte": 2,
    "Nbr_Enfant": 1,
    "Nbr_Etudiant": 0,
    "Nbr_Aine": 0,
    "Nbr_PetitEnfant": 0,
    "Nbr_GrandEnfant": 0,
    "IDEmplacement": 8832,
    "HeureDebut": 0,
    "HeureDuree": 0
  }
}

Réponse HTTP 200 vérifiée

Exemple Démo Camping pour le 15 au 17 septembre 2026, avec Nbr_Adulte=2. Le calcul ne crée pas de réservation.

{
  "success": true,
  "error": false,
  "endpoint": "disponibilite",
  "IDEntreprise": 9379,
  "data": {
    "IDService": 27644,
    "TypeReservation": "0",
    "Disponible": true,
    "NbrDisponible": 17,
    "SousTotal": 76,
    "Frais": 3.5,
    "Total": 91.41,
    "Montants": {
      "SousTotal": 76,
      "Frais": 3.5,
      "Taxe1": 3.975,
      "Taxe2": 7.93,
      "TaxeHebergement": 0,
      "Rabais": 0,
      "Depot": 18.28,
      "DepotSecurite": 0,
      "Total": 91.41
    },
    "Avertissement": "",
    "DisponibiliteParJour": 17,
    "Erreur": ""
  },
  "request_id": "req_exemple"
}

Conserver le total calculé par le moteur. Les taxes peuvent garder une précision intermédiaire (ex. 3.975); ne pas reconstruire le total à partir de montants arrondis séparément. Les rabais et dépôts ne sont pas des montants à ajouter au total. La disponibilité peut changer avant la création du panier.

Paramètres de Details

Réservation

Endpoint principal permettant soit de consulter une réservation ou un panier de session en GET, soit d’ajouter ou modifier les éléments du panier en POST. La transmission du client et le passage au paiement se font exclusivement avec POST /api/checkout.

GET — Consulter une réservation ou un panier

Retourne soit le panier complet d’une session, soit une réservation précise appartenant à cette session. Cet endpoint ne dépend pas de $_SESSION['idusr'] : l’entreprise est déterminée automatiquement à partir de la clé API.

Paramètres

Exemple — panier complet

GET /api/reservation?IDSession=campingqc_123abc
Authorization: Bearer VOTRE_CLE_API

Exemple — réservation précise

GET /api/reservation?IDSession=campingqc_123abc&IDReservation=2786491
Authorization: Bearer VOTRE_CLE_API

Exemple de réponse — panier

{
  "success": true,
  "error": false,
  "endpoint": "reservation",
  "IDEntreprise": 123,
  "data": {
    "success": true,
    "error": false,
    "details": {
      "IDSession": "campingqc_123abc",
      "TotalReservations": 2,
      "SousTotalPanier": 540,
      "TotalPanier": 620.87
    },
    "Reservations": [
      {
        "IDReservation": 2786491,
        "IDService": 35197,
        "TitreService": "Terrain 3 services",
        "Reservation_Date_Debut": "2026-07-10",
        "Reservation_Date_Fin": "2026-07-15",
        "Nombre_Adultes": 2,
        "Nombre_Enfants": 1,
        "Quantite": 1,
        "Status": "Panier",
        "SousTotal": 270,
        "Total": 310.44,
        "Emplacements": [
          {
            "IDEmplacement": 8832,
            "TitreEmplacement": "Terrain A-12",
            "DateDebut": "2026-07-10",
            "DateFin": "2026-07-15"
          }
        ],
        "Elements_Associes": []
      }
    ]
  },
  "request_id": "req_exemple"
}

POST — Gérer une réservation

Le champ action accepte uniquement ajouter ou modifier. Une confirmation doit passer par le checkout; l’annulation ne fait pas partie de ce contrôleur partenaire.

Pour une modification, IDReservation doit appartenir au compte authentifié et à IDSession. IDService peut être omis pour conserver le service courant; s’il est fourni, il doit appartenir au même compte. Un IDEmplacement doit appartenir à ce service. Toute référence étrangère est retournée comme introuvable.

Actions supportées

Exemple — ajouter

{
  "action": "ajouter",
  "IDSession": "campingqc_123abc",
  "reservations": [
    {
      "IDService": 35197,
      "IDEmplacement": 8832,
      "Date_Debut": "2026-07-10",
      "Date_Fin": "2026-07-15",
      "Nbr_Adulte": 2,
      "Nbr_Enfant": 1
    }
  ]
}

Exemple — modifier

{
  "action": "modifier",
  "IDSession": "campingqc_123abc",
  "reservations": [
    {
      "IDReservation": 2786491,
      "IDService": 35197,
      "IDEmplacement": 8832,
      "Date_Debut": "2026-07-11",
      "Date_Fin": "2026-07-16",
      "Nbr_Adulte": 2,
      "Nbr_Enfant": 1
    }
  ]
}

Checkout partenaire

Crée une photographie sécurisée du panier, associe le client aux réservations et retourne l’URL de paiement hébergée. Les montants sont recalculés par RéservPro; le partenaire ne transmet aucun montant à débiter.

En-têtes

Authorization: Bearer VOTRE_CLE_API
Content-Type: application/json
Accept: application/json
Idempotency-Key: cq-commande-20260710-000123

Corps JSON

Objet customer

Une valeur qui dépasse sa limite est refusée avec HTTP 422 invalid_checkout; elle n’est jamais tronquée silencieusement.

Exemple cURL — créer le checkout

curl -X POST 'https://beta.reservpro.com/api/checkout' \
  -H 'Authorization: Bearer VOTRE_CLE_API' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Idempotency-Key: cq-commande-20260710-000123' \
  --data '{
    "IDSession": "campingqc_123abc",
    "customer": {
      "first_name": "Hugo",
      "last_name": "Girard",
      "email": "hugo@example.com",
      "phone": "514-555-0199",
      "address1": "123 rue Exemple",
      "address2": "",
      "city": "Montréal",
      "state": "QC",
      "country": "Canada",
      "postal_code": "H1H 1H1",
      "language": "fr"
    },
    "iframe_origin": "https://reservation.partenaire.ca",
    "webhook_url": "https://reservation.partenaire.ca/webhooks/reservpro",
    "webhook_secret": "whsec_EXEMPLE_A_REMPLACER_32_CARACTERES",
    "partner_reference": "CQ-2026-000123",
    "metadata": {
      "channel": "camping-quebec"
    }
  }'

Réponse de création

{
  "success": true,
  "error": false,
  "endpoint": "checkout",
  "request_id": "req_…",
  "checkout": {
    "id": "chk_…",
    "partner_reference": "CQ-2026-000123",
    "metadata": {
      "channel": "camping-quebec"
    },
    "status": "payment_pending",
    "status_url": "https://beta.reservpro.com/api/checkout?IDCheckout=chk_…",
    "version": 1,
    "reservation_ids": [
      2786491
    ],
    "invoice_ids": [],
    "invoices": [],
    "item_count": 1,
    "amount_total": 310.44,
    "amount_due": 155.22,
    "amount_paid": 0,
    "balance_due": 155.22,
    "currency": "CAD",
    "payment_required": true,
    "payment_completed": false,
    "payment_url": "https://beta.reservpro.com/api/payment/rpt_…",
    "iframe_html": "<iframe src=\"https://beta.reservpro.com/api/payment/rpt_…\" …></iframe>",
    "iframe_origin": "https://reservation.partenaire.ca",
    "payment_origin": "https://reservpro.com",
    "payment_gateway": "stripe",
    "expires_at": "2026-07-10T15:00:00-04:00",
    "paid_at": null,
    "completed_at": null,
    "released_at": null,
    "created_at": "2026-07-10T14:30:00-04:00",
    "updated_at": "2026-07-10T14:30:00-04:00",
    "checkout_token": "rpt_…",
    "idempotent_replay": false
  }
}

Une création retourne HTTP 201; une reprise idempotente retourne 200 avec idempotent_replay: true. status_url exige toujours l’authentification Bearer. checkout_token est la capacité temporaire déjà intégrée à payment_url; ne la transmettez jamais ailleurs. Si RéservPro génère webhook_secret, il apparaît dans la création et ses reprises idempotentes, mais jamais dans un GET. Stockez-le immédiatement dans un gestionnaire de secrets.

GET — consulter l’état

curl --get 'https://beta.reservpro.com/api/checkout' \
  -H 'Authorization: Bearer VOTRE_CLE_API' \
  -H 'Accept: application/json' \
  --data-urlencode 'IDCheckout=chk_…'

La réponse place l’état dans checkout et reprend les montants, références et dates. Pour ne pas republier le jeton de paiement, payment_url et iframe_html valent null lors d’un GET. Conservez la réponse de création; si elle est perdue après un délai réseau, répétez le même POST avec la même clé d’idempotence. Une ressource d’un autre compte marchand retourne une réponse introuvable.

États possibles

Après expiration, RéservPro conserve le snapshot pendant une grâce de 15 minutes par défaut afin de rapprocher un paiement déjà engagé. Sans preuve de paiement, le worker restaure ensuite atomiquement les réservations dans le IDSession partenaire et renseigne released_at. Pour reprendre les mêmes éléments, attendez que released_at ne soit plus null, puis créez un checkout avec une nouvelle clé d’idempotence. L’événement de restauration utilise checkout.updated.

Iframe de paiement

Le champ iframe_html contient une iframe prête à intégrer. payment_url peut aussi être utilisé comme attribut src ou ouvert dans une page dédiée. Cette URL contient une capacité temporaire : ne la journalisez pas, ne la modifiez pas et ne la partagez pas.

• iframe_origin doit être l’origine HTTPS exacte de la page parente : schéma, hôte et port, sans chemin, query string ni fragment.
• La page de paiement applique une politique CSP frame-ancestors limitée à cette origine. Une intégration depuis une autre origine est refusée par le navigateur.
• La clé API Bearer reste sur le serveur partenaire et n’est jamais transmise à l’iframe.
• Les messages postMessage, lorsqu’ils sont utilisés, servent uniquement à mettre à jour l’interface. Le parent doit valider event.origin, event.source et la structure du message.
• Un message navigateur, une fermeture d’iframe ou une URL de retour ne constitue jamais une preuve de paiement. Après tout signal UX, interroger GET /api/checkout.

Message de mise à jour de l’iframe

{
  "type": "reservpro.checkout.status",
  "checkout_id": "chk_…",
  "status": "paid",
  "payment_completed": true
}

Le message est envoyé uniquement à iframe_origin. Dans la page parente, conserver une référence vers l’élément iframe et accepter le message seulement si event.origin correspond exactement à payment_origin, si event.source === iframe.contentWindow, si checkout_id est celui attendu et si le schéma ci-dessus est valide. Le serveur partenaire doit ensuite confirmer l’état avec le GET authentifié; le navigateur ne doit jamais appeler l’API avec la clé Bearer.

Webhooks de checkout

Lorsqu’un webhook_url est fourni à la création, RéservPro envoie les événements de checkout par POST JSON. Les types actuels comprennent checkout.created — dont le checkout peut être payment_pending ou confirmation_pending — puis checkout.paid, checkout.completed, checkout.expired, checkout.cancelled et, lors d’une autre évolution matérielle, checkout.updated. L’état et l’événement failed sont réservés à une évolution future.

En-têtes de livraison

Content-Type: application/json
X-ReservPro-Event: checkout.paid
X-ReservPro-Event-ID: evt_…
X-ReservPro-Timestamp: 1783711800
X-ReservPro-Signature: v1=SIGNATURE_HEXADECIMALE

Corps type

{
  "id": "evt_…",
  "type": "checkout.paid",
  "created_at": "2026-07-10T18:10:00Z",
  "data": {
    "checkout": {
      "id": "chk_…",
      "partner_reference": "CQ-2026-000123",
      "status": "paid",
      "version": 2,
      "amount_due": 155.22,
      "amount_paid": 155.22,
      "balance_due": 0,
      "currency": "CAD"
    }
  },
  "context": {
    "previous_status": "payment_pending"
  }
}

Validation de la signature

La signature est calculée sur les octets exacts du corps reçu : HMAC_SHA256(timestamp + "." + raw_body, webhook_secret). Comparez v1=… en temps constant, refusez les timestamps trop anciens et ne recomposez jamais le JSON avant la validation.

$rawBody = file_get_contents('php://input');
$timestamp = $_SERVER['HTTP_X_RESERVPRO_TIMESTAMP'] ?? '';
$signature = $_SERVER['HTTP_X_RESERVPRO_SIGNATURE'] ?? '';
$eventId = $_SERVER['HTTP_X_RESERVPRO_EVENT_ID'] ?? '';
$secret = getenv('RESERVPRO_WEBHOOK_SECRET');

if (!is_string($secret) || $secret === '' || !preg_match('/^\d{10}$/D', $timestamp)) {
    http_response_code(401);
    exit;
}

if (abs(time() - (int) $timestamp) > 300) {
    http_response_code(401);
    exit;
}

$expected = 'v1=' . hash_hmac('sha256', $timestamp . '.' . $rawBody, $secret);
if (!hash_equals($expected, $signature)) {
    http_response_code(401);
    exit;
}

$event = json_decode($rawBody, true, 64, JSON_THROW_ON_ERROR);
if (!is_array($event) || !preg_match('/^evt_[A-Za-z0-9_-]+$/D', $eventId)
    || ($event['id'] ?? '') !== $eventId) {
    http_response_code(400);
    exit;
}
// Enregistrer $eventId avec une contrainte UNIQUE avant le traitement métier.
// Si $eventId existe déjà, répondre 2xx sans retraiter l’événement.
http_response_code(204);

Validation d’accès

Endpoint permettant de valider un code d’accès pour autoriser ou refuser un passage. Le code peut être lié à un accès saisonnier ou à une réservation active.

Paramètres

Exemple — POST JSON

{
  "code": "ABC123",
  "type": 0,
  "save_log": true
}

Réponse — accès saisonnier autorisé

{
  "success": true,
  "error": false,
  "endpoint": "gate-access",
  "IDEntreprise": 123,
  "data": {
    "valid": true,
    "type": "saisonnier",
    "message": "Accès saisonnier valide.",
    "access": {
      "code_access": "ABC123",
      "validation_type": "entree",
      "id_validation": 456
    },
    "saisonnier": {
      "saison_id": 987,
      "saison_datedebut": "2026-05-01",
      "saison_datefin": "2026-10-15"
    },
    "site": {
      "IDEmplacement": 8832,
      "Nom": "Terrain A-12"
    },
    "client": {
      "usr_id": 789,
      "nom": "Jean Tremblay",
      "email": "jean@example.com"
    },
    "vehicule": {
      "vps_id": 321,
      "type": "Automobile",
      "marque": "Toyota",
      "model": "RAV4",
      "couleur": "Noir",
      "annee": "2020",
      "plaque": "ABC123",
      "no_serie": "",
      "vignette": 1,
      "no_acces": "ABC123",
      "conducteur": "Marie Tremblay",
      "informations": ""
    }
  },
  "request_id": "req_exemple"
}

Réponse — accès réservation autorisé

{
  "success": true,
  "error": false,
  "endpoint": "gate-access",
  "IDEntreprise": 123,
  "data": {
    "valid": true,
    "type": "reservation",
    "message": "Accès réservation valide.",
    "access": {
      "code_access": "XYZ789",
      "validation_type": "entree",
      "id_validation": 457
    },
    "reservation": {
      "reserv_id": 2786491,
      "reserv_datedebut": "2026-07-10",
      "reserv_datefin": "2026-07-15",
      "reserv_actif": 1,
      "reserv_inv": 1433936
    },
    "gate_data": {
      "id": 55,
      "modified": 0
    }
  },
  "request_id": "req_exemple"
}

Réponse — accès refusé

{
  "success": true,
  "error": false,
  "endpoint": "gate-access",
  "IDEntreprise": 123,
  "data": {
    "valid": false,
    "type": "",
    "message": "Accès refusé : aucun saisonnier ou réservation active trouvé pour ce code.",
    "access": {
      "code_access": "ABC123",
      "validation_type": "entree"
    }
  },
  "request_id": "req_exemple"
}

Champs de réponse

Exemple PHP / cURL

$payload = [
    'code' => 'ABC123',
    'type' => 0,
    'save_log' => true
];

$ch = curl_init('https://beta.reservpro.com/api/gate-access');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode($payload),
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        'Authorization: Bearer VOTRE_CLE_API',
        'Content-Type: application/json'
    ],
    CURLOPT_TIMEOUT => 30
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);

if (!empty($data['data']['valid'])) {
    echo 'Accès autorisé';
} else {
    echo 'Accès refusé';
}

Informations et historique ajoutés en bêta

La réponse conserve ses champs existants et ajoute sites (toutes les affectations d’une réservation), validite, FuseauHoraire et Historique : les cinq passages précédant la validation courante. HistoriqueAvantValidation=true précise ce moment. save_log=false vérifie sans enregistrer de passage.

La validité native est vérifiée par jour, avec bornes inclusives. Les dates ne représentent pas des heures d’ouverture précises. Les réservations annulées sont refusées. Voir la fiche de l’historique pour les anciens logs incomplets.

Liste des codes d’accès

Endpoint permettant d’obtenir la liste des codes d’accès assignés aux réservations. Il peut être utilisé par un système de contrôle d’accès pour synchroniser ou consulter les accès actifs sur une période donnée.

Paramètres

Filtre par date

Lorsque DateDebut et/ou DateFin sont fournis, l’API retourne les codes liés aux réservations qui chevauchent la période demandée.

Par exemple, une réservation du 2026-07-01 au 2026-07-10 sera retournée pour une recherche du 2026-07-05 au 2026-07-06.

Source des informations supplémentaires

Exemple

GET /api/gate-codes?DateDebut=2026-07-01&DateFin=2026-07-31
Authorization: Bearer VOTRE_CLE_API

Exemple avec pagination

GET /api/gate-codes?DateDebut=2026-07-01&DateFin=2026-07-31&Debut=0&Limite=100
Authorization: Bearer VOTRE_CLE_API

Réponse type

{
  "success": true,
  "error": false,
  "endpoint": "gate-codes",
  "IDEntreprise": 123,
  "data": {
    "success": true,
    "error": false,
    "details": {
      "Total": 2,
      "Debut": 0,
      "Limite": 100,
      "DateDebut": "2026-07-01",
      "DateFin": "2026-07-31"
    },
    "codes": [
      {
        "code": "ABC123",
        "type": "reservation",
        "reservation": {
          "IDReservation": 2786491,
          "DateDebut": "2026-07-10",
          "DateFin": "2026-07-15",
          "Statut": 1,
          "Arrivee": -1,
          "IDFacture": 1433936
        },
        "service": {
          "IDService": 35197,
          "Titre": "Terrain 3 services"
        },
        "site": {
          "IDEmplacement": 8832,
          "Nom": "Terrain A-12"
        },
        "client": {
          "IDClient": 789,
          "Nom": "Jean Tremblay",
          "Email": "jean@example.com",
          "Telephone": "514-555-1234"
        },
        "vehicule": {
          "IDVehicule": 321,
          "Type": "Automobile",
          "Marque": "Toyota",
          "Modele": "RAV4",
          "Couleur": "Noir",
          "Annee": "2020",
          "Plaque": "ABC123",
          "NoSerie": "",
          "Vignette": 1,
          "CarteAcces": "ABC123",
          "Conducteur": "Marie Tremblay",
          "Informations": ""
        },
        "meta": {
          "DateCreation": "2026-07-10 14:32:00",
          "DateModification": null,
          "Modifie": 0
        }
      }
    ]
  },
  "request_id": "req_exemple"
}

Comportement lorsque le véhicule est absent

Si le code d’accès est lié à une réservation, mais qu’aucun véhicule ne correspond à ce code, le bloc vehicule est retourné avec des valeurs vides. L’API ne choisit pas automatiquement un véhicule du client afin d’éviter toute ambiguïté.

"vehicule": {
  "IDVehicule": 0,
  "Type": "Automobile",
  "Marque": "",
  "Modele": "",
  "Couleur": "",
  "Annee": "",
  "Plaque": "",
  "NoSerie": "",
  "Vignette": 0,
  "CarteAcces": "",
  "Conducteur": "",
  "Informations": ""
}

Exemple PHP / cURL

$params = [
    'DateDebut' => '2026-07-01',
    'DateFin' => '2026-07-31',
    'Debut' => 0,
    'Limite' => 100
];

$url = 'https://beta.reservpro.com/api/gate-codes?' . http_build_query($params);

$ch = curl_init($url);

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        'Authorization: Bearer VOTRE_CLE_API'
    ],
    CURLOPT_TIMEOUT => 30
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);

if (!empty($data['data']['codes'])) {
    foreach ($data['data']['codes'] as $row) {
        $site = isset($row['site']['Nom']) ? $row['site']['Nom'] : '';
        $plaque = isset($row['vehicule']['Plaque']) ? $row['vehicule']['Plaque'] : '';

        echo $row['code'] . ' - ' .
             $row['reservation']['DateDebut'] . ' - ' .
             $site . ' - ' .
             $plaque . PHP_EOL;
    }
}

Informations ajoutées en bêta

Chaque code de réservation inclut sites et Historique. Le bloc site existant reste présent pour compatibilité; sites couvre les réservations avec plusieurs affectations. L’historique contient les cinq derniers passages enregistrés du code pour cette entreprise. Voir les limites des anciens journaux.

Historique d’un code d’accès

Consulter les passages d’un code, y compris après son expiration ou sa désactivation.

Paramètres

Exemple

GET /api/gate-history?code=CODE_EXEMPLE&Limite=5
Authorization: Bearer VOTRE_CLE_BETA

Réponse

data.Historique contient IDValidation, Date, Type (entree/sortie), IDReservation ou IDSaisonnier. Ordre décroissant par date et identifiant.

{
  "success": true,
  "error": false,
  "endpoint": "gate-history",
  "IDEntreprise": 123,
  "data": {
    "code": "CODE_EXEMPLE",
    "FuseauHoraire": "America/Montreal",
    "Historique": [
      {
        "IDValidation": 789,
        "Date": "2026-09-08 11:30:00",
        "Type": "sortie",
        "IDReservation": 456,
        "IDSaisonnier": null
      }
    ]
  },
  "request_id": "req_exemple"
}

Limites de l’historique

Seuls les passages dont le code et l’entreprise ont été enregistrés sont retournés. Les anciens logs incomplets ne sont pas reconstruits. Un historique vide ne prouve pas qu’un code n’a jamais été utilisé. Un code réutilisé peut présenter plusieurs réservations.

Voir aussi la validation d’accès et la liste des codes.

Tâches et ménage : fonctionnement

Les opérations utilisent les tâches natives RéservPro. L’application employés et l’API consultent et mettent à jour les mêmes tâches.

Parcours d’intégration

1. Consulter les départs du jour et à venir.
2. Retrouver les tâches par réservation ou emplacement.
3. Commencer ou terminer la tâche par API, ou dans l’application employés.
4. Relire l’état effectif de l’emplacement.

Activer un modèle de ménage

Dans les modèles de tâches, choisir « Cette tâche confirme le ménage de l’emplacement ». Les tâches échues todo ou doing rendent l’emplacement non prêt. Les tâches futures à faire ne le bloquent pas aujourd’hui. Une tâche démarrée par anticipation compte immédiatement.

Lire l’état actuel

• menage_a_faire : tâche échue ouverte.
• menage_en_cours : au moins une tâche commencée.
• pret : confirmation datée et aucune tâche échue ouverte.
• inconnu : aucune confirmation datée, Pret=null.

Les tâches annulées et les tâches des réservations annulées sont exclues. Les anciennes tâches non terminées restent à faire; elles ne sont jamais complétées automatiquement.

Le ménage décrit la préparation actuelle à accueillir. Il ne bloque pas les réservations futures et ne remplace pas la disponibilité ou l’occupation.

Respecter les règles de tâches

Les modèles requires_report exigent les heures réelles et une note; la note est facultative pour une routine schedule. Les changements par API sont journalisés. Une tâche événementielle peut concerner plusieurs emplacements par sa réservation : sa confirmation affecte alors toutes ces affectations.

Départs du jour et à venir

Retourne les réservations actives dont la date de fin se trouve dans la période choisie, avec leurs emplacements et tâches.

Paramètres

Exemple

GET /api/departs?DateDebut=2026-09-08&DateFin=2026-09-08
Authorization: Bearer VOTRE_CLE_BETA

Réponse

data contient DateDebut, DateFin, FuseauHoraire, Total, Debut, Limite et Resultats.

Chaque réservation expose IDReservation, IDService, Service, DateDebut, DateFin, HeureDepart (valeur du dossier), DepartEnregistre, Emplacements et Taches. Les affectations contiennent leurs dates et le bloc Menage actuel. Les tâches incluent IDTache, Etat, IDEmplacement, DebutPrevu et Menage.

Cas particuliers

Les réservations sans code d’accès sont incluses. Sans emplacement, Emplacements est vide et MenageService fournit l’état du service. Un changement d’emplacement intermédiaire figure dans les affectations; il ne constitue pas un départ final.

Pour le suivi du travail, consulter les tâches natives. Ne pas utiliser la liste des codes comme inventaire des départs.

Exemple complet de réponse

Exemple fictif de structure; aucune réservation client réelle n’est reproduite.

{
  "success": true,
  "error": false,
  "endpoint": "departs",
  "IDEntreprise": 123,
  "data": {
    "DateDebut": "2026-09-15",
    "DateFin": "2026-09-15",
    "FuseauHoraire": "America/Montreal",
    "Total": 1,
    "Debut": 0,
    "Limite": 100,
    "Resultats": [
      {
        "IDReservation": 300,
        "IDService": 100,
        "Service": "Camping",
        "DateDebut": "2026-09-13",
        "DateFin": "2026-09-15",
        "HeureDepart": "11:00:00",
        "DepartEnregistre": false,
        "Emplacements": [
          {
            "IDAffectation": 400,
            "IDEmplacement": 200,
            "Nom": "Terrain 01",
            "DateDebut": "2026-09-13",
            "DateFin": "2026-09-15",
            "Menage": {
              "Statut": "inconnu",
              "Libelle": "Ménage non confirmé",
              "Pret": null,
              "TachesOuvertes": 0,
              "IDTaches": [],
              "DerniereCompletion": null
            }
          }
        ],
        "Taches": [
          {
            "IDTache": 456,
            "Etat": "todo",
            "IDEmplacement": 200,
            "DebutPrevu": "2026-09-15 11:00:00",
            "Menage": true
          }
        ],
        "MenageService": null
      }
    ]
  },
  "request_id": "req_exemple"
}

Consulter et mettre à jour les tâches

Accéder aux tâches natives de l’entreprise, les commencer, les terminer, les rouvrir ou les annuler.

Paramètres

Exemple

GET /api/taches?Menage=1&Etat=todo

PATCH /api/taches
Content-Type: application/json
Authorization: Bearer VOTRE_CLE_BETA

{"IDTache":456,"Etat":"doing","EtatAttendu":"todo"}

Réponse de lecture

data contient Total, Debut, Limite, FuseauHoraire et Resultats. Une tâche expose IDTache, Titre, Etat, IDService, IDEmplacement, IDEmplacements (affectations résolues), IDReservation, IDEmploye, DebutPrevu, FinPrevue, DebutReel, FinReelle, CompleteLe, Description, Menage et ModeCompletion.

Réponse de modification

{
  "success": true,
  "error": false,
  "endpoint": "taches",
  "IDEntreprise": 123,
  "data": {
    "IDTache": 456,
    "Etat": "doing",
    "DejaApplique": false
  },
  "request_id": "req_exemple"
}

Un réessai vers le même état retourne DejaApplique=true sans deuxième événement. Une tâche annulée ne peut pas être reprise par cette action. Une réouverture remet à zéro sa confirmation; le journal conserve le changement.

Rapports et droits

Les règles sont les mêmes que dans l’application employés : voir le fonctionnement du ménage. Les droits de la clé sont limités à son entreprise. La tâche n’est pas recréée et aucune ancienne tâche n’est complétée implicitement.

Exemple complet de lecture

Exemple fictif de structure, avec identifiants de démonstration. ModeCompletion reprend la valeur configurée du modèle.

{
  "success": true,
  "error": false,
  "endpoint": "taches",
  "IDEntreprise": 123,
  "data": {
    "FuseauHoraire": "America/Montreal",
    "Total": 1,
    "Debut": 0,
    "Limite": 100,
    "Resultats": [
      {
        "IDTache": 456,
        "Titre": "Préparer le terrain",
        "Etat": "todo",
        "IDService": 100,
        "IDEmplacement": 200,
        "IDEmplacements": [
          200
        ],
        "IDReservation": 300,
        "IDEmploye": 0,
        "DebutPrevu": "2026-09-15 11:00:00",
        "FinPrevue": "2026-09-15 12:00:00",
        "DebutReel": null,
        "FinReelle": null,
        "CompleteLe": null,
        "Description": "",
        "Menage": true,
        "ModeCompletion": "requires_report"
      }
    ]
  },
  "request_id": "req_exemple"
}

État de ménage d’un emplacement

Lire l’état actuel ou changer la tâche de ménage qui le détermine.

Paramètres

Exemple

PATCH /api/emplacement-statut
Content-Type: application/json
Authorization: Bearer VOTRE_CLE_BETA

{
  "IDEmplacement": 123, "IDTache": 456,
  "Statut": "pret", "EtatAttendu": "doing",
  "DebutReel": "2026-09-08 11:00:00",
  "FinReelle": "2026-09-08 11:45:00",
  "Rapport": "Ménage terminé et vérifié."
}

Réponse

data contient IDEmplacement, Nom, Menage, Tache et BloqueReservations=false. Le bloc Menage contient Statut, Libelle, Pret, TachesOuvertes, IDTaches et DerniereCompletion.

Lire l’état effectif

La confirmation d’une tâche peut réussir alors que Menage.Pret=false : d’autres tâches échues restent ouvertes. Toujours lire l’état retourné avant d’afficher « prêt ». Le système n’enregistre pas un second statut indépendant des tâches.

GET /api/emplacements expose également ce bloc. Sans confirmation datée, Pret vaut null. Le ménage n’est pas un blocage commercial des disponibilités futures.

Exemple complet de lecture

Exemple fictif sans confirmation de ménage.

{
  "success": true,
  "error": false,
  "endpoint": "emplacement-statut",
  "IDEntreprise": 123,
  "data": {
    "IDEmplacement": 200,
    "Nom": "Terrain 01",
    "Menage": {
      "Statut": "inconnu",
      "Libelle": "Ménage non confirmé",
      "Pret": null,
      "TachesOuvertes": 0,
      "IDTaches": [],
      "DerniereCompletion": null
    },
    "Tache": null,
    "BloqueReservations": false
  },
  "request_id": "req_exemple"
}

Application Android employés

L’application RéservPro Employé utilise les mêmes tâches que les endpoints API.

Fonctions disponibles

• Consulter les tâches assignées.
• Commencer et terminer une tâche selon les droits de l’employé.
• Fournir les heures réelles et les rapports requis.
• Accéder aux outils d’entretien et aux échanges d’équipe autorisés.

Essayer en bêta

Télécharger l’application Android bêta Ouvrir le portail employés

Une connexion employé est requise. Version Android bêta 1.0.3-4, Android 7.0 minimum. Le portail est chargé depuis la bêta; les évolutions web du suivi des tâches ne nécessitent pas de nouvelle compilation de l’application.

Choisir le parcours

L’application peut couvrir directement le travail des employés. Les endpoints de tâches servent à connecter un outil externe lorsqu’il est nécessaire.

Exemples PHP / cURL

Fonction GET avec Bearer

function reservpro_api_get($endpoint, $apiKey, $params = []) {
    $base = 'https://beta.reservpro.com/api/';
    $url = $base . $endpoint . '?' . http_build_query($params);

    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => [
            'Accept: application/json',
            'Authorization: Bearer ' . $apiKey
        ],
        CURLOPT_TIMEOUT => 30
    ]);

    $response = curl_exec($ch);

    if (curl_errno($ch)) {
        return ['error' => true, 'message' => curl_error($ch)];
    }

    curl_close($ch);
    return json_decode($response, true);
}

Exemple services

$services = reservpro_api_get('services', 'VOTRE_CLE_API', [
    'Service_Publie' => 1,
    'Service_Reservable_Public' => 1,
    'Debut' => 0,
    'Limite' => 20
]);

Fonction POST JSON avec Bearer et idempotence

function reservpro_api_post($endpoint, $apiKey, $payload = [], $idempotencyKey = null) {
    $url = 'https://beta.reservpro.com/api/' . $endpoint;
    $json = json_encode($payload, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
    $headers = [
        'Accept: application/json',
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json',
        'Content-Length: ' . strlen($json)
    ];
    if ($idempotencyKey !== null) {
        $headers[] = 'Idempotency-Key: ' . $idempotencyKey;
    }

    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => $json,
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_TIMEOUT => 30
    ]);

    $response = curl_exec($ch);

    if (curl_errno($ch)) {
        return ['error' => true, 'message' => curl_error($ch)];
    }

    curl_close($ch);
    return json_decode($response, true);
}

Exemple disponibilité

$dispo = reservpro_api_post('disponibilite', 'VOTRE_CLE_API', [
    'IDService' => 35197,
    'Details' => [
        'Date_Debut' => '2026-07-10',
        'Date_Fin' => '2026-07-15',
        'Nbr_Adulte' => 2,
        'IDEmplacement' => 8832,
        'HeureDebut' => 0,
        'HeureDuree' => 0
    ]
]);

Exemple checkout en PHP

$checkout = reservpro_api_post(
    'checkout',
    'VOTRE_CLE_API',
    [
        'IDSession' => 'campingqc_123abc',
        'customer' => [
            'first_name' => 'Hugo',
            'last_name' => 'Girard',
            'email' => 'hugo@example.com',
            'phone' => '514-555-0199',
            'address1' => '123 rue Exemple',
            'city' => 'Montréal',
            'state' => 'QC',
            'country' => 'Canada',
            'postal_code' => 'H1H 1H1',
            'language' => 'fr'
        ],
        'iframe_origin' => 'https://reservation.partenaire.ca',
        'webhook_url' => 'https://reservation.partenaire.ca/webhooks/reservpro',
        'webhook_secret' => getenv('RESERVPRO_WEBHOOK_SECRET'),
        'partner_reference' => 'CQ-2026-000123',
        'metadata' => ['channel' => 'camping-quebec']
    ],
    'cq-commande-20260710-000123'
);

$iframeHtml = $checkout['checkout']['iframe_html'] ?? '';
$checkoutId = $checkout['checkout']['id'] ?? '';

Réponses d’erreur

Les erreurs suivent un format cohérent.

{
  "success": false,
  "error": true,
  "error_code": "invalid_api_key",
  "error_message": "Clé API invalide.",
  "request_id": "req_…"
}

Erreurs fréquentes

Notes d’implantation

Recommandation d’architecture

• Utiliser /api/calendrier pour construire les vues calendrier.
• Utiliser /api/disponibilite seulement au moment de valider un choix précis.
• Conserver la clé API et le secret webhook uniquement côté serveur.
• Conserver IDSession, IDCheckout, partner_reference et les clés d’idempotence afin de rapprocher les opérations.
• Traiter webhooks et appels de reprise de façon idempotente.
• Utiliser le polling du checkout comme secours et après tout signal provenant de l’iframe.

Activation côté RéservPro

Avant d’ouvrir le checkout aux partenaires, l’exploitant RéservPro doit appliquer la migration datée sql/20260816_partner_api_checkout.sql, définir RESERVPRO_WEBHOOK_ENCRYPTION_KEY dans l’environnement (une valeur Base64 représentant 32 octets est recommandée) et exécuter crontab_api_webhooks.php chaque minute avec cette même variable. Ce worker réconcilie les états, reprend les livraisons interrompues et distribue la file de webhooks. L’endpoint checkout retourne 503 checkout_schema_unavailable tant que la migration n’est pas appliquée et 503 checkout_configuration_unavailable si la clé dédiée est absente ou invalide.

• Configurer le serveur HTTP, le proxy, le CDN et l’outil de suivi pour exclure ou masquer le chemin /api/payment/rpt_… des journaux d’accès : il contient une capacité temporaire.
• Conserver les sorties du worker dans un journal supervisé et alerter sur les livraisons dead; ne pas rediriger silencieusement toutes les erreurs vers /dev/null.
• Fournir la même clé dédiée au processus PHP-FPM et au cron, la sauvegarder hors du dépôt et prévoir une rotation contrôlée avant de remplacer sa valeur.
• Le stockage local des quotas est séparé automatiquement par utilisateur système. Pour imposer un autre emplacement, définir RESERVPRO_API_RATE_DIR vers un chemin absolu privé, inscriptible par PHP-FPM et protégé en mode 0700.
• La grâce de libération vaut 900 secondes par défaut. RESERVPRO_API_CHECKOUT_RELEASE_GRACE_SECONDS permet de la régler entre 60 et 86 400 secondes; PHP-FPM et le worker doivent recevoir la même valeur.
• Un lease interne empêche le worker de libérer un panier pendant une confirmation ou une réponse fournisseur en cours. RESERVPRO_API_PAYMENT_PROCESSING_LEASE_SECONDS vaut 300 secondes par défaut (60 à 900); le régler au-dessus du délai maximal des passerelles.
• Avant la production, tester une interruption immédiatement après un débit et activer un rapprochement durable auprès de chaque fournisseur autorisé. Le webhook envoyé au partenaire confirme l’état RéservPro, mais ne remplace pas la preuve entrante ou la réconciliation de la passerelle de paiement.

Parcours partenaire recommandé

1. Obtenir la clé du commerce dans Profil de l’entreprise → Intégration et la conserver côté serveur.
2. Lire catégories et services, puis les fiches, attributs et unités nécessaires.
3. Consulter le calendrier et demander un calcul précis avec les participants, dates et équipements.
4. Créer le panier via /api/reservation avec une IDSession propre au parcours client.
5. Créer le checkout avec une clé d’idempotence stable pour la même opération. Le paiement passe par la page hébergée.
6. Traiter les webhooks signés et relire le statut du checkout avant de confirmer le paiement. Une fermeture d’iframe ne prouve pas le succès.

Après un délai réseau sur une écriture, ne pas répéter aveuglément une création de réservation. Relire le panier; pour le checkout, réutiliser la même clé d’idempotence et le même corps. Pour les tâches, utiliser EtatAttendu et gérer 409. Une clé API donne accès au compte marchand : le serveur partenaire doit aussi isoler ses propres utilisateurs.

Contrats et exemples vérifiés

Les exemples du catalogue proviennent de lectures HTTP de Démo Camping en bêta au 9 septembre 2026. Les exemples métier fictifs sont signalés. Aucun exemple ne garantit une disponibilité future. Les champs existants sont conservés lors des enrichissements présentés ici; tester les intégrations en bêta avant une mise en production autorisée.