API de alojamiento rápido: Requisitos para el lanzamiento autónomo B2C
Estos requisitos de lanzamiento se aplican si tienes un modelo de integración business-to-consumer (B2C) en el que los viajeros interactúan directamente con tu integración.
Información general
Estos requisitos se han clasificado en dos secciones:
Requisitos independientes: Son específicos de este flujo de reservas. Lee atentamente estos requisitos, ya que pueden ser diferentes de cualquier otro flujo de reserva o tipo de tarifa que hayas integrado anteriormente.
Requisitos comunes: estos requisitos son comunes a todos los flujos de reserva. Asegúrate de cumplir con todos estos requisitos en todos los flujos.
Nota: Cada requisito enumerado a continuación incluye un código de referencia para ayudar a nuestro equipo de atención al cliente a ayudarte.
Lista de comprobación
Hemos creado una lista de comprobación para ayudarte en tu desarrollo o para que nos des tu opinión sobre los requisitos. Si vas a facilitar capturas de pantalla en tu revisión del sitio, añade las capturas y los registros correspondientes en la lista de comprobación, ya que esto nos ayudará a completar la revisión.
Implantaciones B2C
Requisitos comunes
Los siguientes requisitos de lanzamiento se aplican a todos los flujos de reserva. Se proporcionan listas de requisitos adicionales específicas para cada tipo de tarifa, incluida una descripción detallada de la visualización de los precios.
**GR1: No utilización de los nombres y logotipos de Expedia Group **
El uso de nuestros nombres y logotipos sólo se puede utilizar en los sitios traveler-facing o agent-facing con nuestra aprobación explícita por escrito con carácter excepcional.
Ejemplo:
GR2: Mostrar enlace a nuestra URL de términos y condiciones
Proporciona un enlace a nuestros términos y condiciones dentro del propio texto de los términos y condiciones de tu sitio web o enlaza directamente a los términos desde tu página de reserva. En estos términos se detallan las políticas que rigen la reserva. Coloca el siguiente enlace en un lugar de easy-to-find, utilizando el texto del enlace "Condiciones del proveedor".
Las versiones de los términos y condiciones en todos los idiomas que admitimos están disponibles en esta página Rapid API términos y condiciones .
Ejemplo:
GR4: Uso y visualización adecuados de la normativa sobre tarjetas de crédito cuando Expedia Group es Merchant of record (MoR)
Cuando obtengas, utilices, transmitas, almacenes o proceses los datos del titular de la tarjeta del viajero, deberás cumplir la Norma de Seguridad de Datos de la Industria de Tarjetas de Pago (PCI DSS) emitida por el Consejo de Normas de Seguridad de la PCI. Puedes consultar una referencia completa de estas normas en el sitio oficial PCI Security Standards .
GR5: Aportar pruebas del cumplimiento de la PCI para la recogida de bienes o cuando Expedia Group sea MdR (si procede).
Si Expedia Group o la propiedad son MdR, debe presentarse un Certificado de Conformidad (AOC) como prueba del cumplimiento de la PCI. Puedes encontrar consejos sobre el cumplimiento de la normativa PCI en el sitio oficial PCI Security Standards .
SP1: Implementar la mensajería adecuada y la introducción de las edades de los niños si se incluyen niños en las reservas
Si tu integración permite niños viajeros, debes ofrecer la posibilidad de especificar la edad de cada niño viajero en el momento de check-in. Esta información se facilita mediante el elemento occupancy (consulta el ejemplo de código a continuación).
Cuando los viajeros especifican viajeros con niños, la respuesta de la API puede contener restricciones de edad y/o cargos por ocupación extra o cuna que pueden afectar al coste o a la elegibilidad de la reserva.
Cada hotel configurará qué intervalo de edades clasifica como infantil. Normalmente, se considera que son menores las personas que tienen 17 años o menos. Algunos alojamientos no admiten huéspedes menores de 18 años.
Ejemplo de solicitud de la API:
https://api.ean.com/v3/properties/availability?checkin=2020-09-11
&checkout=2020-09-14
¤cy=USD&language=en-US& occupancy=2-9,4 &property_id=XXXX
&country_code=XX&sales_channel=XXXX
&sales_environment=XXXX&filter=XXXX&rate_plan_count=XXXX
&rate_option=XXXX&billing_terms=XXXX&payment_terms=XXXX
&partner_point_of_sale=XXXX&platform_name=XXXXEjemplo de respuesta de la API:
"occupancies": {
"2-9,4" : {
"nightly": [
[Ejemplo de interfaz de usuario: 1 Habitación con 2 adultos y 2 niños de 9 y 4 años
AP1: Mostrar descripciones del tipo de cama para cada habitación
Las respuestas de la API de compras pueden devolver la matriz bed_groupscon un único valor o con varias opciones. Muestra los valores contenidos en la matriz de configuración para describir las opciones de cama del viajero.
Cuando la matriz bed_groupsdevuelve múltiples opciones, muestra los enlaces price_checkproporcionados por la respuesta de Compra para cada tipo de cama para permitir la selección por parte del viajero.
También debes mostrarle un mensaje al viajero que indique que la elección de diferentes tipos de camas para la misma habitación supone tan solo una solicitud y puede que el hotel no la atienda si no hay disponibilidad.
Los nombres de las habitaciones se devuelven dentro de la matriz de habitaciones de la respuesta de compra como room_name.
Ejemplo de respuesta de la API:
"property_id": "11775754",
"rooms": [
{
"id": "230434524",
"room_name": "Superior double room" ,
"rates": [
{
...
"bed_groups": {
"133243": {
"id": "133243",
"description": "Double bed" ,
"links": {...},
"configuration": [...]
},
"133242": {
"id": "133242",
"description": "2 single beds" ,
"links": {...},
"configuration": [...]
}
},Ejemplo de la interfaz de usuario:
**AP2: Hacer claramente visible la bandera non-refundable **
Non-refundable Las disponibilidades se indican mediante refundable=falseen la respuesta de disponibilidad de la API de compras. Cuando se devuelva refundable=falseen una respuesta de disponibilidad, etiqueta claramente las habitaciones correspondientes. Este valor siempre tiene preferencia sobre otros datos diferentes de la política. La propiedad no reembolsará estas reservas bajo ninguna circunstancia.
Ejemplo de respuesta de la API:
"property_id": "XXXX",
"rooms":
"id": "XXXX",
"room_name": "Fairmont King",
"rates":
"id": "XXXX",
"status": "available",
"available_rooms": 4999,
"refundable": false ,
"deposit_required": false,
"merchant_of_record": "expedia",Ejemplo de la interfaz de usuario:
AP3: Mostrar check-in e instrucciones especiales
El contenido de los objetos checkin, checkout, fees, y policiesdebe mostrarse para cada habitación tal y como se devuelve en la definición del alojamiento Contenido. Esta información debe aparecer en tu página de disponibilidad para garantizar que el viajero conoce las posibles tasas en check-in o las instrucciones de acceso especiales.
El campo special_instructionspuede incluir información crítica para check-in que no esté incluida en el campo checkindel objeto instructions, como un requisito para notificar al alojamiento la hora de llegada prevista, check-in en un lugar distinto del edificio de invitados, o una alerta para esperar instrucciones especiales check-in del alojamiento por correo electrónico.
Asegúrate de mostrar tanto instructions como special_instructions al viajero en el mismo espacio.
Ejemplo de respuesta de la API:
"11775754": {
"property_id": "11775754",
"checkin": {
"begin_time": "16:00 PM",
"end_time": "4:00 AM",
"instructions": "Minimum age to check in is 18 years old.
Extra-person charges may apply and vary depending on property policy.
Government-issued photo identification and a credit card may be required at
check-in for incidental charges.
Special requests are subject to availability upon check-in and
may incur additional charges. Special requests cannot be guaranteed.",
"special_instructions": "Front desk staff will greet guests on arrival. For more details,
please contact the property using the information on the booking confirmation.",
"min_age": 18
"checkout": {
"time": "11:00 AM"
"fees": {
"mandatory": "You'll be asked to pay the following charges at the property:
Deposit: USD 50 per day
Resort fee: USD 28.25 per accommodation, per night The resort fee includes: Pool access, Fitness center access, Fitness/yoga classes, Airport shuttle, Phone calls, In-room safe, Self parking, Valet parking, Parking. We have included all charges provided to us by the property.
However, charges can vary, for example, based on length of stay or the room you book.",
"optional": "The following fees and deposits are charged by the property at time of service,
check-in, or check-out. Breakfast fee: between USD 6 and USD 25 per person
(approximately), Late check-out is available for a fee (subject to availability)Rollaway bed fee: USD 20.0 per night.
The above list may not be comprehensive. Fees and deposits may not include tax and are subject to change."
"policies": {
"know_before_you_go": "Up to 2 children 12 years old and younger stay free when
occupying the parent or guardian's room, using existing bedding.
The property has connecting/adjoining rooms, which are subject to availability
and can be requested by contacting the property using the number on the booking
confirmation."Ejemplo de la interfaz de usuario:
BP1: Utilizar encriptación SSL para los datos personales
Al enviar o transmitir datos personales, debes utilizar el cifrado SSL para proteger las conexiones entre los navegadores o las aplicaciones del cliente y tu sitio web, así como las comunicaciones de red con sistemas dependientes. Son datos personales, entre otros, los nombres de los huéspedes, los números de teléfono, las direcciones de correo electrónico, los detalles de tarjetas de pago, los comprobantes de reservas e itinerarios y las páginas de confirmación. Detén o redirige la conexión cuando no esté protegida.
BP2: Mostrar check-in e instrucciones especiales
El contenido de los objetos checkin, checkout, fees, y policiesdebe mostrarse para cada habitación tal y como se devuelve en la definición del alojamiento Contenido. Esta información debe mostrarse para garantizar que el viajero es consciente de las posibles tasas en check-in o de las instrucciones especiales de acceso antes de finalizar su reserva.
El campo special_instructionspuede incluir información crítica para check-in que no esté incluida en el campo checkindel objeto instructions, como un requisito para notificar al alojamiento la hora de llegada prevista, check-in en un lugar distinto del edificio de invitados, o una alerta para esperar instrucciones especiales check-in del alojamiento por correo electrónico.
Asegúrate de mostrar tanto instructions como special_instructions al viajero en el mismo espacio.
**BP3: Mostrar claramente la política de cancelación y la etiqueta non-refundable **
Antes de permitir que los viajeros confirmen su compra en tu página de reserva final, debes facilitar la política de cancelación o la etiqueta non-refundable de la habitación o habitaciones seleccionadas. La política de cancelación de cada tarifa se proporciona en el objeto cancel_penaltiesde la API de disponibilidad de Rapid Shopping.
En el caso de las tarifas reembolsables, la respuesta incluye distintos detalles de la política de cancelación. Estos detalles incluyen la fecha de inicio y fin de la penalización especificada, así como el tipo y el valor de esta, y todas las fechas de reserva con excepciones que se apliquen. Entre los tipos de penalización, se incluyen un importe fijo, un número de noches y un porcentaje del coste total.
| Respuesta | Significado |
|---|---|
refundable=true | Esta tarifa es totalmente reembolsable. |
refundable=true + cancel_penalties | • Esta tarifa es reembolsable durante el plazo de cancelación. • La fecha más temprana cancel_penalties.[].startes la fecha límite de cancelación gratuita, si se trata de un plazo futuro.• La tasa es del 100% non-refundable después del último cancel_penalties.[].end |
refundable=false | • Esta tasa es non-refundable. • No se devuelve ningún periodo de penalización por cancelación. |
refundable=false + cancel_penalties | • La tasa puede ser parcialmente reembolsable. • cancel_penaltiesdebe mostrarse junto con nonrefundable_date_ranges, que mostrará que las fechas de estancia de este rango son non-refundable una vez creada la reserva. |
Lee más sobre cómo construir políticas de cancelación.
Referencia:
refundable=false: Se incurrirá en un importe de non-refundable inmediatamente después de crear la reserva. cancel_penaltiesy nonrefundable_date_rangesproporcionarán más detalles.
nonrefundable_date_ranges: Las fechas de estancia de este rango son non-refundable una vez creada la reserva.
cancel_penalties:
- Se aplica a las fechas de estancia que no se encuentren en
nonrefundable_date_ranges. - La tarifa es 100 % no reembolsable cuando
cancel_penaltiesestá vacío o no se devuelve. - Se cobrará una penalización cuando se realice una cancelación dentro del periodo de
cancel_penalties. - El primer periodo
cancel_penalties.[].startes la fecha límite de cancelación; si es un plazo futuro la tarifa es 100 % no reembolsable después del últimocancel_penalties.[].end.
Ejemplos de respuestas de la API:
Completamente reembolsable:
"property_id": "XXXX",
"rooms": [
{
"id": "XXXX",
"room_name": "Traditional Room",
"rates":
"id": "XXXX",
"status": "available",
"available_rooms": 4999,
"refundable": true,
"cancel_penalties": [
{
"start": "2021-05-27T18:00:00.000-07:00",
"end": "2021-05-28T18:00:00.000-07:00",
"amount": "76.00",
"currency": "USD"No reembolsable:
"property_id": "XXXX",
"rooms":
"id": "XXXX",
"room_name": "Traditional Room",
"rates":
"id": "XXXX",
"status": "available",
"available_rooms": 4999,
"refundable": false ,
"deposit_required": false,
"merchant_of_record": "expedia",Parcialmente reembolsable:
"property_id": "XXXX",
"rooms": [
{
"id": "XXXX",
"room_name": "Traditional Room",
"rates":
"id": "XXXXXXXX",
"status": "available",
"available_rooms": 4999,
"refundable": false,
"cancel_penalties": [
{
"start": "2023-09-03T13:59:00.000+02:00",
"end": "2023-09-04T13:59:00.000+02:00",
"nights": "1",
"currency": "USD"
}
],
"nonrefundable_date_ranges": [
{
"start": "2023-09-08",
"end": "2023-09-13"
}
],Ejemplo de la interfaz de usuario:
BP4: Indicar por separado en el desglose del precio los gastos debidos en la vivienda
Cuando se devuelvan los cargos en la matriz de fees, muestra cada valor por separado como un cargo que se tiene que pagar en el alojamiento (entrada o salida). Presenta al viajero la moneda local y solicita divisas. Estos cargos los cobra directamente la propiedad (no nosotros ni las administraciones locales) y no forman parte de los cargos estándar de recuperación de impuestos, impuestos o tasas incluidos en la línea de impuestos y tasas.
Ejemplo de respuesta de la API:
"fees" : {
"resort_fee": {
"request_currency": {
"value": "74.97",
"currency": "USD"
},
"billable_currency": {
"value": "74.97",
"currency": "USD"
},
"scope": "per_accommodation",
"frequency": "per_night"
}
},Ejemplo de la interfaz de usuario:
BP7: Reitera las edades de los niños (si procede)
Si tu integración permite niños viajeros y el viajero especificó niños viajeros para su selección de habitación, debes confirmar claramente el número de niños viajeros y sus edades en tus páginas de reserva. Esta información se facilita mediante el elemento child_ages.
BP8: Indicar cuándo se cobrará el pago al viajero final (si la propiedad cobra o cuando Expedia Group es MdR)
Si Expedia Group es la MdR, indica que se cargará inmediatamente en la tarjeta de crédito facilitada el importe total de la reserva.
En el caso de Property Collect, tiene que especificarse que el alojamiento hará el cargo en la tarjeta de crédito indicada al realizar la entrada o la salida. Si el alojamiento ofrece una tarifa non-refundable post-pay, indica en su lugar que el alojamiento podría cobrar al viajero poco después de completar la reserva.
BP9: Cumplimiento de la Normativa del Espacio Económico Europeo.
El Espacio Económico Europeo (EEE) exige el cumplimiento de la autenticación fuerte del cliente (SCA) si pretendes realizar transacciones con viajeros allí.
Más información sobre el cumplimiento de la SCA
Expedia Group es MdR o Propiedad Recaudar
Si Expedia Group es la MdR, o Property Collect se utiliza con viajeros del Espacio Económico Europeo (EEE) o Japón, la ruta de reserva debe incluir la adopción de las API de Rapid para la autenticación de two-factor.
MdR Afiliados - General
Debes seguir los requisitos de SCA cuando las transacciones con viajeros estén dentro del ámbito de aplicación de la normativa. El texto completo de la Directiva revisada sobre Servicios de Pago (DSP2) está disponible en Comisión Europea. Para más información sobre las normas compatibles que pueden adoptarse, consulta la Especificación del Protocolo y Funciones Básicas 3D Secure de EMVCo.
Affiliate MoR - Tarjeta corporativa o tarjeta virtual
Si nos pagas con tu propia tarjeta, emitida en un país del EEE o Japón, debes seguir los requisitos de SCA. Para mitigar la necesidad de la autenticación two-factor (2FA), podrías utilizar una tarjeta compatible con los pagos B2B y exenta de 2FA.
Entre las opciones válidas se incluyen:
- Tarjetas virtuales de un solo uso.
- Tarjeta corporativa de varios usos registrada a nombre de la empresa (no para una persona). Se requiere una configuración especial del perfil.
Ejemplo de solicitud de la API:
https://api.ean.com<Price Check link from previous availability request>Ejemplo de respuesta de la API:
{
"status": "available",
"occupancy_pricing": {... },
"links": {
"payment_session": {
"method": "POST",
"href": "/v3/payment-sessions?token=XXXX"
}
}
}BP10: Mostrar el lugar de procesamiento del pago en las páginas de pago cuando Expedia Group es MoR
Cuando Expedia Group sea MoR, el país en el que se procesará el pago debe aparecer en un lugar destacado de la página de pago. Se debe insertar la frase “Este pago se procesará en” antes del nombre del país.
Utiliza la función Opciones de pago de la API de compras para recuperar esta información.
Ejemplo de solicitud de la API:
https://api.ean.com<payment-options link from previous availability request>Ejemplo de respuesta de la API:
"credit_card": {
"name": "Credit Card",
"card_options": [
{
"name": "MasterCard",
"processing_country": "US"
},
{
"name": "Visa",
"processing_country": "US"
}
]
}Ejemplo de la interfaz de usuario:
