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:

• Reconhecer os relacionamentos corporativos e de gestão de agências de viagens (TMC).
• 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.

{
...
"pagamentos": [
{
"tipo": "virtual_card",
"número": "4111111111111111",
"security_code": "123",
"expiration_month": "08",
"expiration_year": "2025",
"billing_contact": {
"given_name": "John",
"family_name": "Smith",
"endereço": {
"linha_1": "555 1st St",
"linha_2": "10º andar",
"linha_3": "Unidade 12",
"cidade": "Seattle",
"state_province_code": "WA",
"postal_code": "98121",
"country_code": "US"
}
},
"additional_handling": {
"authorized_expenses": "total_plus_incidentals",
"specified_incidental_expenses": [
"café da manhã",
"internet"
],
"total_charges_allowed": {
"valor": "875.00",
"moeda": "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": "2024-01-01",
"payment_allowable_period_end": "2025-08-01"
}
}
]
}

### Principais campos de manipulação adicionais

| Campo | Detalhes |
| ----- | ----- |
| `authorized_expenses` | Regra de alto nível que indica para que o cartão de crédito virtual pode ser usado, e.g.<br><br>• `room_only`<br>• `room_and_tax`<br>• `total_plus_incidentals` |
| `specified_incidental_expenses` | Uma lista de itens extras específicos permitidos (por exemplo, café da manhã ou internet). |
| `total_charges_allowed` | Um limite máximo explícito para as cobranças.<br><br> • valor: quantidade máxima<br>• moeda: código da moeda (e.g. USD) |
| `is_cvc_required` | Indica se o CVC deve estar presente para que propriedade possa cobrar o cartão. |
| `authorizing_company` | Nome da empresa que emitiu ou administra o cartão de crédito virtual (por exemplo, um provedor de cartão de crédito virtual ou uma entidade corporativa). |
| `card_contact` | Informações de contato caso o usuário propriedade apresente algum problema ao cobrar o cartão:<br><br>• `email`<br>•`phone.country_code, phone.area_code, phone.number` |
| `payment_allowable_period_start / payment_allowable_period_end` | O período durante o qual o cartão é válido para cobranças (geralmente coincide com as datas da estadia, mais uma pequena margem de segurança). |