Requisitos de lanzamiento para B2C independiente
Estos requisitos de lanzamiento se aplican a todos los socios de Expedia Group con un modelo de integración business-to-consumer (B2C) en el que los clientes finales interactúan directamente con tu integración.
Información general
Estos requisitos se han clasificado en dos secciones:
- Requisitos B2C SA: son específicos de este flujo de reserva. 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.
Lista de comprobación
Puedes encontrar una lista de comprobación para ayudarte en tu desarrollo o para dar tu opinión sobre los requisitos aquí. 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.
Requisitos para B2C independiente
Requisitos comunes
Los siguientes requisitos de lanzamiento se aplican a todos los socios de Expedia Group en 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: Prohibido utilizar los nombres y logotipos de Expedia Group o Expedia Group.
El uso de los nombres y logotipos de Expedia Group sólo podrá realizarse en los sitios web de los clientes o de agent-facing con la aprobación previa, explícita y por escrito de Expedia Group como excepción.
Ejemplo:
GR2: Enlaces a la URL de los Términos y Condiciones Expedia Group que deben mostrarse.
Proporciona un enlace a las Condiciones de Expedia Group dentro del propio texto de las condiciones de tu sitio web o enlaza directamente a las condiciones desde tu página de reserva. En estos términos se detallan las políticas que rigen la reserva. Coloca el enlace a continuación en un lugar fácil de encontrar y utiliza el texto "Términos y condiciones del proveedor" en el enlace.
Encontrarás la versión en inglés aquí.
Hay otras versiones disponibles aquí.
Ejemplo:
GR4: Expedia Group MdR - Uso y exposición adecuados en relación con la normativa sobre tarjetas de crédito.
Cuando obtengas, utilices, transmitas, almacenes o proceses datos de titulares de tarjetas de clientes finales, deberás cumplir la norma PCI DSS emitida por el PCI Security Standards Council. Puedes consultar una referencia completa de estas normas en el sitio oficial PCI Security Standards.
GR5: Expedia Group MoR o Property Collect - Prueba de cumplimiento de la PCI suministrada para los socios aplicables.
Si Expedia Group o la propiedad son MdR, debe presentarse un Certificado de Conformidad (AOC) como prueba de cumplimiento de la PCI. Puedes encontrar consejos sobre el cumplimiento de las normas PCI en el sitio oficial PCI Security Standards.
SP1: si el afiliado permite la inclusión de niños en las reservas, se implementan los mensajes correspondientes y la capacidad de especificar las edades de los niños.
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 clientes especifican que viajarán menores, la respuesta de la API puede contener restricciones de edad o bien cargos por ocupación adicional o cuna que pueden afectar al coste o la validez 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: se incluyen descripciones del tipo de cama en cada habitación.
Puede que las respuestas de compra devuelvan la matriz bed_groups con un valor único o varias opciones. Muestra los valores contenidos en la matriz de configuración para describir las camas que ha elegido el cliente.
Si la matriz bed_groups devuelve varias opciones, muestra los enlaces price_check facilitados en la respuesta de compra de cada tipo de cama para permitir que el cliente realice la elección.
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: el indicador de no reembolsable tiene que ser claramente visible.
Non-refundable Las disponibilidades se indican mediante refundable=falseen la respuesta de disponibilidad Tienda. 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: visualización de instrucciones para realizar entradas estándar y especiales.
El contenido de los objetos correspondientes a checkin, checkout, fees y policies tiene que mostrarse para cada habitación, tal y como se devuelve en la definición de contenido del alojamiento. Esta información debe mostrarse en la página de disponibilidad para garantizar que el cliente conozca todas las posibles tasas al realizar la entrada 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: utiliza el cifrado SSL para 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: visualización de instrucciones para realizar entradas estándar y especiales.
El contenido de los objetos correspondientes a checkin, checkout, fees y policies tiene que mostrarse para cada habitación, tal y como se devuelve en la definición de contenido del alojamiento. Esta información debe mostrarse para garantizar que el cliente conozca todas las posibles tasas al realizar la entrada 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.
BP3: la política de cancelación y la etiqueta de no reembolsable se muestran claramente.
Antes de permitir que los clientes confirmen la compra en la última página del proceso de reserva, tienes que mostrarles la política de cancelación o la etiqueta de no reembolsable correspondiente a las habitaciones seleccionadas. La política de cancelación de cada tarifa se indica dentro del objeto cancel_penalties en la API de disponibilidad de Rapid.
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 tarifa no es reembolsable. • No se devuelve ningún periodo de penalización por cancelación. |
refundable=false + cancel_penalties | • La tasa puede ser parcialmente reembolsable. • cancel_penalties debe mostrarse junto con nonrefundable_date_ranges, que mostrará que las fechas de estancia de este intervalo no son reembolsables una vez creada la reserva. |
Puedes encontrar más información sobre cómo crear políticas de cancelación aquí.
Referencia:
refundable=false: - Se cobrará una cantidad no reembolsable inmediatamente después de crear la reserva.cancel_penaltiesynonrefundable_date_rangesofrecerán más información.nonrefundable_date_ranges: - Las fechas de estancia de este periodo no son reembolsables después de que se haya creado la reserva.cancel_penalties: - Se aplica a las fechas de estancia que no se encuentren ennonrefundable_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.
- La tarifa es 100 % no reembolsable cuando
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: muestra los cargos que tienen que pagarse en el alojamiento por separado dentro del desglose de precios.
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 el establecimiento (no el Grupo Expedia ni los gobiernos 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: si procede, deben reiterarse las edades de los menores.
Si tu modelo de integración permite la inclusión de menores y el cliente los especifica para la habitación seleccionada, tienes que confirmar de forma clara el número de menores y sus edades en las páginas de reserva. Esta información se facilita mediante el elemento child_ages.
BP8: MdR del Grupo Expedia o Cobro de la Propiedad: Indica cuándo se cobrará el pago al viajero final.
Si se trata de un MdR del Grupo Expedia, 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 aplica una tarifa no reembolsable posterior al pago, en lugar de ello, tienes que indicar que el alojamiento puede realizar el cobro al cliente poco después de finalizar la reserva.
BP9: cumplimiento de la normativa del Espacio Económico Europeo: Directiva de Servicios de Pago 2 (PSD2).
Cualquier colaborador que tenga la intención de realizar transacciones con clientes en el Espacio Económico Europeo (EEE) tiene que cumplir la PSD2. Más información aquí.
MdR del Grupo Expedia o Recogida de propiedades.
Si el Grupo Expedia es el MdR, o Property Collect se utiliza con clientes europeos, la ruta de reserva debe incluir la adopción de las API de Rapid para la autenticación de dos factores.
Afiliado MdR - General.
Los colaboradores deben seguir los requisitos de autenticación reforzada del cliente (SCA) de la normativa PSD2 cuando las transacciones con los clientes se encuentran dentro del ámbito de la normativa. El texto completo de la directiva está disponible en la Comisión Europea. Encontrarás más información sobre las normas de cumplimiento que se pueden adoptar en el documento de Especificación de funciones básicas y protocolo 3-D Secure de EMVCo.
Afiliado MoR - Tarjeta corporativa o tarjeta virtual.
Los socios que paguen al Grupo Expedia con una tarjeta propiedad del socio, emitida en un país del EEE, deben seguir los requisitos de la normativa PSD2. Para mitigar la necesidad de la autenticación en dos pasos (2FA) de PSD2, un colaborador podría utilizar una tarjeta que cumpla con los pagos B2B y que esté 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: MdR del Grupo Expedia - Lugar de procesamiento del pago mostrado en las páginas de pago
Cuando el Grupo Expedia 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:
