Payment Setup Checklist for PayPal
Last updated: July 1, 2025
PayPal is a worldwide online payments system that supports online money transfers and serves as an electronic alternative to traditional paper methods like checks and money orders. You can link your PayPal account to your FareHarbor Dashboard, giving your customers the ability to complete online payments using PayPal.
Note: To use PayPal as your primary payment processor for your FareHarbor Dashboard, you must have a PayPal account with a bank account attached that is verified to accept payments as a business or create one through your Payment Setup Checklist. If you would like to use PayPal as your primary payment processor, please contact FareHarbor Support.
In order to track PayPal transactions in your FareHarbor Dashboard, you’ll need to complete the Payment Setup Checklist, a required set of steps you must take before you can process online payments with FareHarbor. You won’t be able to accept payments until this checklist has been completed.
What you’ll need to complete the checklist
This checklist will require some basic information regarding your business. Before starting, please make sure you have the following handy:
- Login access to your company’s PayPal account
- Access to the email associated with your PayPal account
Accessing the Payment Setup Checklist
To access the Payment Setup Checklist, go to the Settings section of your Dashboard and select Bank & Payments from the sidebar. The checklist is located in the Overview tab.

Learn more about what the checklist includes by reading the sections below.
Entering customer verification
Starting the process
After selecting this step of your Payment Setup Checklist, you will be asked to Start the verification process. You must complete the process within 30 minutes, so be sure to have your materials ready. You will be taken to PayPal’s secure portal to complete the process.
Your PayPal account
You will have the option to enter credentials for a verified PayPal account with a bank account attached or create a new PayPal account during the verification process (if you’re creating a new PayPal account, make sure you have all relevant business information ready).
Note: You cannot change which PayPal account is associated with your Dashboard once it has been verified and attached. Please ensure that the PayPal account you use to complete the Payment Setup Checklist is the desired account you’d like to use with your FareHarbor Dashboard permanently.
If you create a PayPal account without using the FareHarbor Dashboard, please confirm that you select the correct processor country by selecting the flag icon in the bottom-right of the PayPal signup window. If you do not select the correct processor country during setup, you will need to create an entirely new PayPal account from scratch.
Note: You must use the same processor country in PayPal as you do in FareHarbor. Otherwise, you will not be able to accept payments.
Finishing the process
Either way, you’ll need to follow the given steps to ensure your PayPal account is properly linked to your FareHarbor Dashboard. This will include things like allowing permission for FareHarbor to link to your PayPal account, agreeing to any relevant terms of service, or verifying your email (if required).
When you are finished and select Done, you will be redirected back to your Payment Setup Checklist in FareHarbor, which will be green to indicate the completion of the process.
Note: If you have created a new PayPal account through this process, you must verify your email in order to properly activate your PayPal account to be able to receive payments.
What it looks like
Your customers will now see the PayPal payment method when completing the checkout process. Selecting this option will open a pop-up of PayPal’s secure payment portal. When they have completed their payment, they will be taken back to your site’s confirmation page. The payment method will be shown as “PayPal” on their confirmation emails, receipts, and bank statements.
When you view your payments in PayPal, you’ll be able to see all the Transaction Details, which includes:
- Customer name
- Transaction date
- PayPal Transaction ID
- Order Details that show:
- FareHarbor item name
- Date of booking
- Booking start time
- Booking ID
- FareHarbor URL to the booking in your Dashboard
Prepare for potential refunds (required)
In addition to connecting to your bank account, we highly recommend that you manually add money to your PayPal account balance as well as add a credit card to your PayPal account. Because money cannot be pulled automatically from your attached bank account or credit card, manually adding funds to your PayPal account ensures you are always able to refund your customers, if needed. Your PayPal balance should be an amount you feel is sufficient to process the typical amount of refunds you need to each day. You can always add money to your account at any time.
Know Your Customer (KYC) validation (recommended)
To have the best experience using PayPal with FareHarbor, the following steps are recommended:
Completing these steps helps prevent holds from PayPal and ensures you can take payments quickly and easily.
Important note if you are connecting a bank account in certain countries:
If you are attempting to connect a bank account to a PayPal account in the following countries,
Antigua & Barbuda, Albania, Algeria, Bosnia & Herzegovina, Barbados, Belize, Dominica, Egypt, Fiji, Grenada, St. Kitts & Nevis, St. Lucia, Malawi, New Caledonia, French Polynesia, Palau, Seychelles, Turks & Caicos Islands, Trinidad & Tobago
you will only be able to attach a US-based bank account for your payouts to go directly to a bank account. Alternatively, you can connect a Visa card to your PayPal account for your payouts. Please be aware that this is a necessary step in fully completing your PayPal setup and must be completed before we are able to successfully accept payments on your Dashboard.
For further information and restrictions please view this page on the PayPal website.
What to expect with payments
PayPal prioritizes protecting their clients to ensure that their platform remains as safe and secure as possible. As such, there may be scenarios where a PayPal transaction is put on hold or in a pending status immediately. Learn more about when this happens and what actions you can take to ensure timely, secure payment.
What does it mean when a payment is pending?
There are some instances where PayPal will label a payment as “pending review”. This happens more often with newer PayPal accounts or PayPal accounts in certain areas that are at a higher risk for fraud. It can also occur if you have not completed your Know Your Customer (KYC) validation or did not verify a bank account, so please make sure to complete those steps in order to avoid pending payments as much as possible.
When a payment is labeled as pending, PayPal holds the funds until the payment can be processed. If this occurs, you will receive a notification email from PayPal. In most cases, you should be able to process the funds and successfully accept the payment. In some cases, however, the pending review can take up to 21 days, after which PayPal will release the funds to you.
You can read more from PayPal about releasing held payments (note: as a FareHarbor user, you will fall under the “intangible item” category in PayPal’s documentation).
What will pending review payments look like on my FareHarbor Dashboard?
Payments that PayPal has labeled as “pending review” will appear as normal, successful payments on your FareHarbor Dashboard.
What happens if I decline a pending payment?
If you want to decline a pending payment, you can refund the charge directly in your FareHarbor Dashboard. The payment will be declined and the money will be refunded to the customer.
If you accidentally declined the payment and would like re-collect it, you will need to reach out to the customer and collect payment manually. To correct any accidental declines in your FareHarbor Dashboard, adjust the booking using custom refund, then ask the customer book again.
Reported processing fees and pending payments
PayPal doesn’t provide any of the processing fees for payments which are pending review. Because of this, FareHarbor will display fees for these payments in reports as $0.00. The fee amounts will automatically update once the payment has been cleared and PayPal provides the information (Note: this may change the total net from day to day if you have a lot of pending payments).
How can I avoid pending review captures?
Completing the following steps will help minimize the amount of payments marked as pending in your PayPal account.
- Add and verify a bank account or debit card.
- Complete all KYC requirements.
- Provide all the necessary information for PayPal to verify your business. PayPal will attempt to automatically verify your business by accessing electronic records according to your country of operation.
- This process will differ depending on your location, but in every case, PayPal will alert you about any additional required steps to verify your business through your PayPal dashboard or your PayPal resolution center.
- Verify the email address used by your PayPal account.
- Verify the phone number used by your PayPal account.
Preventing lost chargebacks and claims
While using PayPal with FareHarbor, we want to help prepare you for any disputes that may occur. To help you successfully process disputes, here are some examples of what is considered compelling evidence that a customer actually went on your item.
Examples of Compelling Evidence for Intangible Goods


