Bài toán
Shop nhỏ và lập trình viên muốn nhận tiền chuyển khoản tự động thường phải chọn một dịch vụ báo có, tích hợp riêng từng bên, tự khớp tiền với đơn và tự lo khi một giao dịch bị báo hai lần. S Pay gom phần đó về một chỗ: tiền vẫn vào thẳng tài khoản ngân hàng của người bán, S Pay chỉ đọc báo có, khớp với đơn và báo về ứng dụng.
Giải pháp
- Nhiều nguồn báo có: GPMPay, ApiPay, SePay, Casso, payOS và webhook ngân hàng trực tiếp (ACB, MB). Mỗi nguồn xác thực theo cách riêng (chữ ký, API key, HMAC); giao dịch trùng giữa các nguồn được gộp lại.
- QR theo đơn + khớp tự động: tạo VietQR có nội dung riêng cho từng đơn, tiền về là đơn chuyển "Đã thanh toán", ứng dụng nhận webhook ký HMAC (có gửi lại khi lỗi).
- Định tuyến tài khoản nhận theo kênh (quầy / online) — S Store dùng để tách tiền quầy và tiền đơn online.
- Cho lập trình viên: API v2 có header Deprecation, sandbox, OAuth "Kết nối S Payment" cho ứng dụng bên thứ ba, SDK .NET / Go, tài liệu
/llms.txtvà nút "Sao chép prompt cho AI".
Trợ lý kết nối — trạm trình duyệt
Một số đối tác không có API tạo khoá, phải đăng nhập trang web rồi bấm qua nhiều bước. S Pay chạy một trạm trình duyệt (Node + Playwright, Chromium theo phiên) và một agent Claude Haiku dẫn đường theo sổ tay của từng đối tác:
- Người dùng chọn đối tác trong popup "Thiết lập nhận tiền"; ngân hàng trước, rồi GPMPay / ApiPay chạy lần lượt.
- Mật khẩu và OTP nhập trong form của S Pay, trạm điền vào trang đối tác và không lưu lại; màn hình đối tác chỉ hiện khi cần dự phòng.
- Agent chỉ thao tác trong hộp thoại đang mở; gặp câu hỏi thì hỏi lại người dùng. Lấy được khoá thì S Pay tự nối nguồn.
- Nguyên tắc: mỗi chủ thể một tài khoản ở mỗi đối tác — không tạo thêm tài khoản để lách gói miễn phí.
Trợ lý chat
Khung chat góc phải console trả lời từ dữ liệu của chính workspace: 12 tool chỉ đọc, chạy theo quyền portal của người hỏi, thẻ đề xuất kết nối khi chưa có nguồn. Hạn mức 25 câu + 300k token mỗi workspace / ngày, 5 vòng tool, tối đa 45 giây / câu. Người dùng phải đồng ý gửi dữ liệu tới nhà cung cấp model trước khi chat; chủ workspace tắt được trợ lý.
Mở cho người ngoài
- Đăng ký bằng email (link ký HMAC, hết hạn 60 phút) hoặc Google (PKCE, chỉ email đã xác minh); bắt buộc bật 2FA.
- Gói Free 50 giao dịch được khớp mỗi tháng; trang Điều khoản và Chính sách quyền riêng tư có phiên bản.
- Trang giới thiệu viết bằng Three.js: ~11 000 hạt (4 200 trên điện thoại) hội tụ thành tia sét logo, 9 cảnh theo cuộn — nguồn, gộp, QR, chia tải, trợ lý, API / webhook, an toàn, giá, kết.
Công nghệ
| Công nghệ | Dùng để làm gì |
|---|---|
| .NET 10 + EF Core + PostgreSQL | API, khớp giao dịch, webhook, báo cáo tiền về; migration tự chạy khi khởi động |
| Vue 3 + Naive UI + Pinia + Vite | Console vận hành và portal người dùng (multi-page: portal + trang giới thiệu) |
| Three.js 0.160 | Trang giới thiệu: 2 lớp Points + shader, bố cục tính sẵn rồi nội suy theo cuộn, nạp sau khi trang đã vẽ |
| Node 22 + Playwright | Trạm trình duyệt cho trợ lý kết nối, chạy riêng trong cụm |
| Claude (qua MotKey) | Agent dẫn trạm trình duyệt và trợ lý chat; khoá ảo riêng có trần chi theo ngày / tháng |
| HMAC · OAuth 2.0 · TOTP | Ký webhook, link đăng ký; đăng nhập Google; 2FA |
| Kubernetes + ArgoCD | Deploy qua repo gitops, merge là lên prod |
Kết quả
Đang chạy cho S Store (QR quầy + online) và ví credit VND của MotKey. Từ 18/11/2026 mở đăng ký cho mọi người; luồng kết nối GPMPay qua trợ lý đã chạy trọn với tài khoản ngân hàng thật.
Điểm nổi bật
Gộp báo có từ nhiều nguồn: GPMPay, ApiPay, SePay, Casso, payOS và webhook ngân hàng trực tiếp ACB / MB; mỗi nguồn xác thực theo cách riêng, giao dịch trùng giữa các nguồn được gộp lại.
QR VietQR theo đơn, khớp tiền ↔ đơn tự động, webhook ký HMAC có gửi lại; API v2 + sandbox + SDK .NET / Go; tài liệu /llms.txt và nút "Sao chép prompt cho AI" để lập trình viên dán vào trợ lý code.
Trợ lý kết nối: trạm trình duyệt Playwright mở trang đối tác, người dùng nhập mật khẩu / OTP ngay trong form S Pay (không lưu), agent điền hộ phần còn lại rồi tự nối nguồn; popup "Thiết lập nhận tiền" chạy lần lượt từng đối tác.
Trợ lý chat trong console: 12 tool chỉ đọc theo quyền của người dùng, hạn mức câu hỏi / token theo workspace, phải bấm đồng ý gửi dữ liệu trước khi dùng, chủ workspace tắt được.
Mở cho người ngoài: đăng ký bằng email (link ký HMAC) hoặc Google (PKCE), bắt bật 2FA, trang Điều khoản / Quyền riêng tư; trang giới thiệu Three.js 9 cảnh — bụi sao hội tụ thành logo, cuộn tới đâu kể tới đó.
