# Tutorial: Designing the Payments by Booking onboarding flow

## Introduction

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.

### Prerequisites

Before you begin, you should:

* Have a basic understanding of the [Payments by Booking Onboarding API](/connectivity/docs/payments-by-booking-onboarding-api/understanding-the-pbb-onboarding-api)
* Be connected with the Payments by Booking.com onboarding connection type (see [Connections API Overview](/connectivity/docs/connections-api/connections-overview))
* Have access to property and legal entity information for testing


## Bank Transfer (BT) onboarding flow

The bank transfer onboarding flow guides properties through selecting bank transfers as their payout method and configuring payout timing preferences.

### Step 1: Choosing the payout method

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.

![payout-method-selection](/assets/all-step-0.a363cc8b97d5d2ae0c2a68cf2b6a8db77e427309d9a593aac207fae6b07bea5f.ccfe5165.jpg)

### Step 2: Choosing the bank transfer payout timing

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).

![payout-timing-configuration](/assets/bt-step-1.fa3cbb78c2346698f54e30fb78225b1bb9d429704879fe1d0de993aba9a48782.ccfe5165.jpg)

### Step 3: About payment facilitation

This screen explains who facilitates the payment (Booking.com or the property) based on the policy of the room that the guest books.

![payment-facilitation](/assets/bt-step-2.f1f9546c95cb6ba7c633cda24f6d26eacc9a6846a28d7a866816823a1b46110b.ccfe5165.jpg)

### Step 4: Checking reservations

Before confirming the configuration, properties are explained how they can check the payment status of the new bookings.

![checking-reservations](/assets/bt-step-3.dbaed8aab0ef02f992cb6186e76141ce754b6617fa9dc2eaeb9a4da2e865f6a6.ccfe5165.jpg)

### Step 5: Submitting the onboarding request

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](/connectivity/docs/payments-by-booking-onboarding-api/understanding-payouts#note-for-bank-transfers) section.

Support for bank details configuration via the API is planned for a future release.

### Step 6: Payments activation confirmation

Once the payments activation is complete, properties receive a confirmation.

![onboarding-success](/assets/pbb-congrats.18b293fbc0ab7e30b5347b97adf0d2bf39c54a6c14db815131c92b5069e56a19.ccfe5165.jpg)

## Virtual Credit Card (VCC) onboarding flow

The virtual credit card onboarding flow guides properties through selecting VCCs as their payout method.

### Step 1: Choosing the payout method

Properties start by selecting their preferred payout method from the available options.

![payout-method-selection](/assets/all-step-0.a363cc8b97d5d2ae0c2a68cf2b6a8db77e427309d9a593aac207fae6b07bea5f.ccfe5165.jpg)

### Step 2: About payment facilitation

This screen explains who facilitates the payment (Booking.com or the property) based on the policy of the room that the guest books.

![payment-facilitation](/assets/vcc-step-1.9c02ff29a61ea640260e21d64713e0a062b2f52aec567af04f67ebb210695cf3.ccfe5165.jpg)

### Step 3: Checking reservations

Before confirming the configuration, properties are explained how they can check the payment status of the new bookings.

![checking-reservations](/assets/vcc-step-2.1df8ea128341f780bf526a17a1290badbd3d5754d7bf3ba0c5a96f9dcb863dda.ccfe5165.jpg)

### Step 4: Confirming the configuration

Properties review and confirm the configuration details before submitting the request.

![confirming-configuration](/assets/vcc-step-3.10958ba312156a3de19458f70bab16abe9756ef085020e9f60cfbcbdd61bd8cc.ccfe5165.jpg)

### Step 5: Payments activation confirmation

Once the payments activation is complete, properties receive a confirmation.

![onboarding-success](/assets/pbb-congrats.18b293fbc0ab7e30b5347b97adf0d2bf39c54a6c14db815131c92b5069e56a19.ccfe5165.jpg)