To'lovlar

Umumiy ma'lumot

Bronjoy mijozlar qabulga yozilayotganda to'lovlarni qabul qilishni qo'llab-quvvatlaydi; to'lovlar Stripe Checkout orqali amalga oshiriladi — mijozlar Stripe'ning to'lov sahifasiga yo'naltiriladi, qolgan hamma narsani esa Bronjoy webhook'lar orqali avtomatik bajaradi. Sizga o'zingizning Stripe hisobingiz kerak emas; shunchaki to'lovlarni yoqasiz va o'z qoidangizni belgilaysiz.

Buni qanday yoqish haqida Stripe integratsiyasi bo'limiga qarang.

To'lov sozlamalari

Har bir tashkilot o'z to'lov qoidasini belgilaydi — to'lov majburiymi, depozitmi yoki to'liq to'lovmi, pulni qaytarish tartibi va eslatmalar.

Joriy sozlamalarni ko'rish

GET /api/org/payment-settings
Authorization: Bearer your-owner-token
X-Organization-ID: 1

Qoidangizni yangilash

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
}

Maydonlarning to'liq tavsifi uchun Stripe integratsiyasi bo'limiga qarang.

To'lovlarni yoqish/o'chirish

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

To'lovlar qanday ishlaydi

Yozilish paytida

Mijoz to'lov talab qilinadigan xizmatga yozilganda:

1. Mijoz xizmat va vaqt oralig'ini tanlaydi
2. Mijoz yozilishni yuboradi
3. Bronjoy qabulni Pending holatida yaratadi
4. Stripe Checkout Session yaratiladi
5. Mijoz to'lov uchun Stripe'ga yo'naltiriladi
6. To'lovdan so'ng Stripe webhook yuboradi
7. Bronjoy qabulni tasdiqlaydi va tranzaksiyani yozib qo'yadi

To'lov turlari

Har bir xizmat uchun sozlanadi:

• prepay_required: true — yozilish paytida to'lovni yoqadi
• prepay_amount: 50000 — depozit summasi (to'liq to'lov uchun ko'rsatilmaydi)

To'lov holatlari

Tranzaksiyalarni boshqarish

Tranzaksiyalarni ko'rish

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

Sana, holat yoki xizmat bo'yicha filtrlash:

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

Tranzaksiyalar xulosasi

GET /api/org/transactions/summary

Berilgan davr uchun yakunlangan, qaytarilgan va kutilayotgan tranzaksiyalar bo'yicha umumiy summalarni qaytaradi.

Ma'lumotlarni eksport qilish

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

Pulni qaytarish

Yakunlangan tranzaksiya bo'yicha pulni qaytarish:

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

Pul Stripe orqali qaytariladi. Tranzaksiya holati Refunded ga o'zgaradi va mijozga xabar beriladi.

Qachon pul qaytariladi

• Mijoz qoida doirasida bekor qilsa — bekor qilish muddati o'tmagan bo'lsa, to'liq summani qaytaring
• Xizmat ko'rsatilmagan bo'lsa — ishonchni saqlash uchun o'zingiz tashabbus bilan qaytaring
• Qisman norozilik — qisman qaytarishni ko'rib chiqing (to'g'ridan-to'g'ri Stripe Dashboard'da bajariladi)

Mijoz tomonidan to'lov

Mijozlar to'lovlar bilan quyidagi endpoint'lar orqali ishlaydi:

# 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}

Yaxshi amaliyotlar

• Avval Stripe test rejimida sinab ko'ring — ishonch hosil qilguningizcha pk_test_ / sk_test_ kalitlaridan foydalaning
• Depozit summasini oqilona belgilang — juda yuqori summa yozilishlarni kamaytiradi, juda past summa esa kelmaslikdan himoya qilmaydi. Odatda xizmat narxining 20–50% qismi olinadi
• To'lovni faqat kelmaslik ko'p bo'ladigan xizmatlar uchun yoqing — har bir xizmat oldindan to'lovni talab qilmaydi. Uni kelmaslik sizga vaqt va pul yo'qotishiga sabab bo'ladigan xizmatlar uchun tanlab yoqing
• Tranzaksiyalarni har hafta ko'rib chiqing — amalga oshmagan to'lovlar va muddati tugagan sessiyalarni erta aniqlang
• Pulni tezda qaytaring — kechiktirilgan qaytarishlar chargeback'larga olib keladi va ishonchni yo'qotadi
• Click.uz yoki Payme.uz'ni sozlamang — bu to'lov provayderlari yuridik shaxs ro'yxatdan o'tkazilgunicha to'xtatib qo'yilgan