Transitioning from Stripe to PayPal as the default processor
Last updated: September 19, 2025
For Admins
Prerequisites:
- Dashboard must be in a country/currency combination supported by PayPal.
- Country/Currency combination cannot be changed to support multiple countries or currencies.
Important for onboarders and AMs
It is important not to disable Stripe as a payment processor on Dashboards which have made PayPal their default payment processor and have existing Stripe transactions. This is not supported and will not likely be supported in the near future. Disabling Stripe will cause all prior sales reporting in the Dashboard to be lost. A new Dashboard will need to be built if the client demands that they have a PayPal-only Dashboard. This use case shouldn’t be prevalent though.
Setup
Enabling PayPal
- Log in as FH Admin.
- Navigate to the Advanced Company Settings under General > Payment Processors and select the checkbox next to PayPal to enable it as a payment processor.
- Click Save.
- Navigate to Settings > Bank & Payments and select the Edit button for the Payment Overview table:
- Select PayPal as the default payment processor from the dropdown menu
- Go through the steps to create/verify a PayPal account to your FareHarbor Dashboard.
Changing default processors
Clients should be made aware of the changes that they are going to see on their Dashboards and update their staff and operations accordingly. When a Dashboard is changed from Stripe to PayPal, no new Stripe payments can be made. This means direct bookings and expenses will be restricted to in-store payment methods. The online book form will not display Stripe-based payment methods (including iDeal and any future payment methods we add that are Stripe-based). Booking fees will also be handled differently as discussed in the PayPal as the only payment processor documentation.
- The client will pay the processing fee on the booking fee as is the case with PayPal as only Dashboards.
- On refunds, PayPal will refund the booking fee proportionally to the client .
- PayPal will always keep the flat fee portion of any fees imposed (for US companies this is $0.30).
- For partial refunds this won’t be noticeable, however for full refunds the clients will still see a fee on those bookings which could be confusing.
Because clients and Dashboards will continue to have to deal with older bookings made in Stripe, we will be continuing functionality to be able to handle existing Stripe bookings. This means the client will still be able to make refunds on existing Stripe payments, manage their refund reserve, add new cards (but not create new Stripe payment objects), add devices, create and manage ledgers, process payouts, manage transfers, create new bank accounts, as well as use old bank accounts.
What to expect
Stripe Payments
Existing payment where Stripe is the default payment processor will be refundable. If the client makes a refund on an existing Stripe processor payment it will be handled exactly as it is with Stripe as the default payment processor. No new payment will be allowed with the Stripe payment processor though. On existing bookings all new expenses will need to be handled through in-store payment methods (gift cards will continue to work as they currently do).
PayPal Payments
PayPal payments will be available to customers making online bookings and payments. In store payment methods will need to be set up to accommodate in-person payments.
Refunds
Refunds made on existing Stripe payments will continue to be processed as long as there are funds in the refund reserve and Stripe still allows the company to process payments.
Reports
Reports will continue to work as expected. Clients who wish to separate out PayPal from their Stripe payment records will need to search and filter by Payment Method/Credit Card type. This is because PayPal is handled as a credit card in our system.
Booking Overlay
Clients will be able to see whether or not a payment was made using Stripe or PayPal in the payment overview section. Bookings will be able to have both PayPal as well as other Stripe and in store payment methods on a single booking depending on the circumstances of the booking and additional expenses etc.
Affiliates and ASN
Affiliates and ASN clients will continue to be able to use links and Dashboard views to book and offer items and availabilities as they currently are. Because we have the ability to maintain bank upload and debit creation, clients who have a processor capable of receiving and initiating uploads (in this case Stripe) will continue to be able to process invoices through FareHarbor. This might seem counterintuitive, however processing invoices isn’t a new stripe payment in the system. It is handled as a bank debit, which we must continue to allow when Stripe is enabled to handle any refunds the client may need to address in the future.
Frequently Asked Questions
Can I continue to make refunds on payments made with a Stripe payment method?
Yes. Users will still be able to make refunds on existing Stripe payments as long as their Stripe account is still valid.
What if I don’t have enough in my refund reserve to ensure a successful refund?
Bank uploads in the US will continue to work as long as Stripe supports the client’s country.
Clients in Europe will need to handle refunds outside of FareHarbor.
Can I continue to make affiliate payments if Stripe is no longer my default payment processor?
As long as the Charter and Affiliate both have Stripe as payment processor set up (either default or enabled), affiliate payments will continue to be supported, yes.
Will affiliates continue to be able to book through my Dashboard/ASN links?
Yes.
Will Payouts continue to work?
Yes, as long as Stripe supports the client’s country we will continue to support payouts of existing Stripe charges.
Will I still be able to run reports on Stripe bookings and payments
Yes
Will Gift Cards still work?
Yes, Dashboard users and customers will continue to be able to apply gift cards to existing and new bookings.
How will recurring transfers work?
Recurring transfers will work as long as there are funds available to transfer.
Will ledgers continue to work?
Yes, if a ledger is assigned at the item or available level funds will still be tracked New payments made using PayPal as the payment processor will be associated with the ledger assigned to the item or availability at the time of booking. If the item’s ledger association changes by rebooking to a new item or availability, the effective ledger will change accordingly. However, all funds will be deposited directly into the client’s verified PayPal account.
Any payments previously made with Stripe which have yet to be paid out, will continue to be paid out to the bank account associated with the ledger assigned at the time of booking..
How will reports work?
Reports will continue to work per usual. To view PayPal specific payments vs other payments: navigate to your Sales reports, create filter by credit card type, and from there users are able to dig into which bookings are made with PayPal vs other payment methods.