Requisitos de lanzamiento para B2B independiente
Estos requisitos de lanzamiento se aplican a todos los colaboradores de EPS con un modelo de integración B2B en el que los clientes finales interactúan con uno de tus agentes de viaje.
Información general
Los requisitos se han clasificado en dos secciones para ayudar a la experiencia de integración:
- Requisitos para B2B independiente: 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
Encontrarás una lista de comprobación para ayudar al desarrollo o para proporcionar comentarios sobre los requisitos en este enlace. 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 B2B independiente
GR3: los agentes tienen que aceptar las Condiciones de uso de EPS para acceder al inventario de EPS.
Los agentes que efectúan una reserva en nombre de un usuario final o un viajero tienen que aceptar el acuerdo de agente de EPS. Tiene que facilitarse un enlace al acuerdo del agente para que los agentes lo revisen y lo acepten antes de efectuar una reserva. Hay otras versiones disponibles aquí.
Requisitos comunes
Los requisitos de lanzamiento a continuación se aplican a todos los colaboradores de EPS 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: no utilices los nombres ni los logotipos de Expedia Group ni EPS.
No podrán utilizarse los nombres ni los logotipos de Expedia Group o EPS en los sitios asociados para clientes con ningún fin. Cualquier excepción (por ejemplo, los comentarios de los huéspedes) debe ser aprobada por adelantado por parte de EPS y acordada explícitamente por escrito.
Ejemplo:
GR2: enlaces a la URL de los términos y condiciones de EPS que se van a mostrar.
Facilita un enlace a los términos y condiciones de EPS en el texto de los términos y condiciones de tu propio sitio web, o bien 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 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: EPS MoR - Uso y visualización apropiados en relación con la normativa de tarjetas de crédito.
Allí donde obtengas, uses, transmitas, almacenes o proceses los datos del titular de la tarjeta del cliente final, tendrás que cumplir con los DSS PCI emitidos por el Consejo de Normas de Seguridad de PCI. Encontrarás una referencia completa de esta normativa en el sitio web oficial de las normas de seguridad de PCI.
GR5: EPS MoR o Property Collect - Prueba de cumplimiento de los estándares de PCI para los colaboradores que corresponda.
Allí donde EPS o el alojamiento actúe como intermediario oficial, tiene que suministrarse una certificación de cumplimiento (AOC) como prueba de cumplimiento de PCI. Los colaboradores de EPS tienen que utilizar el cuestionario de autoevaluación del Consejo de Normas de Seguridad de PCI titulado "SAQ D - Merchants" para generar la AOC adecuada.
Puedes revisar las instrucciones y directrices de los cuestionarios de autoevaluación y consultar el archivo "SAQ D - Merchants" en la biblioteca de documentos oficiales del Consejo de Normas de Seguridad de PCI, o bien descargarlo directamente como documento GR o Word.
SP1: si el afiliado permite la inclusión de niños en las reservas, se requieren los mensajes correspondientes y la capacidad de especificar las edades de los niños.
Si tu integración admite menores, tienes que ofrecer la posibilidad de especificar la edad de cada menor. 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 cargos por ocupación adicional o cuna que pueden afectar al coste o la idoneidad de la reserva.
Cada alojamiento 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 la interfaz de usuario: 1 habitación con 2 adultos y 2 menores 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 alojamiento 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, grupos de camas:
"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": [...]
}
},
AP2: el indicador de no reembolsable tiene que ser claramente visible.
Las tarifas no reembolsables deben indicarse claramente en la página de disponibilidad. Cuando refundable=false y no se devuelva la política de cancelación, la habitación debe etiquetarse como no reembolsable.
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:
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_instructions puede incluir información fundamental sobre la entrada que no se incluya en el campo instructions del objeto checkin, como el requisito de notificar al alojamiento la hora de llegada prevista, la realización del registro de entrada en una ubicación distinta o una alerta sobre el envío por correo electrónico de instrucciones especiales de entrada por parte del alojamiento.
Asegúrate de mostrar tanto instructions como special_instructions al viajero en el mismo espacio.
Ejemplo de respuesta de la API con instrucciones especiales de entrada:
"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, and 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 contenido extraído del alojamiento:
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_instructions puede incluir información fundamental sobre la entrada que no se incluya en el campo instructions del objeto checkin, como el requisito de notificar al alojamiento la hora de llegada prevista, la realización del registro de entrada en una ubicación distinta o una alerta sobre el envío por correo electrónico de instrucciones especiales de entrada por parte del alojamiento.
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.
Cuando:
refundable=true- Esta tarifa es totalmente reembolsable.
refundable=true+cancel_penalties- Esta tarifa es reembolsable durante el plazo de cancelación.
- 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.
refundable=false- Esta tarifa no es reembolsable.
- No se devuelve ningún periodo de penalización por cancelación.
refundable=false+cancel_penalties
- La tarifa puede ser parcialmente reembolsable.
cancel_penaltiesdebe mostrarse junto connonrefundable_date_ranges, que indicará las fechas de estancia de este periodo que no es reembolsable una vez que se cree 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:
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 tasas, muestra cada valor por separado como un cargo que se tiene que pagar en el alojamiento (entrada o salida). Estos cargos los recauda directamente el alojamiento (no EPS ni los Gobiernos locales) y no forman parte de las tasas de recuperación de impuestos, impuestos o tasas incluidos en la línea "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:
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 occupancy.
BP8: EPS MoR o Property Collect - Indica cuándo se realizará el cobro al viajero final.
En el caso de EPS MOR, tiene que especificarse que se cargará inmediatamente el importe íntegro de la reserva en la tarjeta de crédito facilitada.
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í.
EPS MoR o Property Collect
Si EPS actúa como intermediario oficial o se utiliza Property Collect con clientes europeos, la página de reserva debe incluir la adopción de API para la autenticación en dos pasos de Rapid.
Afiliado MoR - 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.
Afiliado MoR - Tarjeta corporativa o tarjeta virtual
Los colaboradores que paguen a EPS con una tarjeta de colaborador 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).
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 para la verificación de precios:
{
"status": "available",
"occupancy_pricing": {... },
"links": {
"payment_session": {
"method": "POST",
"href": "/v3/payment-sessions?token=XXXX"
}
}
}BP10: EPS MoR o Property Collect Premium - La ubicación de procesamiento de los pagos se tiene que mostrar en las páginas de tramitación de pagos.
Si EPS o el alojamiento son un intermediario oficial, el país donde se procesará el pago tiene que mostrarse en un lugar destacado en la página de pago. Se tiene que 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 para las opciones de pago:
https://api.ean.com<payment-options link from previous availability request>Ejemplo de respuesta de la API para las opciones de pago:
"credit_card": {
"name": "Credit Card",
"card_options": [
"name": "MasterCard",
"processing_country": "US"
"name": "Visa",
"processing_country": "US"Ejemplo de la interfaz de usuario:
