Руководства

Платежи

Настройка и управление платежами — приём оплаты при записи, возвраты и просмотр транзакций.

Обзор

Bronjoy позволяет принимать оплату в момент записи клиента — платежи обрабатываются через Stripe Checkout: клиент переходит на платёжную страницу Stripe, а всё остальное Bronjoy делает автоматически через вебхуки. Собственный аккаунт Stripe вам не нужен — достаточно включить платежи и задать свою политику.

Как это включить, описано в разделе Интеграция Stripe.

Настройки платежей

Каждая организация задаёт собственную политику оплаты: обязательна ли оплата, депозит или полная сумма, правила возврата и напоминания.

Посмотреть текущие настройки

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
}

Полное описание полей смотрите в разделе Интеграция Stripe.

Включить или выключить платежи

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

Как работают платежи

В момент записи

Когда клиент записывается на услугу, требующую оплаты:

Клиент выбирает услугу и слот
Клиент отправляет запись
Bronjoy создаёт запись в статусе Pending
Создаётся Stripe Checkout Session
Клиент перенаправляется в Stripe для оплаты
После оплаты Stripe отправляет вебхук
Bronjoy подтверждает запись и сохраняет транзакцию

Типы оплаты

Тип	Как это работает
Полная оплата	Клиент оплачивает полную стоимость услуги при записи
Депозит	Клиент вносит фиксированный депозит; остаток оплачивается на приёме

Настраивается для каждой услуги:

prepay_required: true — включает оплату при записи
prepay_amount: 50000 — сумма депозита (не указывайте для полной оплаты)

Статусы платежа

Статус	Значение
`Pending`	Платёж инициирован, ожидается действие клиента
`Completed`	Платёж получен
`Cancelled`	Сессия оплаты истекла или платёж не прошёл
`Refunded`	Платёж возвращён сотрудником

Управление транзакциями

Просмотр транзакций

GET /api/org/transactions
Authorization: Bearer your-owner-token

Фильтрация по дате, статусу или услуге:

GET /api/org/transactions?start_date=2026-03-01&end_date=2026-03-31&status=completed

Сводка по транзакциям

GET /api/org/transactions/summary

Возвращает суммы по завершённым, возвращённым и ожидающим транзакциям за указанный период.

Экспорт данных

GET /api/org/transactions/export?start_date=2026-03-01&end_date=2026-03-31

Возвраты

Оформить возврат по завершённой транзакции:

POST /api/org/payments/{transaction}/refund
Authorization: Bearer your-owner-token

Возврат обрабатывается через Stripe. Статус транзакции меняется на Refunded, а клиент получает уведомление.

Когда возвращать деньги

Клиент отменил запись в рамках политики — если срок отмены ещё не истёк, верните полную сумму
Услуга не оказана — верните деньги сами, не дожидаясь просьбы: это сохраняет доверие
Частичное недовольство — рассмотрите частичный возврат (оформляется напрямую в Stripe Dashboard)

Платежи со стороны клиента

Клиенты работают с платежами через эти эндпоинты:

# Check if payment is required
GET /api/client/payments/appointments/{appointment}/requirement

# Initiate payment
POST /api/client/payments/appointments/{appointment}/pay

# View payment history
GET /api/client/payments/appointments/{appointment}/transactions

# Check transaction status
GET /api/client/payments/transactions/{transaction}