Compartir el contexto de la reserva con los alojamientos

Ofrecer una experiencia fluida a nuestros socios corporativos y clientes

Información general

Rapid API ofrece opciones para que los alojamientos puedan atender mejor a los viajeros, compartiendo información adicional sobre las reservas de alojamiento. Son especialmente útiles, entre otros, para quienes viajan por negocios.

Estas opciones ayudan a los inmuebles:

• Reconoce a tu pareja
• Entender cuándo se usan las tarjetas de crédito virtuales y cómo hay que gestionarlas

Las características principales son:

• Identificación de socios y clientes: comparte información con los alojamientos sobre la fuente de la reserva (e.g., TMC y clientes corporativos).
• Instrucciones sobre las tarjetas de crédito virtuales: da indicaciones claras sobre cómo se debe usar una tarjeta de crédito virtual para una reserva con pago en el alojamiento.

Son especialmente útiles cuando se usan junto con:

• Propósito del viaje
• Hotel puntos de fidelidad
• Facturación

>> Descubre más sobre la API de Booking aquí.

Identificación de socios y clientes

Objetivo

La identificación del socio y del cliente te permite incluir información en la solicitud de reserva para que el alojamiento pueda ver:

• ¿Qué socio se encargó de la reserva (por ejemplo, una agencia de viajes concreta)? y/o
• ¿Qué empresa es la que tiene contratado al viajero?

En este contexto, los alojamientos tienen una mayor visibilidad sobre el origen de una reserva, lo que les permite: informarse sobre:

• Identifica el socio de Rapid a través del cual ha reservado el viajero
• Identifica a los clientes corporativos habituales o de alto valor
• Ofrecer una experiencia de viaje más personalizada
• Mantener la continuidad del tratamiento para quienes viajan con frecuencia por motivos de trabajo

Parámetros de la API

Puedes enviar esta información utilizando los siguientes campos de la solicitud de reserva:

• supplier_transparency (objeto)
• consent_to_share (booleano; obligatorio si quieres que se compartan los datos con los proveedores)

Puedes indicar el nombre del socio o el del cliente, o ambos.

Reglas clave:

• consent_to_share Es obligatorio que Rapid API pase los datos a los proveedores
• Si consent_to_share no es true, Rapid API no compartirá la información del socio o cliente, aunque se haya rellenado supplier_transparency.

Ejemplo de identificación de socios y clientes

{
  ...
  "supplier_transparency": {
    "point_of_sale_display_to_share": "PLS Partner Name",
    "company_name_to_share": "Corporate Client Name",
    "consent_to_share": true
  }
}

Detalles del campo

Instrucciones para la tarjeta de crédito virtual

Context

Los programas corporativos suelen pagar los viajes de negocios mediante una combinación de:

• Tarjetas de crédito personales para viajeros
• Tarjetas de pago corporativas
• Tarjetas de crédito virtuales (VCC)

Sin embargo, hay algunos edificios que no cuentan con directrices claras sobre:

• Cómo reconocer y gestionar una tarjeta de crédito virtual
• ¿Qué cargos se pueden realizar con una tarjeta de crédito virtual?
• Cuándo se puede recargar la tarjeta (periodo de validez)

Esto puede generar confusión a la hora de hacer el check-in o el check-out y provocar experiencias negativas para los viajeros de negocios.

Objetivo

Las instrucciones sobre tarjetas de crédito virtuales ofrecen a los inmuebles una guía estructurada sobre:

• Si se está utilizando una tarjeta de crédito virtual para una reserva con pago en el alojamiento
• ¿Qué gastos están cubiertos (alojamiento, impuestos, gastos adicionales específicos, etc.)?
• Límites de gasto y fechas de validez
• Cómo ponerte en contacto con la entidad emisora de la tarjeta si surge algún problema

Parámetros de la API

Estas instrucciones se añaden a la solicitud de reserva mediante un array de pagos en el que « type » identifica una tarjeta de crédito virtual cuando se utiliza « virtual_card ».

El objeto « additional_handling » (dentro de un asiento de pago) proporciona instrucciones detalladas para la gestión del pago, como por ejemplo:

• authorized_expenses
• specified_incidental_expenses
• total_charges_allowed
• is_cvc_required
• authorizing_company
• card_contact
• payment_allowable_period_start
• payment_allowable_period_end
• max_payment_attempt_count

El objeto additional_handling es opcional, pero se recomienda utilizarlo.

Ejemplo de tarjeta de crédito virtual con gastos de gestión adicionales

{
  ...
  "payments": [
    {
      "type": "virtual_card",
      "number": "4111111111111111",
      "security_code": "123",
      "expiration_month": "08",
      "expiration_year": "2028",
      "billing_contact": {
        "given_name": "John",
        "family_name": "Smith",
        "address": {
          "line_1": "555 1st St",
          "line_2": "10th Floor",
          "line_3": "Unit 12",
          "city": "Seattle",
          "state_province_code": "WA",
          "postal_code": "98121",
          "country_code": "US"
        }
      },
      "additional_handling": {
        "authorized_expenses": "total_plus_incidentals",
        "specified_incidental_expenses": [
          "breakfast",
          "internet"
        ],
        "total_charges_allowed": {
          "value": "875.00",
          "currency": "USD"
        },
        "is_cvc_required": true,
        "authorizing_company": "Conferma",
        "card_contact": {
          "email": "chucktesta@mydomain.com",
          "phone": {
            "country_code": "1",
            "area_code": "555",
            "number": "5555555"
          }
        },
        "payment_allowable_period_start": "2027-01-01",
        "payment_allowable_period_end": "2028-08-01"
      }
    }
  ]
}

Campos clave adicionales de gestión