Ir al contenido

Inicio rápido

Esta guía te lleva de no tener nada a una integración funcional en unos 30 minutos. Al final vas a tener:

  • precios en vivo para hoteles en una ciudad, desde la Partner API,
  • un enlace de reserva que acredita las reservas a tu cuenta,
  • una reserva de prueba y un webhook que te avisa que sucedió.

Todo sucede en staging, nuestro entorno de pruebas. No necesitás pedirnos acceso, y pasar a producción después tampoco requiere aprobación.

Querés…Empezá acá
Mostrar hoteles en tu app, sitio o producto de IA y enviar viajeros a reservar, ganando comisiónEsta guía
Reservar en nombre de tus clientes como agencia de viajes autorizadaEsta guía hasta el Paso 5, luego Reservar como agencia de viajes
Incrustar hoteles reservables sin escribir una integraciónWeb Components
Permitir que un agente de IA busque y reserveMCP Servers y Agentic Payments
Conectar un channel manager o PMSAgregar tu channel manager

Usás la Partner API para encontrar hoteles y sus precios en vivo. Cada hotel tiene un urlName estable. Lo convertís en un enlace al Wink Booking Engine, book.wink.travel, que lleva tus IDs. El viajero reserva y paga ahí, y la reserva se acredita a tu cuenta.

Vas a necesitar:

  • grpcurl, o Postman o Insomnia. La Partner API es gRPC, no REST.
  • curl.

Staging es completamente separado de producción, con sus propios inicios de sesión y cuentas.

  1. Entrá a staging-app.wink.travel, hacé clic en Sign-In / Register y registrate.

  2. Hacé clic en Accounts en la barra lateral izquierda, luego en Create, y elegí I am an Affiliate. Las reservas que envíes se acreditan a esta cuenta. Mirá Crear cuenta.

La aplicación le da a tu código sus credenciales.

  1. En la tarjeta de tu cuenta, hacé clic en Actions > Manage account, luego en la pestaña Applications.

  2. Hacé clic en Create new application, poné un nombre y elegí Machine-to-machine como tipo de cliente.

  3. En scopes, seleccioná Inventory & rates (lectura). La Partner API verifica inventory.read.

  4. Hacé clic en Create application y copiá el Client ID y el Client secret. El secreto se muestra una vez y no se puede recuperar después.

Mirá Applications para otros tipos de cliente y scopes.

Ventana de terminal
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"

Guardá el access_token de la respuesta:

Ventana de terminal
export WINK_TOKEN=<access_token>

Los tokens expiran. En tu propio código, usá una librería OAuth2 para obtenerlos y renovarlos. Mirá Autenticación.

Si la solicitud del token es rechazada, la respuesta es un cuerpo JSON con un código error:

errorEstado HTTPCausa habitual
invalid_client401Client ID o secreto incorrectos, o se usaron credenciales de producción en staging-iam
invalid_scope400La solicitud pide un scope para el que la aplicación no está registrada
unauthorized_client400La aplicación no tiene permitido usar el grant client_credentials
invalid_request400Falta un parámetro obligatorio, por ejemplo cuando el cuerpo es JSON en lugar de un formulario

Cada llamada a la Partner API nombra la cuenta para la que actuás en un encabezado managing-entity-id. Listá las cuentas para las que tu token puede actuar:

Ventana de terminal
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
-d '{}' \
staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccounts

Copiá el accountId de la cuenta afiliada del Paso 1:

Ventana de terminal
export WINK_ACCOUNT_ID=<accountId>

Staging tiene hoteles de prueba con disponibilidad en Bangkok, así que esta búsqueda usa su slug, bangkok-thailand:

Ventana de terminal
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/SearchByCity

Usá una fecha de check-in en el futuro; una fecha pasada es rechazada. Cada resultado incluye:

  • name, starRating y heroImageUrl, suficiente para mostrar una fila de resultados,
  • roomTypes, las ofertas en vivo, la habitación más barata primero,
  • urlName, el slug que necesitás para el enlace de reserva.

