API Rapid Car: Requisitos de lançamento

Requisitos para integração da API Rapid Car.

Para garantir a integridade da sua implementação de business-to-business (B2B) ou business-to-consumer (B2C), a API Rapid Car exige que algumas páginas incluam informações específicas. Apenas as páginas com requisitos específicos estão listadas aqui.

Página de busca

Defina parâmetros de pesquisa precisos.

SP1: Defina parâmetros de pesquisa precisos

Adicione campos que registrem as localizações de pick-up e drop-off, bem como a data e hora do aluguel, e então envie a solicitação de disponibilidade. Seus parâmetros permitem a busca por área (raio e coordenadas), aeroporto (com o ID da região do aeroporto) ou uma combinação dos dois.

Campos de pesquisa, incluindo locais de retirada e devolução, datas e horários de aluguel

Exemplos de pesquisa

Por raio e coordenadas

/v2/cars/availability?pickup_time=2026-02-12T10:00:00&dropoff_time=2026-02-14T18:00:00&pickup_area=10,33.9422,-118.4036&dropoff_area=10,33.9422,-118.4036&driver_age=30&country_code=US&currency=USD&language=en-US&limit=200&sort=total_price&sales_channel=website&sales_environment=car_only&filter=refundable&filter=vendor_collect

Por ID da região aeroportuária

/v2/cars/availability?pickup_time=2026-02-12T10:00:00&dropoff_time=2026-02-14T18:00:00&pickup_airport=5783884&dropoff_airport=5783884&driver_age=30&country_code=US&currency=USD&language=en-US&limit=200&sort=recommended&sales_channel=website&sales_environment=car_only&filter=refundable&filter=expedia_collect

Com ambos os parâmetros

/v2/cars/availability?pickup_time=2026-02-12T10:00:00&dropoff_time=2026-02-14T18:00:00&pickup_area=10,33.9422,-118.4036&dropoff_airport=5456204&driver_age=30&country_code=US&currency=USD&language=en-US&limit=200&sort=total_price&sales_channel=website&sales_environment=car_only&filter=refundable&filter=vendor_collect

SP2: Registrar a idade do motorista

Condutores com menos de 30 anos ou mais de 70 anos podem estar sujeitos a taxas adicionais obrigatórias. Para que nossa API possa calcular corretamente o custo da reserva, a idade do motorista deve ser informada no momento da busca. Defina um valor padrão de 40 para os drivers dentro desse intervalo. Esse valor é refletido no parâmetrodriver_age.

Uma caixa de seleção com a descrição "Motoristas com menos de 30 ou mais de 70 anos podem ser obrigados a pagar uma taxa adicional"

Página do anúncio

Resultados de pesquisa robustos

A página de listagem é uma coleção de opções, também conhecida como página de resultados de pesquisa. Deverá exibir os seguintes elementos.

Resultados da pesquisa mostrando o tipo, o provedor e o preço do carro, juntamente com uma imagem de um veículo comparável.

LP1: Forneça informações de aluguel precisas.

A página de listagem, também conhecida como página de resultados de pesquisa, deve exibir todas as informações de aluguel de materiais retornadas pela API, tais como:

Classe, marca e modelo de cada carro
Capacidade máxima
Tipo de transmissão
Fonte de combustível: gasolina, híbrido, elétrico, etc. (nos mercados da Califórnia)
Quilometragem permitida
Pick-up ponto e drop-off ponto
Nome ou logotipo da empresa de aluguel

Muitos atributos do aluguel de carros são fornecidos como parte do parâmetro acriss_code, que pode ser decodificado usando os valores na tabela ACRISS. Por exemplo, o valor de JFBC representa um SUV de elite intermediário (categoria J), tipo F, com transmissão automática 4-wheel-drive (transmissão B) e energia elétrica (combustível/ar condicionado). C).

"description": "Skoda Enyaq Electric car or similar",
        "number_of_passengers": 5,
        "number_of_doors": {
            "min": 5,
            "max": 5
        },
        "luggage_count": {
            "small": 3,
            "large": 3
        },
        "acriss_code": "JFBC",

LP2: Preço total e data de vencimento do pagamento

Inclua o preço total para o período de aluguel selecionado e se o aluguel deve ser pago antecipadamente (pagamento imediato ou com cobrança da Expedia) ou no balcão (pagamento posterior ou com cobrança do provedor).

Nota: Reservas com um local diferente de pick-up e drop-off (também conhecidas como aluguéis one-way) geralmente incorrem em taxas de transferência adicionais.

Seção da página que exibe a tarifa diária, o preço total e a tarifa com desconto.

Exemplo de pagamento agora / Expedia Collect

[
 {
   ...
   "rate": {
     "merchant_of_record": "expedia",
     "sale_scenario": {
       "package": false,
       "member": false,
       "mobile_promotion": false
     },
     "pricing": {
       "daily_rate_strikethrough": {...},
       "daily_rate": {...},
       "totals": {
         "inclusive_strikethrough": {...},
         "inclusive": {...},
         "exclusive": {...},
         "fees": {...}
       }
     }
   },
   ...
 }
]

Exemplo de pagamento posterior/cobrança pelo provedor

[
 {
   ...
   "rate": {
     "merchant_of_record": "vendor",
     "sale_scenario": {
       "package": false,
       "member": false,
       "mobile_promotion": false
     },
     "pricing": {
       "daily_rate": {...},
       "totals": {
         "inclusive": {...},
         "exclusive": {...},
         "fees": {...}
       }
     }
   },
   ...
 }
]

LP3: Non-refundable bandeira

Para tarifas que sejam non-refundable, exiba isso claramente na descrição do produto.

Nota: Se nenhum valor cancel_penaltiesestiver presente na resposta, isso indica cancelamento livre.

[ 
  ...
  {
    "cancel_penalties": [
      {
        "start": "2026-02-11T10:00:00",
        "end": "2026-02-12T10:00:00",
        "currency": "USD",
        "amount": "50.00"
      },
      {
        "start": "2026-02-12T10:00:00",
        "currency": "USD",
        "amount": "50.00"
      }
    ],
  }
  ...
]

LP4: Informações padrão sobre seguros

Inclua informações sobre a Proteção Básica contra Danos por Colisão, juntamente com quaisquer opções de seguro adicionais.

{
  ...
  "policies": [
    ...
    {
      "name": "Basic Collision Damage Protection",
      "descriptions": [],
      "policy_statements": [
        {
          "statement": "Basic Collision Damage Protection",
          "statement_condition": "included"
        }
      ],
      "policy_type": "PRODUCT_USE_POLICY"
    },
    ...
  ],
  ...
}

Página de descrição do produto

Informações sobre o veículo e o provedor

PDP1: Forneça informações de aluguel precisas

A página de detalhes do produto, com as descrições dos produtos, deve exibir todas as informações de aluguel de materiais retornadas pela API, tais como:

Classe, marca e modelo de cada carro
Capacidade máxima
Número de portas
Capacidade de mala
Tipo de transmissão
Fonte de combustível: gasolina, híbrido, elétrico, etc. (nos mercados da Califórnia)
Quilometragem permitida
Pick-up ponto e drop-off ponto
Nome ou logotipo da empresa de aluguel de carros

Descrição do veículo incluindo todos os seguintes requisitos

"description": "Skoda Enyaq Electric car or similar",
        "number_of_passengers": 5,
        "number_of_doors": {
            "min": 5,
            "max": 5
        },
        "luggage_count": {
            "small": 3,
            "large": 3
        },
        "acriss_code": "JFBC",

PDP2: Mostrar políticas de aluguel completas

As políticas de aluguel, incluindo todas as regras e restrições, devem ser totalmente divulgadas antes que o viajante finalize o aluguel do carro. Isso inclui quaisquer depósitos de segurança reembolsáveis que sejam devidos no momento do pick-up.

A janela modal exibe duas seções de política expansíveis e um link para visualizar todas as regras e restrições.

Exemplo de política de aluguel

"policies": [
        {
            "name": "Fuel: full to full",
            "descriptions": [],
            "policy_statements": [
                {
                    "statement": "Fuel: full to full",
                    "statement_condition": "Vehicle to be returned with the same amount of fuel as start of the trip to avoid refuelling charges."
                }
            ],
            "policy_type": "PRODUCT_USE_POLICY"
        },
        {
            "name": "Unlimited mileage",
            "descriptions": [],
            "policy_statements": [
                {
                    "statement": "Unlimited mileage",
                    "statement_condition": "Drive unlimited distance with this car at no extra cost."
                }
            ],
            "policy_type": "PRODUCT_USE_POLICY"
        },
        {
            "name": "Cancellation available",
            "descriptions": [],
            "policy_statements": [
                {
                    "statement": "Cancellation available",
                    "statement_condition": "Before Fri, Sep 19, 10:30am"
                }
            ],
            "policy_type": "CANCELLATION_POLICY"
        },
        {
            "name": "",
            "descriptions": [],
            "policy_statements": [],
            "policy_type": "PRODUCT_USE_POLICY"
        },
        {
            "name": "Online check-in",
            "descriptions": [],
            "policy_statements": [
                {
                    "statement": "",
                    "statement_condition": "Check in online on the Sixt website by uploading required documents, like driver’s license, up to the time of pick-up."
                }
            ],
            "policy_type": "CHECKIN_POLICY"
        },
        {
            "name": "Pay now and save",
            "descriptions": [],
            "policy_statements": [],
            "policy_type": "PAYMENT_POLICY"
        }
    ],

Exemplo de regras e restrições

