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: explica claramente 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

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 contrata 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
• Mantén la continuidad del tratamiento para quienes viajan mucho por 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 compartir 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 supplier_transparency esté rellenado

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 para empresas
• Tarjetas de crédito virtuales (VCC)

Sin embargo, en algunos edificios no hay normas 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:

• Matriz de pagos:
  • typeidentifica una tarjeta de crédito virtual cuando se usa virtual_card
• additional_handling El objeto (dentro de un asiento de pago) ofrece instrucciones detalladas sobre cómo gestionar el 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

El objeto additional_handling es opcional, pero te lo recomendamos.

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 adicionales clave de gestión