Bronjoy
Integrations

Stripe

Enable card payments for your organization and configure your prepay policy.

Overview

Bronjoy processes card payments through Stripe Checkout on your behalf — there's no Stripe account for you to create or connect. You just turn payments on for your organization and set your policy: whether to require a deposit or full payment, and how refunds and reminders behave.

Enabling Payments

GET /api/org/payment-settings
Authorization: Bearer your-owner-token
X-Organization-ID: 1
POST /api/org/payment-settings
Authorization: Bearer your-owner-token
X-Organization-ID: 1
Content-Type: application/json
{
  "provider": "stripe",
  "is_enabled": true,
  "prepay_policy": "partial",
  "prepay_percentage": 30,
  "refund_on_cancellation": true,
  "refund_deadline_hours": 24,
  "auto_remind_unpaid": true,
  "remind_after_minutes": 60
}
FieldDescription
providerstripe (Click, Payme, and Uzum exist but are not yet open — see Payments)
is_enabledTurn payment collection on or off for this organization
prepay_policynone, partial (deposit), or full
prepay_percentageDeposit percentage of the service price, required when prepay_policy is partial
refund_on_cancellationAutomatically refund when a paid appointment is cancelled within the window
refund_deadline_hoursHow many hours before the appointment refunds are still automatic
auto_remind_unpaidSend a reminder for unpaid pending bookings
remind_after_minutesDelay before the first unpaid-booking reminder

Toggle it off without losing your configuration:

POST /api/org/payment-settings/{paymentSetting}/toggle

Per-Service Overrides

Payment behavior can also be set per service — see Services & Scheduling for prepay_required and prepay_amount on individual services.

How It Works

  1. Client books a service that requires payment
  2. Bronjoy creates the appointment in Pending status
  3. A Stripe Checkout Session is created for the required amount
  4. Client is redirected to Stripe's hosted checkout page
  5. Stripe notifies Bronjoy once payment completes
  6. Bronjoy confirms the appointment and records the transaction

See Webhooks for the event details, and Payments for managing transactions and refunds day-to-day.

Copyright © 2026