Requisitos de lanzamiento para B2C independiente
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 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
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.
Requisitos para B2C independiente
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 utilizar 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: Se mostrarán enlaces a la URL de nuestros 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 enlace a continuación en un lugar fácil de encontrar y utiliza el texto "Términos y condiciones del proveedor" en el enlace.
Puedes encontrar la versión en inglés y otras versiones listadas en Expedia Soluciones para socios.
Ejemplo:
GR4: Somos Merchant of record (MoR): Uso adecuado y visualización de la normativa sobre tarjetas de crédito.
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: Somos MdR o Property Collect: Prueba de cumplimiento de la PCI suministrada cuando proceda.
Cuando nosotros o la propiedad seamos MdR, deberá 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 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: se incluyen descripciones del tipo de cama en cada habitación.
Las respuestas de compra pueden devolver la matriz bed_groupscon un único valor o 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: el indicador de no reembolsable tiene que ser claramente visible.
Non-refundable Las disponibilidades se indican mediante refundable=falseen la respuesta de disponibilidad 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: visualización de instrucciones para realizar entradas estándar y 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: 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 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: la política de cancelación y la etiqueta de no reembolsable se muestran claramente.
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_rangesque 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 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 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: si procede, deben reiterarse las edades de los menores.
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: Somos MdR o Cobro del alojamiento: Indica cuándo se cobrará al viajero final.
Si somos el 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: Directiva de Servicios de Pago 2 (PSD2).
El cumplimiento de la PSD2 es necesario si pretendes realizar transacciones con viajeros en el Espacio Económico Europeo (EEE).
Más información sobre la PSD2.
Somos MdR o Recoge la Propiedad.
Si somos el MdR, o Property Collect se utiliza con viajeros europeos, la ruta de reserva debe incluir la adopción de las API de Rapid para la autenticación two-factor.
Afiliado MdR - General.
Debes seguir los requisitos de Autenticación Fuerte de Clientes (SCA) de la normativa PSD2 cuando las transacciones con viajeros estén dentro del ámbito de aplicación 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.
Si nos pagas con tu propia tarjeta, emitida en un país del EEE, debes cumplir los requisitos de la normativa PSD2. Para mitigar la necesidad de la 2FA de la PSD2, podrías utilizar una tarjeta que cumpla la normativa para pagos B2B y esté exenta de la 2FA ( autenticacióntwo-factor ).
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: Somos el MdR: Lugar de procesamiento del pago mostrado en las páginas de pago
Cuando seamos 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:
