Corporate partners

Learn how to define the required payment data when creating an order, allowing business travellers to pay either online or at the property using an authorisation form.

Is this for you?

This use case is for Corporate partners who make bookings on behalf of their employees (business travellers) and make a booking for a business trip. Payments are either offline or online via different methods.

Business traveller		Payment methods
	Pay at the property + authorisation form1	✓ Virtual credit card (VCC) + payment instructions ✓ AirPlus VCC + payment instructions
	Online payments	✓ AirPlus VCC integration ✓ Virtual credit card (VCC) ✓ Credit card + MOTO.

The following sections show, for each payment method and scenario:

• The data that the /orders/preview response must contain.
• How to define the payment object in your /orders/create request to use your payment option.

Follow these instructions and recommendations to create the payment data needed for your request.

1. Check payment timing and available methods

→ Call /accommodation/details before creating your order, so you can check the available payment methods for the selected accommodation.

Example to check available payment methods:

{
"accommodations": [
  10004
],
"extras": [
  "payment"
],
"languages": [
  "en-gb"
]
}

Recommendation when using VCC

Check the type of Virtual credit card that is accepted by the property, in the output field payment.methods.virtual_cards.

• Only card ID 1, 2 and 3 is supported for VCC.

• If you use a VCC that is not type 1, 2 or 3, it won't be accepted even when it is in /orders/preview response.

Make sure you can generate a VCC for one of those cards, so you can use them for your bookings to the property.

2. Create your request

The examples provided illustrate different scenarios your application could support, showing how to specify the payment structure in your /orders/create request.

Using your own VCC

Corporate partners can generate or obtain their own Virtual credit cards (VCC) and use them for offline payments together with payment instructions, for authorisation, or use them for online payments.

Pre-requisites

Paying at the property with authorisation form

The flow

1. Generate a Virtual credit card (VCC) through your Payment service provider (PSP).
2. Forward the Virtual credit card (VCC) and payment instructions via our API to Booking.com.
3. Booking.com sends an authorisation form with this information to the property, allowing them to charge the VCC when the business traveller checks in.

"accommodation": {
       ...
       "general_policies": {
           "payment": {
               ...
               "pay_at_the_property": {
                   "method_required": true,
                   "dates": [
                       {
                           "at": "2023-12-18",
                           "price": {
                               "accommodation_currency": 0.00
                               "booker_currency": 0.00
                           }
                       },
                       {
                           "at": "2024-01-10",
                           "price": {
                               "accommodation_currency": 205.78,
                               "booker_currency": 205.78
                           }
                       }
                   ],
                   "methods": {
                       ...
                       "cards": [1,2,3]
                   }
               }
           }
        },
       ...

Paying online with VCC

For online payments, Corporate partners can use Virtual credit cards generated by any VCC provider.

The flow

• You pays Booking.com with your Virtual credit card (VCC).
• Booking.com charges your VCC and pays the property.

Using AirPlus VCC

Our Demand API is integrated with AirPlus, which is a VCC external provider, so those Corporate partners who cannot or do not want to generate VCC themselves, can use AirPlus instead.

By using AirPlus as your virtual credit card provider, you can pay for business travel bookings by using a 12-digit AirPlus number instead of full details of a virtual credit card, allowing for an efficient and secure booking process.

You can use AirPlus VCC for both offline (together with payment instructions) and online payments.

Pre-requisites

Paying at the property with authorisation form

The flow

• You forward a AirPlus Virtual credit card (VCC) + details of what charges are allowed (payment instructions) and authorisation details to Booking.com via our API.

• Booking.com sends an authorisation form with AirPlus VCC details to the property, so that it can charge the VCC as authorised appropriately when the business traveller stays.

  Note

  This option is only available if you are an AirPlus customer and have a 12-digit AirPlus number. If you are using an AirPlus VCC directly (not via the integration), see cards method instead.

   "accommodation": {
       ...
       "general_policies": {
           "payment": {
               ...
               "pay_at_the_property": {
                   "method_required": true,
                   "dates": [
                       {
                           "at": "2023-12-18",
                           "price": {
                               "accommodation_currency": 0.00
                               "booker_currency": 0.00
                           }
                       },
                       {
                           "at": "2024-01-10",
                           "price": {
                               "accommodation_currency": 205.78,
                               "booker_currency": 205.78
                           }
                       }
                   ],
                   "methods": {
                       "airplus": true,
                       ...
                   }

AirPlus VCC for online payments

If you are a Corporate Partner using AirPlus VCC and want to make online payments on behalf of your business travellers, then this use case is for you.

The flow

• The traveller pays via the method offered on your platform.
• You pay for the booking via AirPlus Virtual credit card (VCC).
• Booking.com charges your Virtual credit card and pays the property.

   "accommodation": {
       ...
       "general_policies": {
           "payment": {
               ...
               "pay_online_now": {
                   "method_required": true,
                   "dates": [
                       {
                           "at": "2023-12-18",
                           "price": {
                               "accommodation_currency": 0.00
                               "booker_currency": 205.78
                           }
                       },
                       {
                           "at": "2024-01-10",
                           "price": {
                               "accommodation_currency": 0.00,
                               "booker_currency": 0.00
                           }
                       }
                   ],
                   "methods": {
                       "airplus": true,
                       ...
                   }

Using Credit card + MOTO

The Mail/telephone order (MOTO) is an Online payment method that we offer to Corporate partners so they can book prepaid rates by classifying their offline bookings as MOTO transactions in our Demand API.

Pre-requisites

The flow

• The traveller decides to order reservation by email or telephone.
• You flag the transaction as a "MOTO" via our API along with traveller`s credit card information.
• Booking.com charges the traveller credit card and pays the property.

Create your order request

→ Call /orders/create and specify the following information in the payment.card.authentication field:

• business_information: Must contain the necessary business related information for billing, and for the authorisation form that will be sent to the property. This is mandatory for this sort of payments.

• Card.authentication: Define the appropriate authentication method for the card that is being used to secure the booking.

  • In this case is Credit Card with MOTO (SCA exempted) hence:
    • You dont need to include a SCA token (3D Secure field)
    • But you need to set the payment.card.sca_excemption to "moto" instead.

• cardholder, cvc, expiry_date, number: Must contain the details of a valid payment card that can be used to secure the booking (as per the list returned in methods.cards in the /orders/preview response).

• method: Must be "card".

• timing: Must be "pay_online_now".

For example:

"payment": {
 "card": {
     "authentication": {
         "sca_exemption": "moto",
     },
     "cardholder": "xxxx",
     "cvc": 123,
     "expiry_date": "2030-10",
     "number": "1234123412341234"
 },