Démarrage rapide
Ce guide vous mène de rien à une intégration fonctionnelle en environ 30 minutes. À la fin, vous aurez :
- des prix en direct pour les hôtels d’une ville, via l’API Partner,
- un lien de réservation qui crédite les réservations sur votre compte,
- une réservation test, et un webhook vous informant qu’elle a eu lieu.
Tout se passe en staging, notre environnement de test. Vous n’avez pas besoin de nous demander l’accès, et passer en production plus tard ne nécessite pas d’approbation non plus.
Ce guide est-il fait pour vous ?
Section intitulée « Ce guide est-il fait pour vous ? »| Vous voulez… | Commencez ici |
|---|---|
| Afficher des hôtels dans votre application, site ou produit IA et envoyer les voyageurs réserver, en gagnant une commission | Ce guide |
| Réserver au nom de vos clients en tant qu’agence de voyages agréée | Ce guide jusqu’à l’étape 5, puis Réserver en tant qu’agence de voyages |
| Intégrer des hôtels réservables sans écrire d’intégration | Web Components |
| Laisser un agent IA rechercher et réserver | Serveurs MCP et Paiements Agentic |
| Connecter un channel manager ou PMS | Ajouter votre channel manager |
Comment ça marche
Section intitulée « Comment ça marche »Vous utilisez l’API Partner pour trouver des hôtels et leurs prix en direct. Chaque hôtel a un urlName stable. Vous le transformez en lien vers le moteur de réservation Wink, book.wink.travel, en y ajoutant vos identifiants. Le voyageur réserve et paie là-bas, et la réservation est créditée sur votre compte.
Avant de commencer
Section intitulée « Avant de commencer »Vous aurez besoin de :
grpcurl, ou Postman ou Insomnia. L’API Partner est en gRPC, pas REST.curl.
Étape 1 : Créez un compte en staging
Section intitulée « Étape 1 : Créez un compte en staging »Le staging est complètement séparé de la production, avec ses propres connexions et comptes.
-
Allez sur staging-app.wink.travel, cliquez sur
Sign-In / Registeret inscrivez-vous. -
Cliquez sur
Accountsdans la barre latérale gauche, puis surCreate, et choisissez I am an Affiliate. Les réservations que vous envoyez sont créditées sur ce compte. Voir Créer un compte.
Étape 2 : Créez une application
Section intitulée « Étape 2 : Créez une application »L’application fournit les identifiants à votre code.
-
Sur la carte de votre compte, cliquez sur
Actions>Manage account, puis l’ongletApplications. -
Cliquez sur
Create new application, donnez-lui un nom et choisissez Machine-to-machine comme type de client. -
Sous scopes, sélectionnez Inventory & rates (lecture). L’API Partner vérifie la présence de
inventory.read. -
Cliquez sur
Create applicationet copiez le Client ID et le Client secret. Le secret est affiché une seule fois et ne peut pas être récupéré plus tard.
Voir Applications pour les autres types de clients et scopes.
Étape 3 : Obtenez un jeton d’accès
Section intitulée « Étape 3 : Obtenez un jeton d’accès »curl -X POST https://staging-iam.wink.travel/oauth2/token \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "grant_type=client_credentials" \ -d "client_id=<YOUR_CLIENT_ID>" \ -d "client_secret=<YOUR_CLIENT_SECRET>" \ -d "scope=inventory.read"Sauvegardez le access_token de la réponse :
export WINK_TOKEN=<access_token>Les jetons expirent. Dans votre propre code, laissez une bibliothèque OAuth2 les récupérer et les rafraîchir. Voir Authentification.
Si la demande de jeton est rejetée, la réponse est un corps JSON avec un code error :
error | Statut HTTP | Cause habituelle |
|---|---|---|
invalid_client | 401 | Mauvais client ID ou secret, ou identifiants de production utilisés sur staging-iam |
invalid_scope | 400 | La requête demande un scope que l’application n’a pas |
unauthorized_client | 400 | L’application n’est pas autorisée à utiliser le grant client_credentials |
invalid_request | 400 | Un paramètre requis manque, par exemple quand le corps est JSON au lieu d’un formulaire |
Étape 4 : Trouvez votre ID de compte
Section intitulée « Étape 4 : Trouvez votre ID de compte »Chaque appel à l’API Partner nomme le compte pour lequel vous agissez dans un header managing-entity-id. Listez les comptes que votre jeton peut gérer :
grpcurl -H "authorization: Bearer $WINK_TOKEN" \ -d '{}' \ staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccountsCopiez le accountId du compte affilié de l’étape 1 :
export WINK_ACCOUNT_ID=<accountId>Étape 5 : Recherchez des hôtels dans une ville
Section intitulée « Étape 5 : Recherchez des hôtels dans une ville »Le staging dispose d’hôtels tests avec disponibilité à Bangkok, cette recherche utilise donc son slug, bangkok-thailand :
grpcurl -H "authorization: Bearer $WINK_TOKEN" \ -H "managing-entity-id: $WINK_ACCOUNT_ID" \ -d '{ "urlName": "bangkok-thailand", "userSession": { "itinerary": { "startDate": "2026-12-01", "nights": 2, "room": { "adults": 2 } }, "currencyCode": "USD", "languageCode": "en" } }' \ staging-partner.wink.travel:443 wink.partner.v1.Search/SearchByCityUtilisez une date d’arrivée dans le futur ; une date passée est rejetée. Chaque résultat contient :
name,starRatingetheroImageUrl, suffisants pour afficher une ligne de résultat,roomTypes, les offres en direct, la chambre la moins chère en premier,urlName, le slug dont vous avez besoin pour le lien de réservation.
Les prix sont des entiers en unités mineures : divisez par 10 à la puissance currencyExponent de la réponse (2 pour USD, donc 12500 correspond à 125,00 $).
Vous ne connaissez pas le slug d’une ville ? Résolvez-le avec wink.partner.v1.Lookup/Search. Pour le contenu complet d’un établissement, utilisez le service Content. La référence de l’API Partner documente chaque appel.
Étape 6 : Construisez le lien de réservation
Section intitulée « Étape 6 : Construisez le lien de réservation »https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID><urlName>est leurlNamede l’hôtel obtenu à l’étape 5.client-idest le Client ID de votre application de l’étape 2.configuration-idest votre ID de personnalisation :Manage account>Customizations. Une personnalisation définit aussi votre branding, langue et devise par défaut sur la page de réservation.
Transmettez la recherche du voyageur
Section intitulée « Transmettez la recherche du voyageur »Ajoutez les dates, invités, langue et devise du voyageur au même lien pour que la page de l’hôtel s’ouvre avec ces informations pré-remplies :
https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>&sd=2027-03-14&n=2&rc=a2&l=en&c=USD| Paramètre | Signification | Exemple |
|---|---|---|
sd | Date d’arrivée | sd=2027-03-14 |
n ou ed | Nombre de nuits, ou date de départ | n=2 ou ed=2027-03-16 |
rc | Invités par chambre | rc=a2 (2 adultes) |
l | Langue d’affichage | l=en |
c | Devise d’affichage | c=USD |
p | Code promotionnel | p=ABC123 |
Ces paramètres remplacent les valeurs par défaut définies dans votre personnalisation. Le guide du bouton Réserver maintenant couvre le format complet de rc, incluant enfants et plusieurs chambres.
Le lien ouvre la page de l’hôtel ; il ne peut pas pré-sélectionner une chambre ou un tarif. Le voyageur choisit la chambre sur la page de l’hôtel, au prix en direct.
Voir Lien direct pour un lien vers la page d’accueil du moteur de réservation au lieu d’un hôtel unique.
Étape 7 : Faites une réservation test
Section intitulée « Étape 7 : Faites une réservation test »Ouvrez votre lien, choisissez des dates et une chambre, et payez avec une carte test Stripe, par exemple 4242 4242 4242 4242 avec une date d’expiration future et un CVC quelconque. Aucune carte réelle n’est débitée en staging. Notez le code de réservation sur la page de confirmation ; il commence par WNK.
Étape 8 : Soyez notifié des réservations
Section intitulée « Étape 8 : Soyez notifié des réservations »-
Dans Portal, allez à
Applications > Webhookset ajoutez un endpoint acceptant les requêtesPOST. -
Abonnez-vous à
booking.create, ou laissez la liste d’événements vide pour tout recevoir pendant le développement. -
Envoyez-vous un événement test, puis faites une autre réservation test et vérifiez sa réception.
Vérifiez la signature de chaque livraison avant de lui faire confiance. Voir Intégration Webhook et le Catalogue des événements Webhook.
Étape 9 : Passez en production
Section intitulée « Étape 9 : Passez en production »Il n’y a pas d’étape d’approbation pour les développeurs. (Les comptes d’agences de voyages sont certifiés d’abord ; voir ci-dessous.) Quand votre intégration fonctionne en staging :
-
Créez un compte et une application sur app.wink.travel, comme aux étapes 1 et 2. Les identifiants ne sont pas transférés entre environnements.
-
Supprimez
staging-de chaque hôte :Staging Production https://staging-iam.wink.travelhttps://iam.wink.travelstaging-partner.wink.travel:443partner.wink.travel:443https://staging-book.wink.travelhttps://book.wink.travel -
Recherchez à nouveau votre ID de compte production (étape 4) et votre ID de personnalisation (étape 6). Ils diffèrent de ceux du staging.
L’utilisation de l’API Partner est mesurée en nuitées hôtelières, avec un quota mensuel gratuit. Voir API Partner pour les tarifs et limites.
Réserver en tant qu’agence de voyages
Section intitulée « Réserver en tant qu’agence de voyages »Si votre compte est une agence de voyages agréée, vous n’avez pas besoin d’envoyer les voyageurs vers book.wink.travel : vous pouvez créer des réservations directement avec wink.partner.v1.Booking/CreateBooking, et les gérer avec les autres appels Booking. Les autres comptes envoient les voyageurs vers le lien de réservation.
Les comptes d’agences sont certifiés : Wink vérifie l’enregistrement de chaque agence avant qu’elle puisse réserver. Les agences souhaitant collecter elles-mêmes le paiement de leurs clients, en tant que commerçant de référence, doivent réserver via l’API Partner et obtenir l’approbation écrite de Wink. Voir Commencer en tant qu’agence de voyages et la référence de l’API Partner.
Étapes suivantes
Section intitulée « Étapes suivantes »- Générez un client typé à partir du schéma
.protoau lieu d’appelergrpcurlmanuellement. - Connectez le serveur MCP et utilisez les Compétences IA pour que votre assistant de codage écrive l’intégration contre l’API en direct.
- Lisez la liste complète des environnements et hôtes.
