Sổ Cái Ví

Số dư ví được theo dõi bằng các cột trên wallet và các ledger entry.

Trường Ví

Field	Ý nghĩa
available_balance_cents	Số dư có thể chi tiêu hoặc rút
pending_balance_cents	Top-up chuyển khoản ngân hàng đang chờ xử lý

Loại Ledger

Type	Direction	Mô tả
topup	credit	Nạp ví
guest_post_order	debit	Advertiser trả tiền cho guest post order
guest_post_payout	credit	Publisher nhận payout sau khi duyệt
agency_service_order	debit	Buyer đặt mua dịch vụ Agency
agency_service_payout	credit	Agency nhận payout sau khi buyer/admin duyệt

Idempotency

Payment và payout ledger dùng idempotency_key để tránh ghi trùng chuyển động tiền.

Ghi Chú VND

Hệ thống hiện còn nhiều trường amount_cents theo USD. Khi chuyển VND thành mặc định production, nên refactor sang mô hình:

amount_minor + currency

Với VND, amount_minor là số tiền VND nguyên, không có cents.