This tutorial guides you through designing and implementing an onboarding flow for Payments by Booking (PBB) in your platform.
The tutorial is based on mockups from Booking.com's Extranet, providing you with real-world examples of how the onboarding flow works. You can use these as inspiration to create a similar experience in your own platform.
Before you begin, you should:
- Have a basic understanding of the Payments by Booking Onboarding API
- Be connected with the Payments by Booking.com onboarding connection type (see Connections API Overview)
- Have access to property and legal entity information for testing
The bank transfer onboarding flow guides properties through selecting bank transfers as their payout method and configuring payout timing preferences.
The first step presents users with available payout method options. This screen shows the initial choice screen where properties can select their preferred payout method.
Properties can customize when and how frequently they want to receive bank transfer payouts (in this mockup, it's weekly or monthly, but the Onboarding API also supports the "daily" option).
This screen explains who facilitates the payment (Booking.com or the property) based on the policy of the room that the guest books.
Before confirming the configuration, properties are explained how they can check the payment status of the new bookings.
At this step, the flow differs depending on whether properties onboard via Extranet or via the Onboarding API:
Via Extranet: Properties can provide their bank account details directly in the onboarding flow before submitting the request. Once submitted, the configuration is complete.
Via the Onboarding API: The API currently does not support bank details configuration. Properties submit the onboarding request with their payout preferences (payout method, frequency, netting, and collection strategy), but they need to log in to Extranet separately to add their bank account details to complete the activation process. For more information, see the Note for bank transfers section.
Support for bank details configuration via the API is planned for a future release.
Once the payments activation is complete, properties receive a confirmation.
The virtual credit card onboarding flow guides properties through selecting VCCs as their payout method.
Properties start by selecting their preferred payout method from the available options.
This screen explains who facilitates the payment (Booking.com or the property) based on the policy of the room that the guest books.
Before confirming the configuration, properties are explained how they can check the payment status of the new bookings.
Properties review and confirm the configuration details before submitting the request.
Once the payments activation is complete, properties receive a confirmation.