Payment and Financial Data Systems
Mental model
Payment systems là nơi API design, workflow orchestration, ML decisioning và data governance gặp nhau. Một checkout thành công không chỉ là “charge tiền”, mà là chuỗi trạng thái bền vững qua client, merchant backend, PSP, webhook, fraud model, ledger và downstream reporting.
Các lớp chính
| Lớp | Concept | Vai trò |
|---|---|---|
| Payment API | Payment Intent, Payment Method, Payment State Machine | Tách “what” của giao dịch khỏi “how” của phương thức thanh toán |
| Local expansion | Local Payment Method, Payment Service Provider, Payment Orchestration | Chuẩn hóa redirect, async flow, QR, PSP plugin và config-driven UI |
| Risk decisioning | Fraud Detection System, Precision-Recall Tradeoff | Chấm điểm giao dịch trong latency thấp nhưng vẫn cho merchant điều chỉnh threshold |
| Financial data | Financial Source of Truth, Data Contract, Shadow Testing, Data Freshness | Giữ số liệu tài chính nhất quán, đúng hạn và có thể kiểm chứng |
Bài học thiết kế
- Abstraction đúng quan trọng hơn số lượng endpoint ít.
Chargeđơn giản cho thẻ, nhưng Payment Intent phù hợp hơn khi payment method có trạng thái bất đồng bộ. - Payment flow cần resilient với client disconnect; trạng thái bền vững và Webhook giúp fulfillment không phụ thuộc vào một request.
- Local payment method nên được tích hợp bằng plugin/config, không hardcode mỗi thị trường trong UI và backend.
- Fraud model phải được deploy như một production system: feature latency, model drift, merchant-level impact và explainability đều là phần của kiến trúc.
- Financial data nên có một nguồn tin cậy trung tâm khi sai lệch định nghĩa có thể ảnh hưởng reconciliation hoặc ledger.