{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-connectivity/docs/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Tutorial: Designing the Payments by Booking onboarding flow","siteUrl":"https://developers.booking.com"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"tutorial-designing-the-payments-by-booking-onboarding-flow","__idx":0},"children":["Tutorial: Designing the Payments by Booking onboarding flow"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"introduction","__idx":1},"children":["Introduction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This tutorial guides you through designing and implementing an onboarding flow for Payments by Booking (PBB) in your platform."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"prerequisites","__idx":2},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before you begin, you should:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Have a basic understanding of the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/payments-by-booking-onboarding-api/understanding-the-pbb-onboarding-api"},"children":["Payments by Booking Onboarding API"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Be connected with the Payments by Booking.com onboarding connection type (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/connections-api/connections-overview"},"children":["Connections API Overview"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Have access to property and legal entity information for testing"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"bank-transfer-bt-onboarding-flow","__idx":3},"children":["Bank Transfer (BT) onboarding flow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The bank transfer onboarding flow guides properties through selecting bank transfers as their payout method and configuring payout timing preferences."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-1-choosing-the-payout-method","__idx":4},"children":["Step 1: Choosing the payout method"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/all-step-0.a363cc8b97d5d2ae0c2a68cf2b6a8db77e427309d9a593aac207fae6b07bea5f.ccfe5165.jpg","alt":"payout-method-selection"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-2-choosing-the-bank-transfer-payout-timing","__idx":5},"children":["Step 2: Choosing the bank transfer payout timing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/bt-step-1.fa3cbb78c2346698f54e30fb78225b1bb9d429704879fe1d0de993aba9a48782.ccfe5165.jpg","alt":"payout-timing-configuration"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-3-about-payment-facilitation","__idx":6},"children":["Step 3: About payment facilitation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This screen explains who facilitates the payment (Booking.com or the property) based on the policy of the room that the guest books."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/bt-step-2.f1f9546c95cb6ba7c633cda24f6d26eacc9a6846a28d7a866816823a1b46110b.ccfe5165.jpg","alt":"payment-facilitation"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-4-checking-reservations","__idx":7},"children":["Step 4: Checking reservations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before confirming the configuration, properties are explained how they can check the payment status of the new bookings."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/bt-step-3.dbaed8aab0ef02f992cb6186e76141ce754b6617fa9dc2eaeb9a4da2e865f6a6.ccfe5165.jpg","alt":"checking-reservations"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-5-submitting-the-onboarding-request","__idx":8},"children":["Step 5: Submitting the onboarding request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["At this step, the flow differs depending on whether properties onboard via Extranet or via the Onboarding API:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Via Extranet"]},": Properties can provide their bank account details directly in the onboarding flow before submitting the request. Once submitted, the configuration is complete."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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 ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/payments-by-booking-onboarding-api/understanding-payouts#note-for-bank-transfers"},"children":["Note for bank transfers"]}," section."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Support for bank details configuration via the API is planned for a future release."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-6-payments-activation-confirmation","__idx":9},"children":["Step 6: Payments activation confirmation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once the payments activation is complete, properties receive a confirmation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/pbb-congrats.18b293fbc0ab7e30b5347b97adf0d2bf39c54a6c14db815131c92b5069e56a19.ccfe5165.jpg","alt":"onboarding-success"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"virtual-credit-card-vcc-onboarding-flow","__idx":10},"children":["Virtual Credit Card (VCC) onboarding flow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The virtual credit card onboarding flow guides properties through selecting VCCs as their payout method."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-1-choosing-the-payout-method-1","__idx":11},"children":["Step 1: Choosing the payout method"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Properties start by selecting their preferred payout method from the available options."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/all-step-0.a363cc8b97d5d2ae0c2a68cf2b6a8db77e427309d9a593aac207fae6b07bea5f.ccfe5165.jpg","alt":"payout-method-selection"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-2-about-payment-facilitation","__idx":12},"children":["Step 2: About payment facilitation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This screen explains who facilitates the payment (Booking.com or the property) based on the policy of the room that the guest books."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/vcc-step-1.9c02ff29a61ea640260e21d64713e0a062b2f52aec567af04f67ebb210695cf3.ccfe5165.jpg","alt":"payment-facilitation"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-3-checking-reservations","__idx":13},"children":["Step 3: Checking reservations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before confirming the configuration, properties are explained how they can check the payment status of the new bookings."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/vcc-step-2.1df8ea128341f780bf526a17a1290badbd3d5754d7bf3ba0c5a96f9dcb863dda.ccfe5165.jpg","alt":"checking-reservations"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-4-confirming-the-configuration","__idx":14},"children":["Step 4: Confirming the configuration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Properties review and confirm the configuration details before submitting the request."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/vcc-step-3.10958ba312156a3de19458f70bab16abe9756ef085020e9f60cfbcbdd61bd8cc.ccfe5165.jpg","alt":"confirming-configuration"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-5-payments-activation-confirmation","__idx":15},"children":["Step 5: Payments activation confirmation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once the payments activation is complete, properties receive a confirmation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/pbb-congrats.18b293fbc0ab7e30b5347b97adf0d2bf39c54a6c14db815131c92b5069e56a19.ccfe5165.jpg","alt":"onboarding-success"},"children":[]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]}]},"headings":[{"value":"Tutorial: Designing the Payments by Booking onboarding flow","id":"tutorial-designing-the-payments-by-booking-onboarding-flow","depth":1},{"value":"Introduction","id":"introduction","depth":2},{"value":"Prerequisites","id":"prerequisites","depth":3},{"value":"Bank Transfer (BT) onboarding flow","id":"bank-transfer-bt-onboarding-flow","depth":2},{"value":"Step 1: Choosing the payout method","id":"step-1-choosing-the-payout-method","depth":3},{"value":"Step 2: Choosing the bank transfer payout timing","id":"step-2-choosing-the-bank-transfer-payout-timing","depth":3},{"value":"Step 3: About payment facilitation","id":"step-3-about-payment-facilitation","depth":3},{"value":"Step 4: Checking reservations","id":"step-4-checking-reservations","depth":3},{"value":"Step 5: Submitting the onboarding request","id":"step-5-submitting-the-onboarding-request","depth":3},{"value":"Step 6: Payments activation confirmation","id":"step-6-payments-activation-confirmation","depth":3},{"value":"Virtual Credit Card (VCC) onboarding flow","id":"virtual-credit-card-vcc-onboarding-flow","depth":2},{"value":"Step 1: Choosing the payout method","id":"step-1-choosing-the-payout-method-1","depth":3},{"value":"Step 2: About payment facilitation","id":"step-2-about-payment-facilitation","depth":3},{"value":"Step 3: Checking reservations","id":"step-3-checking-reservations","depth":3},{"value":"Step 4: Confirming the configuration","id":"step-4-confirming-the-configuration","depth":3},{"value":"Step 5: Payments activation confirmation","id":"step-5-payments-activation-confirmation","depth":3}],"frontmatter":{"title":"Tutorial: Designing the Payments by Booking onboarding flow","description":"Step-by-step tutorial with Extranet mockups for designing a Payments by Booking onboarding flow in your platform, covering bank transfer and virtual credit card payout method selection.","keywords":{"includes":["payout_method","payout_frequency","payout_netting","payin_collection_strategy"]},"seo":{"title":"Tutorial: Designing the Payments by Booking onboarding flow"}},"lastModified":"2026-06-22T12:40:47.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/connectivity/docs/payments-by-booking-onboarding-api/creating-pbb-flow-tutorial","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}