PAYMENTS
/
Voxel integration
Last updated

Integrating Voxel for automated invoice collection

Use this guide if you have an active Voxel account and want to enable automated invoice collection for accommodation bookings made via Demand API.

Overview

Voxel is a third-party service provider that specialises in automating invoice collection on behalf of its clients. To support efficient invoicing for accommodation-related expenses, Booking.com has integrated its Demand API with Voxel’s invoicing platform.

This integration allows invoices to be automatically generated and collected for accommodation bookings made via Demand API, simplifying the process for partners.

The integration supports both Demand API v2 and v3, with no breaking changes introduced. All existing functionality remains fully compatible for partners.

Key features

✅ Seamless invoice collection - Corporate and non-corporate partners who book accommodations via Demand API can have their invoices automatically collected by Voxel.

✅ Backward compatibility - The integration is fully compatible with existing functionality, meaning no disruptions are expected for current partners.

Initial setup requirements

To get started with the Voxel integration, make sure the following conditions are in place:

☑A Voxel contract and an active Voxel account (as Voxel is an external service provider).
☑Notify your Booking.com Account Manager.
☑Correct business information input during the order creation process.

Activation requirements

Before you can go live with the Voxel integration, the following conditions must be met:

☑Payment methodThe use of either Online Payments or Payment Instructions is mandatory. Bookings using pay_at_the_property are not supported by the Voxel integration.
☑Signed data-sharing agreementA signed addendum between you and Booking.com is required to authorise the transmission of invoice-related data to Voxel. Your Booking.com Account Manager can support you with this process.
☑Agreed go-live dateA confirmed go-live date must be agreed between your organisation, Booking.com, and Voxel before activation of the integration.

Integration steps

Step 1 - Configure business information

To initiate the Voxel integration:

  • Within the orders/create request, include the following fields in the business_information field:
    • company name
    • country (lowercase)
    • VAT number
    • billing email.

Including this information ensures that all required details, such as the Tax ID, are provided to Voxel for invoice generation.

Example:

"business_information": {
  "company": "Company Name",
  "billing": {
    "address": {
      "country": "nl"
    },
    "email": "your_company_email@example.com",
    "vat": "VALID VAT NUMBER"
  }
}
Important: Validate the VAT Number

One of the most important aspects of using the Voxel integration is the validation of the VAT number.

  • Partners are responsible for providing a valid VAT number. Booking.com does not perform VAT validation.

  • If the VAT number is invalid, invoice creation will fail. To avoid issues with invoicing, partners should carefully check the VAT number during the setup process.

We recommend using the Voxel VAT validation tool to verify the number.

Step 2 - Submit reservations

Once the business information has been submitted in your orders/create request, Demand API will automatically push the reservation details to Voxel’s API.

You will receive the order confirmation as usual.

Refer to the orders/create guidelines for instructions on creating orders and best practices.

Troubleshooting

If you encounter issues with the Voxel integration, consider the following troubleshooting steps:

Checklist
✓ Validate VAT Number
  • Ensure that the VAT number entered is correct.
  • Invalid VAT numbers will cause the integration to fail, preventing reservation details from being pushed to Voxel.
✓ Confirm business information
  • Double-check that the business information provided during the reservation process is complete and accurate.
  • Missing or incorrect details could cause invoicing errors.
✓ Review API responses

Conclusion

The Voxel integration offers a streamlined process for all types of partners booking accommodations via Booking.com, enabling automatic invoice collection.

Ensure that your business details are accurate to make the most of the automated invoicing process.

Curious to know more?
Previous page
Next page