Los precios son enteros en unidades menores: dividí por 10 elevado a la currencyExponent de la respuesta (2 para USD, así que 12500 es $125.00).

¿No conocés el slug de una ciudad? Resolvelo con wink.partner.v1.Lookup/Search. Para el contenido completo de una propiedad, usá el servicio Content. La referencia de la Partner API documenta cada llamada.

https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>
  • <urlName> es el urlName del hotel del Paso 5.
  • client-id es el Client ID de tu aplicación del Paso 2.
  • configuration-id es tu ID de personalización: Manage account > Customizations. Una personalización también configura tu branding, idioma y moneda predeterminados en la página de reserva.

Agregá las fechas, huéspedes, idioma y moneda del viajero al mismo enlace para que la página del hotel se abra con esos datos completados:

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
ParámetroSignificadoEjemplo
sdFecha de check-insd=2027-03-14
n o edCantidad de noches, o fecha de check-outn=2 o ed=2027-03-16
rcHuéspedes por habitaciónrc=a2 (2 adultos)
lIdioma de visualizaciónl=en
cMoneda de visualizaciónc=USD
pCódigo de promociónp=ABC123

Estos parámetros sobreescriben los valores predeterminados configurados en tu personalización. La guía del botón Reservar ahora cubre el formato completo de rc, incluyendo niños y varias habitaciones.

El enlace abre la página del hotel; no puede preseleccionar una habitación o tarifa. El viajero elige la habitación en la página del hotel, al precio en vivo.

Mirá Enlazar directamente para enlazar a la página principal del motor de reservas en lugar de a un hotel específico.

Abrí tu enlace, elegí fechas y una habitación, y pagá con una tarjeta de prueba de Stripe, por ejemplo 4242 4242 4242 4242 con cualquier fecha de vencimiento futura y cualquier CVC. No se cobra ninguna tarjeta real en staging. Anotá el código de reserva en la página de confirmación; empieza con WNK.

Paso 8: Recibir notificaciones sobre reservas

Sección titulada «Paso 8: Recibir notificaciones sobre reservas»
  1. En Portal, andá a Applications > Webhooks y agregá un endpoint que acepte solicitudes POST.

  2. Suscribite a booking.create, o dejá la lista de eventos vacía para recibir todo mientras desarrollás.

  3. Enviate un evento de prueba, luego hacé otra reserva de prueba y mirá que llegue.

Verificá la firma de cada entrega antes de confiar en ella. Mirá Integración de Webhooks y el Catálogo de eventos de Webhooks.

No hay un paso de aprobación para desarrolladores. (Las cuentas de agencias de viajes se certifican primero; ver más abajo.) Cuando tu integración funcione en staging:

  1. Creá una cuenta y una aplicación en app.wink.travel, como en los Pasos 1 y 2. Las credenciales no se transfieren entre entornos.

  2. Eliminá staging- de cada host:

    StagingProducción
    https://staging-iam.wink.travelhttps://iam.wink.travel
    staging-partner.wink.travel:443partner.wink.travel:443
    https://staging-book.wink.travelhttps://book.wink.travel
  3. Buscá nuevamente tu ID de cuenta de producción (Paso 4) y tu ID de personalización (Paso 6). Son diferentes a los de staging.

El uso de la Partner API se mide en noches de hotel, con un cupo mensual gratuito. Mirá Partner API para precios y límites.

Si tu cuenta es una agencia de viajes autorizada, no necesitás enviar viajeros a book.wink.travel: podés crear reservas directamente con wink.partner.v1.Booking/CreateBooking, y gestionarlas con las otras llamadas Booking. Otras cuentas envían viajeros al enlace de reserva.

Las cuentas de agencias de viajes están certificadas: Wink revisa el registro de cada agencia antes de que pueda reservar. Las agencias que quieran cobrar a sus clientes directamente, como comerciante registrado, deben reservar a través de la Partner API y obtener la aprobación escrita de Wink. Mirá Comenzar como agencia de viajes y la referencia de la Partner API.