Stripe Integration Setup

HiLucy uses Stripe as its payment processor. This guide covers the initial setup and configuration.

What Stripe Handles

• Checkout payments — Guests pay for bookings via Stripe
• Security deposits — Authorize-then-void verification (no fee charged to guest)
• Card-on-file — Save guest payment methods for future charges
• Damage charges — Charge the guest's card if damage occurs
• Refunds — Process full or partial refunds

Setup Steps

1. Create a Stripe Account

If you don't have one, visit stripe.com and create an account. Complete the business verification process.

2. Connect Stripe to HiLucy

In your HiLucy admin dashboard:

1. Go to Settings → Payments
2. Click Connect Stripe
3. Authorize HiLucy to access your Stripe account

3. Configure Payment Settings

Once connected, configure:

• Currency — Your default currency
• Security deposit amount — Per-product deposit amount
• Payment methods — Card types you accept

How Payments Work

When a guest checks out on your site:

1. Guest enters payment details on the checkout page
2. Stripe processes the payment securely
3. If the product has a security deposit, an authorize-then-void hold is placed
4. The guest's card is saved on file for future charges
5. Order confirmation is sent automatically

Security Deposit System

HiLucy's deposit system uses authorize-then-void — we authorize a temporary hold on the guest's card, then immediately void it. This:

• Verifies the card is valid and has sufficient funds
• Charges zero fees to the guest (the authorization is voided, not captured)
• Saves the card on file for potential damage charges

See Security Deposits for full details.