Corporate partners

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Connect to Cursor

  Install MCP server on Cursor
• Connect to VS Code

  Install MCP server on VS Code

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.

Partner type		Payment methods
	Pay at 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 /accommodations/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.

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

a) Paying at the property with authorisation form

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": "2025-10-18", // This is the booking date. Is always 0 for pay_at_the_property timing (as the payment will be made at checkin date)
              "price": {
                "accommodation_currency": 0.00,
                "booker_currency": 0.00
              }
            },
            {
              "at": "2025-12-22",// This is the checkin date for the booking.
              "price": {
                "accommodation_currency": 205.78, // The amount that the property must charge to your provided VCC at checkin date. 
                "booker_currency": 0.00
              }
            }
          ],
          "methods": {
            "cards": [1, 2, 3] // The IDs of payment cards that can be used to pay for your booking. You must be able to generate/obtain a VCC for one of these cards. 
          }
        }
      }
    }
  }
}

b) Paying online with VCC

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

The flow

• You pay 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

a) Paying at the property with authorisation form

• 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": "2025-10-18", // This is the booking date. Is always 0 for pay_at_the_property timing (as the payment will be made at checkin date)
            "price": {
              "accommodation_currency": 0.00,
              "booker_currency": 0.00
            }
          },
          {
            "at": "2025-12-22", // This is the checkin date for the booking.
            "price": {
              "accommodation_currency": 205.78, // The amount that the property must charge to your provided VCC at checkin date. 
              "booker_currency": 0.00
            }
          }
        ],
        "methods": {
          "cards": [1, 2, 3] // The IDs of payment cards that can be used to pay for your booking. You must be able to generate/obtain a VCC for one of these cards. 
        }
      }
    }
  }
}
}

b) 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 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": "2025-10-18", // This is the booking date.
              "price": {
                "accommodation_currency": 0.00,
                "booker_currency": 205.78 // The amount that the property must charge to the AirPlus VCC at booking date.  This is the total price of the booking excluding extra charges (if any).
              }
            },
            {
              "at": "2025-12-22",
              "price": {
                "accommodation_currency": 0.00,
                "booker_currency": 0.00 // The amount that the property must charge at checkin, if any extra charges apply.
              }
            }
          ],
          "methods": {
            "airplus": true
          }
        }
      }
    }
  }
}

Using card payments with MOTO

Mail Order / Telephone Order (MOTO) is a card payment flow available to eligible corporate partners. It allows partners to create accommodation bookings made offline (for example, by phone or email) and classify them as MOTO transactions using the Demand API.

• Ignore the cvc_required value returned by accommodation payment endpoints when processing MOTO transactions.
• payment.card.cvc is not required for MOTO transactions when the selected product supports an online payment timing.

Pre-requisites

How the flow works

1. The traveller makes a booking request offline, such as by phone or email.
2. You collect the traveller’s card details through your offline flow.
3. You create the order using the Demand API and flag the payment as a MOTO transaction.
4. Booking.com processes the payment and pays the property.

Create the order request

→ Include the following fields in the payment object of your orders/create request:

{
  "payment": {
    "method": "card",
    "timing": "pay_online_now",
    "card": {
      "authentication": {
        "sca_exemption": "moto"
      },
      "cardholder": "Test Name",
      "expiry_date": "2030-10",
      "number": "1234123412341234"
    }
  }
}

Field requirements:

• payment.method - Must be "card".

• payment.timing - Must be "pay_online_now".

• payment.card.authentication.sca_exemption - Must be set to "moto"(lowercase) to classify the transaction as a MOTO payment.

• payment.card.cardholder, payment.card.expiry_date, and payment.card.number - Must contain valid card details.

  For accommodation MOTO payments:

  • Do not include payment.card.authentication.riskified or payment.card.authentication.3d_secure.
  • payment.card.cvc is not required, even if cvc_required=true is returned by accommodation payment endpoints.

Optional fields:

• payment.business_information - Optional. Include this object only if you need billing details or an authorisation form for the booking.
• payment.include_receipt - Set to true to include a payment receipt URL in the response when available.