Let Guesty Process Direct Booking Payments

If you run your business out of Guesty, you can keep collecting money there and still take direct bookings on your Haven site. In this mode Haven prices the stay exactly as it prices any direct booking, with your Haven rates, discounts, promotions, discount codes and fees, and the taxes Haven syncs from Guesty. The guest pays that price on your Haven site with a card form in your Guesty payment processor, and the booking lands in Guesty already paid, with the guest's card on file for upsells and incidentals.

It runs over the Guesty connection you already have. There is no extra Guesty API key to create.

This is optional. By default Haven prices and collects every direct booking through Stripe, and nothing about that changes unless you switch it on.

Before You Start

You need:

A paid Haven plan.
A connected Guesty account in Haven (Host Dashboard → Integrations), with at least one listing imported.
A payment processor assigned to those listings in Guesty (Financials → Payment processing): GuestyPay, Merchant Warrior, HYP, or a Stripe account connected to Guesty. Guesty charges the guest on that processor; Haven never holds the money.
Stripe connected to Haven, only if you sell add-ons at booking. Guesty collects and pays out the stay, so you don't need Stripe for that. Haven charges add-ons itself, so they still need somewhere to land.
A payment method on file in Haven, if you use Screen & Protect or guest verification. Those become billed to you in this mode.

Haven blocks the option and tells you which of these is missing, rather than switching on and quietly dropping something.

Turning It On

Open Host Dashboard → Integrations and find the Guesty card. Under Guest payments, Haven lists the payment processors your Guesty listings charge through, read live from Guesty.
If a processor is a Stripe account, paste that account's publishable key into its row and press Save. You find it in that Stripe account under Developers → API keys (it starts with pk_live_). Most hosts have one account. This lets the card form on your site create the payment in the same Stripe account Guesty charges. GuestyPay, Merchant Warrior and HYP need nothing here.
Open Host Dashboard → Payouts → Payouts. At the top, under How guests pay you, choose Guesty. Haven checks with Guesty first: the option stays greyed out, with a note saying what is missing, until every listing has an active payment processor in Guesty, every Stripe account has its publishable key, and every listing's taxes come only from Guesty (see Taxes).

It saves as soon as you pick it. The page then leads with your Guesty payouts, and the Stripe section folds underneath it, marked Optional or Required for whatever still needs it. Payouts in the sidebar shows the Guesty mark.

If you change a listing's payment processor in Guesty, press the refresh button next to Guest payments on the Guesty card to see the change.

Which Listings It Covers

Listings mapped to your live Guesty connection.

A listing with no active payment processor in Guesty shows guests a message that it cannot take payment yet. The Guesty card counts these.
A listing on a Stripe account with no publishable key on the Guesty card cannot take payment until you add the key.
Guesty still applies its own booking rules (a minimum stay, a closed arrival day) when the dates are held; guests see Guesty's reason.
Multi-room bookings of several listings at once keep taking payment through Haven and Stripe.

What Your Guests See

They pick dates on your Haven listing and see Haven's price, the same as on any Haven listing: nightly prices in the date picker, and a total with each discount, fee and tax on its own line. A discount code they enter is a Haven discount code.
They enter their details on Haven, choose any add-ons, and save a card for the add-ons if they bought one.
At the payment step, Haven holds the dates in Guesty with a reserved reservation carrying Haven's price, so nobody else can book them while the guest pays. If they don't pay within about an hour, the hold is closed and the dates open again.
Before the card form appears, Haven reads back what Guesty will charge for that reservation. It must equal the price the guest was shown, to the cent. If it doesn't, nothing is charged, the guest is told the booking can't take payment right now, and Haven emails you what disagreed and what to change (see Troubleshooting).
The payment step shows Guesty's secure card form (or a Stripe card form in your Stripe account). The card details go straight to the processor; Haven never sees them. If the bank asks for a verification step (3-D Secure) on Guesty's form, it appears right there. Once the form is open the price is fixed, so the guest can no longer change their discount code. If they bought add-ons, the form tells them the add-ons are a separate charge.
Pressing Pay charges the card on your processor for exactly the total the guest was shown, and confirms the reservation in Guesty. The guest lands on their Haven guidebook with the usual confirmation email.

If the charge is declined, nothing is charged and the guest can try another card. If Guesty takes longer than usual to answer, the guest sees that the payment is being confirmed and can check its status again; they are never offered a second Pay while the first one is unsettled.

Who Charges What

Charge	Who collects it	Who refunds it
The stay, taxes, and fees	Guesty	Guesty
Add-ons the guest bought on Haven	Haven	Haven
Screen & Protect	Haven, billed to you	Haven
Guest verification	Haven, billed to you	Haven

A guest who buys an add-on sees two charges on their statement: one from your Guesty payment processor for the stay, one from you through Haven for the add-on, for exactly the add-on total they were shown (no card fee is added). Everything else is a single charge.

If your card is declined for Screen & Protect or verification, or there is no card on file, Haven tries the charge again each day until the stay ends.

What Changes for You

The card stays on file in Guesty. The reservation arrives in Guesty paid, with the payment method saved for reuse, so you can charge upsells, incidentals or a damage deposit from Guesty as you would for any other reservation.
Reservations come from the haven source. Haven books under the same haven source its other bookings use. The fare and cleaning fee on the reservation are Haven's price, with Guesty promotions switched off for it. Haven's price already includes your discounts, so a Guesty markup or fee that changes what the guest pays makes Haven refuse the booking rather than charge a different amount.
Booking requests are approved in Haven, paid through Guesty. A request is priced by Haven when the guest asks, and does not create a reservation in Guesty until the guest pays. Approving it sends the guest a payment link to the same Haven page, where they pay with the card form; the reservation then appears in Guesty confirmed. If the guest opens the card form and leaves without paying, the request stays approved and the same link works again later. A request can't include add-ons on these listings (instant bookings can), and Haven's Adjust price is not offered on them.
Refunds and price changes for the stay happen in Guesty. Haven can't issue them because it never held that money. The reservation page links you straight to the reservation in Guesty. Cancelling the stay from Haven still cancels the Guesty reservation; the refund itself is yours to make in Guesty. Haven still refunds what it charged: add-ons, and Screen & Protect for nights that haven't started. The verification fee is a one-time service and isn't refunded.
Haven's discounts and settings apply. Weekly and monthly discounts, early-bird, last-minute and other promotions, your direct-booking discount, Haven discount codes, and your cleaning, pet and other fees all price the stay, exactly as on a listing Haven collects for.
Loyalty points, gift cards and Haven Credit don't apply. They are spent against a charge Haven makes, and Guesty makes this one. Card-fee pass-through is off for these listings too.
Screen & Protect and guest verification are billed to you, never to the guest. Your guest-pays settings are ignored on these listings.
Payouts come from your Guesty payment processor, on its schedule. Haven's scheduled payouts only cover money Haven collected.

Taxes

Guesty adds its own taxes to every reservation, so the taxes on these listings come from Guesty. Haven syncs them from Guesty and uses them to show the guest the same tax Guesty will charge.

Fees and taxes

Haven creates the reservation in Guesty with two prices: the accommodation fare and the cleaning fee. Every other fee on the stay (a pet, resort, management or custom fee) goes into the accommodation fare. If one of your Guesty taxes applies to the accommodation fare but not to that fee, Guesty would tax the fee as part of the fare and charge the guest more tax than they were shown. Haven refuses those stays before holding the dates and emails you which tax and fee. To take them, apply the tax to those fees in Guesty (or remove the fee), then choose Re-sync from Guesty in the listing's Taxes section. Stays without the fee are not affected.

Editing taxes

In a listing's Taxes section the rules show Synced from Guesty, with a note that Guesty collects payment for the listing. While Guesty collects payment you can't add or edit a tax in Haven, choose Edit in Haven, copy taxes in from another listing, or switch on group taxes, and a property group can't apply its taxes to the listing. You can still delete a tax that was added in Haven, and Re-sync from Guesty still works. Change taxes in Guesty; Haven picks them up.

Switching Back

Choose Haven (Stripe) under How guests pay you. Your listings then need a verified Stripe account to take bookings. Bookings already paid through Guesty keep their history and keep pointing at Guesty for refunds; new bookings go back to Haven's checkout immediately.

Troubleshooting

The Guesty option is greyed out on Payouts. Haven checks your Guesty setup before letting you choose it, and the note under the choice says what is missing: a listing with no active payment processor in Guesty, a Stripe account with no publishable key on the Guesty card, or a listing whose taxes are set in Haven. Fix the first two on the Guesty card (Open the Guesty card). For taxes, open the listing's Taxes section, choose Re-sync from Guesty, and remove any tax added in Haven or applied by a property group. If Guesty was already chosen when something went missing, the same note turns red, because guests cannot pay on those listings until it is fixed.

The payment says the listing has no payment processor. Assign an active payment processor to that listing in Guesty (Financials → Payment processing). Until then the listing cannot be charged through Guesty.

The payment says the host still has to finish their Guesty payment setup. Guesty charges that listing through Stripe, but no publishable key for that Stripe account is on the Guesty card. Add it under Guest payments.

A guest with a Stripe card says their bank verification never appeared. Cards that require 3-D Secure cannot complete through a Stripe-through-Guesty checkout; the guest is asked to try another card. GuestyPay's form shows the verification step itself.

A guest says the booking can't take payment and the host has been notified. Haven charged nothing and emailed you A guest could not pay for the listing, with the reason and a button to where you fix it. The usual causes:

A tax in Guesty that Haven couldn't sync exactly (the listing's Taxes section lists any it couldn't).
A Guesty tax that covers the accommodation fare but not a fee on the stay (see Fees and taxes).
A fee Guesty adds to every reservation, or a markup on the haven source.
A payment, or a payment automation for the haven source, already on the reservation in Guesty.
A 100% discount code on the whole stay: Guesty has nothing to charge, so book that guest in Guesty instead. A 100% code that leaves fees unticked under Discounted charges still leaves those fees, and the tax on them, to charge.