About 3 minutes · Written for Stay 1.0.0

Taking payments

Connecting your own Stripe account, the deposit and the balance, and refunds.

Cottages → Payments. Stay uses your own Stripe account:

  1. Make a Stripe account at stripe.com if you have none (with your bank details for payouts).
  2. In Stripe: Developers → API keys. Reveal the secret key and paste it into Secret key. Start with the test key (sk_test_).
  3. Stay checks the key, names the account and sets up Stripe’s news of payments itself. There is nothing to copy back.
  4. In test mode, book a stay yourself with the card 4242 4242 4242 4242. When it all works, paste your live key (sk_live_).

What happens: the guest pays the deposit on Stripe’s own secure page, and the card is saved for the rest, which is taken on its date. If the bank wants the guest to approve it, the guest is emailed a link and you are told. Inside the balance window the guest pays it all at once. Card details never touch your site.

When a guest pays offers Book it straight away (the usual) or ask first: the card is saved and nothing is taken until you press Confirm.

Refunds and cancelling: from a booking’s Payments box, or Cancel or refund in the bookings list. Refund what the terms give, everything, or another amount.

Without a key, guests ask to book, nothing is charged, and you arrange the deposit yourself.

How guests pay: Stripe, or your own ways

Cottages → Payments → How guests pay (also step 6 of Set up Stay). Stripe isn’t available in every country, and not everyone wants it. Choose:

  • By card, through your Stripe account. The default: everything above, unchanged.
  • Your own ways: bank transfer, a payment link, or in person. Tick any:

    • Pay in person: on arrival or as you arrange. On its own, guests ask to book and you confirm, as without Stripe.

    • Bank transfer: type your bank details exactly as your bank gives them; every country writes them differently. A guest sees them only after they book (on their own booking page, which only they can open) and in their emails; never on your public pages. Stay adds a reference for each booking, its number and the guest’s last name (214 HALL), so you can match the payment.

    • A payment link: the address of a payment page from any provider you already use (a Stripe Payment Link, PayPal.me, Square, Mollie, Razorpay, your bank’s pay page), starting https://, and optionally the words on its button. Shown as a button after booking. Stay holds no keys for it and takes no fee. An address that doesn’t start with https:// isn’t saved, and the screen says so.

The deposit and when the rest is due are the ones under Seasons and terms, the same as for cards: a share of the total at booking, the rest some days before arrival, all at once when booked closer than that.

Until it’s paid, one of two:

  • Hold the nights until I mark the deposit paid, for up to 48 hours (you choose the hours). The guest is told the deposit, how to pay it and by when. Nobody else can book those nights meanwhile, here or on the sites that read your calendar. When the money reaches you, press Mark deposit paid under the booking in Cottages → Bookings: the booking is confirmed and the guest gets your Booked email. If it isn’t marked paid in time, the nights are let go on the hour, the guest is emailed and you are told. A hold never runs past the start of the arrival day, and a stay booked too late to pay in time is booked straight away.
  • Confirm straight away: booked at once; the deposit request is information only. Mark it paid when it arrives.

The rest is due on its date. The guest’s The rest is due email (a week before, under Guest emails) carries your bank details or the link. Mark it paid from the booking’s Payments box (Take payment, refund or cancel), with the amount that arrived; the guest gets a receipt.

Stay can’t see money arrive. Check your bank or your payment provider before you mark anything paid. Money you mark paid can’t be sent back by card: if a guest cancels, refund them yourself, the way they paid. Guests with such a booking ask you to cancel rather than cancelling online.

Bookings already paid by card keep their card, and their rest is still taken on its date, whichever you choose for new bookings.

From the Stay 1.0.0 guide, the one in your dashboard under Theme guide.Still stuck? Email support