Payment — Kiến trúc & dữ liệu

Checkout flow chung

Method-specific flows

Method	Flow
PayLater	Validate availability, persist pending/selected option, cho flow booking/subscription tiếp tục.
PayNow/Windcave	Init checkout, redirect customer, nhận result/webhook, chống retry duplicate.
Direct Debit/Kiwi	Tạo hoặc đọc payment customer theo account+BU+provider, tạo batch debit, xử lý provider status.
Deposit	Kiểm tra eligibility toàn batch, snapshot amount/percentage, lock order, provider checkout, webhook confirm.

Guardrails

• Mọi access tới AccountPaymentCustomer phải scope theo BU; cross-BU là lỗi bảo mật.
• Provider webhook/result phải idempotent vì provider có thể gọi lại nhiều lần.
• Master toggle/payment settings phải được kiểm tra trước khi expose method ở UI.
• Deposit eligibility phải fail cả batch nếu một booking không đủ điều kiện.
• Controller chỉ orchestration; logic nghiệp vụ nằm ở service/domain boundary.

Dữ liệu chính

Nhóm	Dữ liệu
Customer token	AccountPaymentCustomer theo account, BU, provider.
Payment batch	DirectPaymentBatch, DirectPayment, status/error/provider reference.
Checkout lock	Booking/order lock hoặc deposit snapshot để chống double submit.
Settings	BU/provider settings, method toggle, category availability.
Provider callbacks	Result URL, notification URL, webhook payload/error.