{ 
  "rules_and_restrictions": [ 
    { 
      "title": "Rental policies overview", 
      "statements": "<p>The following rules and restrictions are provided by the car rental company.</p>" 
    },

Requisitos adicionais country-specific

Nas regiões da UE e do Reino Unido, você deve exibir um aviso informando que o direito de retratação não se aplica.

Modelo de política de aluguel com informações circuladas que explicam as diferenças na legislação de defesa do consumidor do Reino Unido.

PDP3: Exibir a política de cancelamento

Caso seja necessário cancelar uma reserva, o viajante precisará compreender os termos da política de cancelamento do provedor.

Cancelamento grátis

Alguns fornecedores oferecem cancelamento gratuito da reserva, independentemente do momento em que ela seja feita.

Caixa de notificação com a mensagem "Garanta este preço hoje, cancele gratuitamente a qualquer momento."

{...
        {
            "name": "Free cancellation",
            "descriptions": [],
            "policy_statements": [],
            "policy_type": "CANCELLATION_POLICY"
        },
        {
            "name": "Free cancellation",
            "descriptions": [],
            "policy_statements": [
                {
                    "statement": "Lock in this price today, cancel free of charge anytime. Reserve now and pay at pick-up.",
                    "statement_condition": ""
                }
            ],
            "policy_type": "PRODUCT_USE_POLICY"
        },
}

Cancelamento gratuito até

Dependendo da situação, alguns fornecedores podem permitir o cancelamento gratuito de uma reserva até um determinado ponto, como 24 horas antes da data de pick-up.

Cancelar até a data e hora de vencimento do extrato, incluindo informações sobre data e hora.

{        
        {
            "name": "Free cancellation",
            "descriptions": [],
            "policy_statements": [
                {
                    "statement": "Free cancellation",
                    "statement_condition": "Before Wed, Oct 1, 10:30am"
                }
            ],
            "policy_type": "CANCELLATION_POLICY"
        },
        {
            "name": "Free cancellation",
            "descriptions": [
                "Free cancellation up to 24 hours before pick-up",
                "Cancellations made after that or no-shows are subject to a fee of $50 or total reservation amount, whichever is lesser which will be charged on the card details shared by you.",
                "Get 100% refund of Collision Damage Plan cost if canceled before the scheduled pick-up time. This insurance will be canceled automatically with your rental car cancellation.",
                "Cancellations made after that or no-shows are subject to a fee of $50 or total reservation amount, whichever is lesser which will be charged on the card details shared by you.",
                "Get 100% refund of Collision Damage Plan cost if canceled before the scheduled pick-up time. This insurance will be canceled automatically with your rental car cancellation."
            ],
            "policy_statements": [
                {
                    "statement": "Lock in this price today, cancel free of charge up to 24 hours before pick-up. Cancellations within 24 hours of pick-up or no shows will not be eligible for a refund.",
                    "statement_condition": ""
                }
            ],
            "policy_type": "PRODUCT_USE_POLICY"
        },
    }
}

PDP4: Detalhes e custos dos opcionais

Os viajantes podem adicionar extras opcionais, como cadeirinha de carro ou passe de pedágio. Esses extras são sempre pagos ao provedor, e não cobrados no momento da reserva. Os itens opcionais estão sujeitos à disponibilidade e não são garantidos.

"optional_extras": [
        {
            "id": "TollPaymentTagPass",
            "name": "TOL - Toll pass/Express lane",
            "rate_price": {
                "rate_period": "daily",
                "rate": {
                    "billable_currency": {
                        "value": "15.71",
                        "currency": "USD"
                    },
                    "request_currency": {
                        "value": "15.71",
                        "currency": "USD"
                    }
                }
            }
        },
        {
            "id": "InfantChildSeat",
            "name": "CSI - Infant seat",
            "rate_price": {
                "rate_period": "daily",
                "rate": {
                    "billable_currency": {
                        "value": "17.16",
                        "currency": "USD"
                    },
                    "request_currency": {
                        "value": "17.16",
                        "currency": "USD"
                    }
                }
            }
        }
    ]

Página de reservas

Detalhes do checkout

Resumo dos detalhes da reserva (BP1)

O resumo deve sempre incluir:

* Datas do aluguel do carro * Pick-up local, horário e endereço * Drop-off local, horário e endereço * Categoria do carro * Nome da locadora de veículos * Política de combustível

Página de reservas mostrando todos os elementos listados acima.

BP2: Exibir o preço do aluguel

A forma como o preço é exibido depende do tipo de tarifa reservada e do canal de reserva utilizado. Sua equipe de lançamento indicará quais requisitos se aplicam a você.

Tarifas somente de quarto

As tarifas individuais podem ser vendidas separadamente ou como parte de um pacote.

Na página de reservas, você deve exibir o preço total para o período de aluguel selecionado e um detalhamento de todos os impostos e taxas aplicáveis (incluindo as taxas one-way). Indique também se o aluguel deve ser pago antecipadamente (pagamento imediato ou com cobrança pela Expedia) ou no balcão (pagamento posterior ou com cobrança pelo provedor). Os itens opcionais add-ons são sempre pagos no caixa.