Compartilhamento do contexto da reserva com as propriedades

Proporcionar uma experiência perfeita para parceiros corporativos e clientes.

Visão geral

Rapid API oferece opções para ajudar as propriedades a melhor atender os viajantes, compartilhando informações adicionais sobre as reservas de hospedagem. São particularmente úteis para viajantes a negócios, mas não se limitam a eles.

Essas opções ajudam as propriedades:

• Reconheça o parceiro
• Entenda quando os cartões de crédito virtuais são usados ​​e como devem ser gerenciados.

As principais características são:

• Identificação de parceiros e clientes: compartilhe informações com as propriedades sobre a origem da reserva (e.g. TMC e clientes corporativos).
• Instruções para cartão de crédito virtual: compartilhe orientações claras sobre como usar um cartão de crédito virtual para uma reserva propriedade Collect.

Essas opções são particularmente úteis quando usadas em combinação com:

• Motivo da viagem
• Hotel pontos de fidelidade
• Faturamento:

Identificação de parceiros e clientes

Finalidade

A identificação de parceiros e clientes permite incluir informações na solicitação de reserva para que o propriedade possa ver:

• Qual parceiro cuidou da reserva (por exemplo, uma agência de viagens específica) e/ou
• Qual cliente corporativo emprega o viajante?

Este contexto proporciona às propriedades maior visibilidade sobre a origem de uma reserva, permitindo-lhes:

• Reconhecer o parceiro Rapid através do qual o viajante fez a reserva
• Reconheça os hóspedes corporativos frequentes ou de alto valor.
• Proporcionar uma experiência de viagem mais personalizada.
• Manter a continuidade do tratamento para viajantes corporativos frequentes.

Parâmetros da API

Você pode enviar essas informações usando os seguintes campos na solicitação de reserva:

• supplier_transparency (objeto)
• consent_to_share (Booleano, obrigatório se desejar que os dados sejam compartilhados com os fornecedores)

Você pode informar o nome do parceiro ou do cliente, ou ambos.

Regras principais:

• consent_to_share É obrigatório que Rapid API passe os dados para os fornecedores.
• Se consent_to_share não for true, Rapid API não compartilhará as informações do parceiro/cliente, mesmo que supplier_transparency esteja preenchido.

Exemplo de identificação de parceiros e clientes

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

Detalhes do campo

Instruções para cartão de crédito virtual

Contexto

Os programas corporativos geralmente financiam viagens a negócios usando uma combinação de:

• Cartões de crédito pessoais para viajantes
• Cartões de pagamento corporativos
• Cartões de crédito virtuais (VCCs)

No entanto, algumas propriedades carecem de diretrizes claras sobre:

• Como reconhecer e processar um cartão de crédito virtual
• Quais cobranças são autorizadas em um cartão de crédito virtual?
• Quando o cartão pode ser cobrado (período de validade)

Isso pode causar bagunça no momento do check-in e/ou check-out e experiências negativas para viajantes a negócios.

Finalidade

As instruções para cartões de crédito virtuais fornecem às propriedades orientações estruturadas sobre:

• Se um cartão de crédito virtual está sendo usado para uma reserva propriedade collect
• Quais despesas estão incluídas (quarto, impostos, despesas extras específicas, etc.)?
• Quaisquer limites de cobrança e datas de validade
• Como entrar em contato com o responsável pelo cartão se algo der errado

Parâmetros da API

Essas instruções são adicionadas à solicitação de reserva usando:

• Matriz de pagamentos:
  • typeIdentifica um cartão de crédito virtual quando virtual_card é usado
• additional_handling O objeto (dentro de uma entrada de pagamento) fornece instruções detalhadas para o processamento do pagamento, tais como:
  • authorized_expenses
  • specified_incidental_expenses
  • total_charges_allowed
  • is_cvc_required
  • authorizing_company
  • card_contact
  • payment_allowable_period_start
  • payment_allowable_period_end

O objeto additional_handling é opcional, mas recomendado.

Exemplo de cartão de crédito virtual com processamento adicional.

{
  ...
  "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"
      }
    }
  ]
}

Principais campos de manipulação adicionais