FAQs
How soon will I start receiving payments after completing the Payment Setup Checklist?
You can start accepting payments as soon as you have completed the Payment Setup Checklist and ensured that your PayPal account is ready to receive payments. Make sure to log into your PayPal account to complete any supplemental tasks, such as verifying your email.
Once a customer makes a booking using PayPal, the funds will be moved directly to your PayPal account. You are able to hold those funds as a reserve or transfer them to a PayPal connected bank account. FareHarbor does not hold any PayPal funds in escrow.
How do I process refunds?
You should process all refunds through your FareHarbor Dashboard. Once processed, you will be able to see the status of the refund throughout your Dashboard.
If you have accidentally processed a refund through your PayPal dashboard, you should create a custom refund to reflect it in your FareHarbor Dashboard. Though this will not fix slight discrepancies you may see in reports due to processing your refund in PayPal, using a custom refund avoids potential errors and ensures that your FareHarbor Dashboard correctly displays the transaction as refunded.
What if I get a dispute?
If you receive a dispute on a PayPal payment, you will receive an email from PayPal notifying you of the dispute and requesting your response. You must respond within the timeframe indicated or the refund will be automatically processed in the customer’s favor as per PayPal’s policy.
Note: You must respond within the given timeframe for any PayPal disputes or the refund will be automatically processed in the customer’s favor as per PayPal’s policy.
Why did my customer’s booking get automatically refunded?
Occasionally, PayPal will set a transaction as “pending” in order to ensure that the payment isn’t fraudulent. When this happens, your FareHarbor Dashboard won’t create a booking and automatically refunds the customer’s PayPal payment.
Whether a customer calls in about their refunded booking or you reach out directly to a customer whose payment you believe to be legitimate, you can ask them to try booking again with a different payment method to complete the transaction.
Can I run reports on PayPal payments?
Because PayPal monitors fee and tax information specific to certain countries and regions, you must run reports through PayPal’s portal to accurately reflect that information. Read more about reporting with PayPal.
Why isn’t my verification working?
Sometimes, you may need to add additional information in order to complete your PayPal verification successfully. Here are some common statuses and extra steps you may see in your Dashboard:
- Please confirm your email address to receive payments: This message means that you still need to confirm the email address that is associated with your PayPal account. You must confirm your email address to verify your PayPal account. Confirm your email address by locating the confirmation email sent to you by PayPal and following all associated instructions.
- You currently cannot receive payments due to a restriction on your PayPal account: This message means that there is a hold on your PayPal account that must be resolved through PayPal’s website in order for you to use the PayPal account with your FareHarbor Dashboard. You can complete any associated steps by logging into your PayPal account directly.
- PayPal account country invalid: In order for PayPal to work with your FareHarbor Dashboard, the country associated with your PayPal account must be the same as the country associated with your FareHarbor Dashboard. Reach out to FareHarbor Support to resolve this issue.
- PayPal permissions not granted: This message means that you have not added the correct permissions on your PayPal Dashboard to work with FareHarbor. Reach out to PayPal Support and ask them to grant FareHarbor the correct permissions in your PayPal account.
Still having trouble? Feel free to reach out to FareHarbor Support with any of your questions.
Internal-only content. Don't copy and paste to anyone.
Note: Check out which payment service providers are supported in which countries to check if a Dashboard has the ability to enable PayPal.
Please note that clients can’t use PayPal as the sole payment processor in countries where Stripe is also available.
Setup
There are several steps required to make sure a client’s Dashboard is all set to accept payments with PayPal. Each step in the process ensures that everything is correctly set up to process payments.
Overall, a client requires the following to properly use PayPal to process payments that show on their FareHarbor Dashboard:
- PayPal is enabled on their FareHarbor Dashboard.
- Their PayPal account is linked to the FareHarbor Dashboard.
That PayPal account is verified in PayPal’s system.
If a client is using a pre-existing PayPal account for this process, chances are that the account is already verified and they won’t have to complete this step.
Note: Make sure a client brings or sends the appropriate PayPal account information when being trained or having their Dashboard set up.
1. Enable PayPal on the Dashboard
If you are creating a new company, select “PayPal” under the Payment Processor dropdown on the company form (Note: You will only see this option if the processor country and currency is on the list of supported combinations in the table below).
If you are editing an existing company:
- Navigate to “Advanced company settings”.
- In “General”, select “PayPal” under the Payment Processor section (Note: You will only see this option if the processor country and currency is on the list of supported combinations in the table below).
- Select Save.
If you have any suggestions or questions about this table, please let us know.
2. Client completes the Payment Setup Checklist
After PayPal has been enabled on the company’s Dashboard, they will need to complete the Payment Setup Checklist. This process is entirely hosted by PayPal, and selecting Start on the Payment Setup Checklist will take the client to PayPal’s secure portal to complete the process. This process properly links a PayPal account with a FareHarbor Dashboard.
Note: The client must use the same processor country in PayPal as they do in FareHarbor. Otherwise, they will not be able to accept payments.
For clients with an existing, verified PayPal account, completing the steps in this portal will likely take care of all the steps required to accept payments on their FareHarbor Dashboard.
3. Additional steps required to receive payments (if applicable)
Clients have the option to create a new PayPal account within the PayPal-hosted Payment Setup Checklist portal. For clients that do create a new PayPal account during this process, there will be at least one additional step: verify their email address.
All PayPal accounts require a verified email address, and if a client creates an account using this portal, they will need to verify their email address in addition to completing the Payment Setup Checklist to ensure they are ready to properly receive payments.
PayPal Onboarding FAQs for Sales
Limited Account
During the onboarding process within PayPal, an account may be “limited”. A limited account means that you won’t be able to do certain things with your PayPal account. For example, you might not be able to send or withdraw money.
What to do to fix this
- Go to the Resolution Center.
- Click Go to Account Limitations.
- Next to each step required to remove the limitation, click Resolve and follow the steps to provide that information.
Releasing payments on hold
- If the held payment is for a service or intangible item (e.g. piano lessons, e-book), update the order status on your PayPal account and you’ll get your money within 7 days after verification.
- Once you update the order status: order processed, the buyer(customer) receives an email notifying them that you entered the shipment tracking information for this transaction (if applicable). The email includes the tracking number (if applicable), order status, and shipping company (if applicable).
- Your funds will be released 1 day after we confirm that your item was delivered (if there’s a tracking number).
- Your buyer will be prompted to let us know if they have received their order. Once your buyer confirms that they have received the order, your funds will be released instantly.
- If you do not complete the above steps, your money will be available 21 days after the purchase was completed.
Adding a bank account
If you are unable to add a bank account, it could be because of one of these options:
- The bank account is already linked to another PayPal account.
- Your PayPal account is limited.
- The name on your bank account needs to match the name on your PayPal account.
Withdrawing money from PayPal to your bank account
- A transfer to a bank account typically completes in 1 business day, but it may take longer depending on your bank’s clearing process.
- We only support transfers in local currency. So, if you have a PayPal account in England (GBP), but want to transfer money to your bank account in Germany (EUR), you may be subject to cross border conversion fees.
- Some banks may charge fees for electronic funds transfers. Please contact your bank directly for more information.
PayPal Support
- Go to the Contact Us page.
- Choose the topic and subtopic that best match your reason for contacting us.
- Select Message us near the bottom of the page. (You’ll be prompted to log in if you haven’t already done so).
Comparing PayPal with Stripe
Though PayPal operates much the same way as Stripe does in the Dashboard, there are a few minor differences that are worth noting.
Note: The primary difference between Stripe and PayPal is that while FareHarbor uses direct access in Stripe to handle and manage transactions, FareHarbor has no direct access to money or transactions in PayPal. PayPal is the sole manager of transactions, and FareHarbor is built to display transactions made with PayPal, not handle transactions.
Read our internal page comparing all our payment processors.
Affiliates and PayPal
Affiliates will need to handle invoices outside of FareHarbor since we are unable to do direct debits from either an affiliate’s or a charter’s bank account. Since Dashboards with PayPal do not have bank accounts affiliated with them (they only have PayPal accounts linked to them), the Dashboard doesn’t have the access that would allow direct bank debits.
The following three scenarios address how payments will work when using PayPal:
- PayPal-only Charter + Stripe Affiliate: The affiliate company will need to take the payment for the booking and have the charter company invoice them.
- Stripe Charter + PayPal-only Affiliate: The charter company will take the payment for the booking using their Stripe card entry fields, and have the affiliate invoice them.
- PayPay-only Charter and Affiliate: Custom in-store payments will need to be set up to record payment since neither charter nor affiliate can accept card payments using their FareHarbor Dashboard.
PayPal’s Bank account requirements for higher risk countries
Clients in the following countries will only be able to connect a US-based bank account to their PayPal account if they wish their deposits to go directly into a bank account. Alternatively, they are able to connect a Visa debit card to their PayPal dashboard to facilitate payouts. This Visa debit card does not need to be US-based:
Antigua & Barbuda, Albania, Algeria, Bosnia & Herzegovina, Barbados, Belize, Dominica, Egypt, Fiji, Grenada, St. Kitts & Nevis, St. Lucia, Malawi, New Caledonia, French Polynesia, Palau, Seychelles, Turks & Caicos Islands, Trinidad & Tobago
For further information and restrictions please go to this page on the PayPal website.
Troubleshooting
Almost all errors will be due to something triggered on the PayPal side. Though we can’t help directly with these issues, we may be able to add additional context for clients, and point them in the right direction for their issue.
Setup
- For French Polynesian clients, it’s not possible to link a Polynesian bank account to PayPal (PayPal doesn’t accept their usual bank codes). There are two options for Polynesian clients:
- They can create a Euro PayPal account in France (this is the process for Polynesian Stripe clients anyway).
- They can use a VISA credit or debit card to set up the account.
- Clients will have to accept the “permission granted” notice on PayPal’s end to ensure FareHarbor has appropriate permissions. They should have completed this step if they properly completed the Payment Setup Checklist, but should always be verified if they’re experiencing a problem.
After setup
The following issues will require a client to contact PayPal Support:
- Any problems with payouts and disputes must be resolved with PayPal.
- Payments must be marked as ‘receivable’ on the PayPal side. FareHarbor has no control over that, but we can diagnose it and notify clients when it needs attention.
If a client’s PayPal account is flagged:
Note: PayPal will always send a notification email if there is a problem with a PayPal account. Please ensure that clients always check the email they use on their PayPal account for any communication (they might need to check spam).
This means that PayPal has found something suspicious on their account, like suspicious transactions, and has restricted the account somehow to prevent fraud.
- PayPal has different levels of limitations (like restricting an account to receiving money but not sending out, totally locking down an account, etc).
- In every case, a client must act! PayPal will always send an email notification about these. Clients must follow the steps indicated in PayPal’s communication (usually this includes either uploading documentation or contacting PayPal Support).
- If a client accidentally refunds in PayPal (which they shouldn’t be doing, see above), they will need to go to the booking in FareHarbor > Advanced > Custom refund > Refund and refund the exact same amount manually to the newly created type “PayPal Refund”.
Note: Because of how PayPal rounds numbers for refunds, sometimes it’s necessary to shuffle a cent from one partial refund on an order to another booking charge on a PayPal order. This can lead to a potential discrepancy to company’s books, but no money is lost or gained when this happens. It is simply a result of PayPal’s rounding methods.
Changing PayPal Accounts
Though typically a client cannot change the PayPal account associated with their FareHarbor Dashboard, there is one exception scenario.
If a client’s Dashboard has NO bookings and NO payments on their Dashboard, it is technically possible to reset their customer verification information, which allows them to use a different PayPal account. Some reasons a client would need to do this are:
- Client added the wrong PayPal account initially
- Client created a new PayPal account that they would like to use instead of the previously added account
If a Dashboard has NO bookings and NO payments and would like to change their PayPal account, please reach out to #payment_operations on Slack.