Requisitos de lanzamiento para B2B independiente
Estos requisitos de lanzamiento se aplican a todos los socios con un modelo de integración de empresa a empresa (B2B) en el que los clientes finales interactúan con una de tus agencias de viajes.
Información general
Los requisitos de lanzamiento B2B se clasifican en dos secciones:
Requisitos B2B SA - 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.
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 específicos B2B SA
Requisitos comunes de lanzamiento
Los siguientes requisitos de lanzamiento se aplican a todos los socios del Grupo Expedia 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: Uso de los nombres y logotipos del Grupo Expedia
El uso de los nombres y logotipos del Grupo Expedia sólo puede utilizarse en sitios orientados al cliente o al agente con la aprobación explícita por escrito y por adelantado del Grupo Expedia como excepción.
Ejemplo:
GR2: Enlaces a la URL de los términos y condiciones del Grupo Expedia que deben mostrarse
Proporciona un enlace a los Términos y Condiciones del Grupo Expedia 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 enlace siguiente en un lugar fácil de encontrar y utiliza el texto "Términos y condiciones del proveedor" en el enlace. La versión inglesa se puede encontrar aquí otras versiones se enumeran aquí.
Ejemplo:
GR4: MdR del Grupo Expedia: Uso y visualizació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 publicada por el PCI Security Standards Council. Puedes consultar una referencia completa de esta normativa en el sitio web oficial PCI Security Standards Council.
GR5: MdR del Grupo Expedia o Property Collect: Pruebas de cumplimiento de la PCI suministradas para los socios aplicables
Cuando el Grupo Expedia o la Propiedad sean MdR, se debe proporcionar un Certificado de Cumplimiento (AOC) como prueba del cumplimiento de la PCI.
Puedes encontrar consejos sobre el cumplimiento de la normativa PCI en el sitio web oficial PCI Security Standards Council.
SP1: Cuando el afiliado permite que se incluyan niños en las reservas, se implementa la mensajería adecuada y la introducción de 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 la facturación. Esta información se facilita a través del objeto occupancy (ver ejemplo más abajo).
Cuando los clientes especifican que viajarán menores, la respuesta de la API puede contener restricciones de edad o cargos por ocupación adicional o cuna que pueden afectar al coste o la idoneidad 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/2.4/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 la interfaz de usuario: 1 habitación con 2 adultos y 2 menores de 9 y 4 años.
AP1: Hay descripciones del tipo de cama para cada habitación
Las respuestas de la tienda pueden devolver la matriz bed_groups con un único valor o con varias opciones. Muestra los valores contenidos en la matriz de configuración para describir las camas que ha elegido el cliente.
Si la bed_groups matriz 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 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: La bandera no reembolsable es claramente visible
Las disponibilidades no reembolsables se indican mediante refundable=false en la respuesta de disponibilidad de Shop. Cuando se devuelva refundable=false en una respuesta de disponibilidad, etiqueta claramente las habitaciones correspondientes. Este valor siempre tiene preferencia sobre otros datos diferentes de la política. El alojamiento no reembolsará el importe de 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 instrucciones de facturación y facturación especial
El contenido de los objetos checkin, checkout, fees, y policies debe mostrarse para cada habitación tal y como se devuelve en la propiedad contenido definición. Esta información debe aparecer en tu página de disponibilidad para garantizar que el cliente conozca las posibles tasas al registrarse o las instrucciones de acceso especiales.
El campo de registro especial puede incluir información crítica para el registro que no esté incluida en el campo de instrucciones del objeto checkin, como el requisito de notificar a la propiedad la hora de llegada prevista, el registro en un lugar distinto del edificio de invitados o una alerta para esperar instrucciones especiales de registro de la propiedad 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.
<br />Extra-person charges may apply and vary depending on property policy.
<br />Government-issued photo identification and a credit card may be required at
check- in for incidental charges.
<br />Special requests are subject to availability upon check-in and
may incur additional charges. Special requests cannot be guaranteed. <ul>. ",
"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": "<p>You'll be asked to pay the following charges at the property:</p>
<ul><li>Deposit: USD 50 per day</li>
<li>Resort fee: USD 28.25 per accommodation,
per night</li></ul> The resort fee includes:<ul
><li>Pool access</li><li>Fitness center access</li><li>Fitness/yoga classes</li>
<li>Airport shuttle</li><li>Phone calls</li><li>In-room safe</li><li>Self parking</li>
<li>Valet parking</li><li>Parking</li></ul> <p>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. </p>",
"optional": "<p>The following fees and deposits are charged by the property at time of service,
check-in, or check-out. </p> <ul> <li>Breakfast fee: between USD 6 and USD 25 per person
(approximately)</li> <li>Late check-out is available for a fee (subject to availability)</li>
<li>Rollaway bed fee: USD 20.0 per night</li>
</ul> <p>The above list may not be comprehensive. Fees and deposits may not include tax
and are subject to change. </p>"
"policies": {
"know_before_you_go": "<ul> <li>Up to 2 children 12 years old and younger stay free when
occupying the parent or guardian's room, using existing bedding. </li>
<li>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. </li> </ul>"Ejemplo de la interfaz de usuario:
BP1: El cifrado SSL está presente 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 crédito y los comprobantes y las páginas de confirmación de reservas e itinerarios. Detén o redirige la conexión cuando no esté protegida.
PB2: Mostrar instrucciones de facturación y facturación especial
El contenido de los objetos checkin, checkout, fees, y policies debe mostrarse para cada habitación tal y como se devuelve en la propiedad contenido definición. 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 de registro especial puede incluir información crítica para el registro que no esté incluida en el campo de instrucciones del objeto checkin, como el requisito de notificar a la propiedad la hora de llegada prevista, el registro en un lugar distinto del edificio de invitados o una alerta para esperar instrucciones especiales de registro de la propiedad por correo electrónico.
Asegúrate de mostrar tanto instructions como special_instructions al viajero en el mismo espacio.
BP3: Política de cancelación y etiqueta no reembolsable claramente expuestas
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.[].start es la fecha límite de cancelación gratuita, si se trata de un plazo futuro.• La tarifa es 100% no reembolsable 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. |
Más información sobre cómo elaborar políticas de cancelación en 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 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. - La fecha más temprana
cancel_penalties.[].startes la fecha límite de cancelación gratuita, si se trata de un plazo futuro. - La tarifa es 100% no reembolsable después de la última
cancel_penalties.[].end.
Ejemplo de respuesta de la API: Política de cancelación y bandera no reembolsable
"property_id": "11775754",
"rooms": [
{
"id": "230434524",
"room_name": "Traditional Room (Partner:Connect Test)",
"rates":
"id": "276321199",
"status": "available",
"available_rooms": 4999,
"refundable": true,
"cancel_penalties": [
{
"start": "2020-09-10T18:00:00.000-07:00",
"end": "2020-09-11T18:00:00.000-07:00",
"amount": "76.00",
"currency": "USD"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 tasas, 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 el gobierno local) 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: Matriz de tasas
"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:
Ejemplo de habitación doble estándar](resources/reference/assets/Price_display_must_include_the_total_price_and_breakdown_of_the_taxes_and_fees.png'Standard double room example'
BP7: Si procede, deben reiterarse las edades de los niños
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 proporciona a través del objeto 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í.
Grupo Expedia MoR o Propiedad Recoger
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 .
MdR Afiliados - 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 Especificación de funciones básicas y protocolo 3-D Secure de EMVCo.
Affiliate 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 2FA de la PSD2, un socio podría utilizar una tarjeta que cumpla la normativa para pagos B2B y esté exenta de la 2FA (autenticación de dos factores).
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 para la verificación de precios:
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": "/2.4/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. La frase "Este pago se procesará en" debe insertarse 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 para las opciones de pago:
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:
