How to connect Stripe

Connect with Stripe in a few minutes, what happens to unpaid checkouts, and when to use manual API keys.

In this guide
  1. Connect with Stripe
  2. What customers see
  3. Only one active gateway
  4. Manual API keys
  5. Disconnect

Online payments go straight into your own Stripe account; Goiaba never holds your money and takes no commission. Connecting takes a few minutes and a Stripe account, which you can create during the process if you do not have one.

Connect with Stripe

  1. Go to Settings › Payment Settings (/admin/settings/payments).
  2. On the Stripe row, click Connect with Stripe. You are sent to Stripe's onboarding, where you log in or create an account and confirm your business details and bank account.
  3. When Stripe sends you back, the page shows "Stripe connected. It is now your default payment gateway." and the Stripe row reads Active.

If you left onboarding halfway, the row shows Onboarding incomplete; click Continue onboarding to finish. Stripe may ask for extra documents later; until charges are enabled on the Stripe side, online checkout stays unavailable.

What customers see

Once Stripe is active, the checkout on your website and in your widgets takes card payments. The money lands in your Stripe balance and pays out to your bank on Stripe's usual schedule. Refunds you make from a booking in Goiaba are sent to Stripe automatically, see How to manage, cancel and refund bookings.

While a customer is paying, their seats are held for 20 minutes. If the payment does not complete, the booking is released and the seats go back on sale.

Only one active gateway

Exactly one gateway processes payments at a time; the page shows it under Active Gateway. PayPal and Revolut appear in the list as Coming Soon and cannot be enabled yet.

Manual API keys

Manual Setup lets you paste a Stripe Publishable Key and Secret Key instead of connecting. Use it only if you have a reason to, for example an existing integration: Connect is faster, needs no key handling, and can be switched to later with Switch to Stripe Connect.

Disconnect

Click Disconnect on the Stripe row. Online card payments stop immediately until you connect again; existing bookings and their payment records are kept.

Still stuck? Email [email protected] with your account name and we will sort it out.