SePay
API ngân hàng cho AI Agent
Claude, ChatGPT hay Claude Code đọc được giao dịch ngân hàng của doanh nghiệp, trong phạm vi bạn cho phép. Không cần mật khẩu ngân hàng. Bạn tự phân quyền dữ liệu cho AI và thu hồi bất cứ lúc nào.
Hoạt động với
ClaudeChatGPT
Claude Code
CodexGemini CLI
Cursor
- và ứng dụng khác hỗ trợ MCP
Cuối ngày rồi, chốt sổ giúp mình: hôm nay vào bao nhiêu tiền, có khoản nào cần mình kiểm tra lại không?
Mình chốt sổ hôm nay trên SePay ngay đây.
Loaded SePay
Used SePay: Liệt kê giao dịch
Hôm nay shop nhận 27 khoản, tổng 48.350.000 đ. Có 2 khoản bạn nên kiểm tra lại:
| Giờ | Số tiền | Nội dung chuyển khoản |
|---|---|---|
| 11:20 | 350.000 đ | chuyen tien |
| 14:05 | 500.000 đ | CK nhanh |
Hai khoản này không ghi mã đơn, bạn đối chiếu với các đơn đang chờ nhé.
sepay webhook listen --forward localhost:3000 --print✓ Listening for sandbox events → http://localhost:3000/ (Ctrl+C to stop · retries+enter to manage)
14:22:07 payment_in → http://localhost:3000/ 200 12ms txn=a41c9e02-7d3b-4c8e-9f21-6b0e5d4a3c17 wh=5f0e2a7b-91c4-4d6e-8a3f-2c7b9e1d0f45
{ "accountNumber": "…", "accumulated": 50000, "code": "DH1709", … }
Bạn dùng AI với SePay vào việc gì?
Chọn đúng vai của bạn để xem ví dụ.
Không biết code, vẫn tự làm được phần thanh toán
Nhiều chủ doanh nghiệp, quản lý giờ tự làm CRM, phần mềm bán hàng bằng cách nhắn việc cho AI. Phần thanh toán cũng vậy: nói bằng tiếng Việt, AI dùng SePay Skills và SePay CLI để tự làm, bạn không cần gõ lệnh. Trước khi bán hàng thật, hãy chạy thử trên sandbox và nhờ người rành kỹ thuật xem lại.
Tích hợp SePay để hóa đơn trong CRM tự xác nhận khi khách chuyển khoản
Đã dùng skill sepay
Đã chạy 2 lệnh
Đã tạo 2 tệp, sửa 1 tệp
Đã chạy sepay sandbox simulate payment_in
Xong rồi anh. Mình đã:
- Tạo tài khoản thử và webhook trên sandbox
- Làm trang thanh toán có mã QR cho từng hóa đơn
- Viết phần nhận webhook: xác thực, chống trùng, khớp mã hóa đơn
Chạy thử khách chuyển 8.500.000 đ, nội dung HD0068: hóa đơn đã tự chuyển sang Đã thanh toán. Trang đang mở bên phải.
8.500.000 đ


- Ngân hàng
- Vietcombank
- Số tài khoản
- •••• 3123
- Số tiền
- 8.500.000 đ
- Nội dung
HD0068
Đang chờ khách chuyển khoản…Đã thanh toán · hóa đơn tự cập nhật
Quét mã bằng app ngân hàng bất kỳ
Hỏi số liệu tiền vào, tiền ra như hỏi kế toán
Mở Claude hay ChatGPT lên hỏi như nhắn tin. AI lấy giao dịch từ SePay rồi trả lời bằng con số, bảng, biểu đồ.
- “Hôm nay tiền vào bao nhiêu?”
- “Doanh thu tháng này so với tháng trước thế nào?”
- “Năm nay mỗi tháng tiền vào, tiền ra bao nhiêu?”
- “Tuần này tiền vào so với tuần trước thế nào?”
SePay MCPKhông cần cài phần mềm, chỉ dán địa chỉ và Client ID
Kết nối AI với SePayHôm nay tiền vào bao nhiêu?
Used SePay: Liệt kê giao dịch
Hôm nay có 27 khoản tiền vào, tổng 48.350.000 đ.
Năm nay mỗi tháng tiền vào, tiền ra bao nhiêu?
Used SePay: Báo cáo dòng tiền
Từ tháng 1 đến hết tháng 10: tiền vào 4,41 tỷ, tiền ra 3,58 tỷ, chênh lệch +830 triệu. Tháng 9 thu cao nhất.
Tiền vào Tiền ra
Cần số liệu gì, hỏi là có
Không phải tải sao kê từng ngân hàng rồi ghép lại. Hỏi theo ngày, theo tài khoản, theo số tiền, AI tổng hợp sẵn.
- “Tháng 9 mỗi tài khoản nhận bao nhiêu tiền?”
- “Tuần này có giao dịch nào trên 10 triệu?”
- “Quý 3 tài khoản ảo của khách ABC nhận bao nhiêu?”
- “Làm giúp bảng thu từng ngày tháng này để vào sổ.”
- “Hôm nay có khoản nào cần kiểm tra lại không?”
SePay MCPKhông cần cài phần mềm, chỉ dán địa chỉ và Client ID
Kết nối AI với SePayTháng 9 mỗi tài khoản nhận bao nhiêu tiền?
Used SePay: Báo cáo dòng tiền
Used SePay: Liệt kê tài khoản ngân hàng
Used SePay: Liệt kê giao dịch
Tháng 9 tiền vào 612,4 triệu từ 1.284 giao dịch:
| Tài khoản | Giao dịch | Tiền vào |
|---|---|---|
| ACB ••1234 | 598 | 291,2 triệu |
| Vietcombank ••5678 | 419 | 198,5 triệu |
| BIDV ••9012 | 211 | 92,4 triệu |
| Tài khoản ảo BIDV | 56 | 30,3 triệu |
Bạn cần thì mình chép bảng này ra file Excel ngay trong cuộc trò chuyện.
Giao việc tích hợp cho AI, bạn chỉ cần duyệt
Cài SePay Skills rồi giao việc. AI tự dựng sandbox bằng SePay CLI, viết code, chạy thử xong mới đưa vào bán hàng. Khi hệ thống đã chạy, SePay MCP giúp bạn theo dõi.
- “Tích hợp SePay để website tự xác nhận đơn khi khách chuyển khoản.”
- “Giả lập khách chuyển thiếu tiền, xem code xử lý thế nào.”
- “Đưa cấu hình webhook lên production.”
SePay SkillsSePay CLISePay MCP
Xem SePay Skills- 1Cài SkillsSkills
claude plugin marketplace add sepayvn/sepay-skills && claude plugin install sepay@sepay - 2Cài CLI và đăng nhậpCLI
curl -fsSL https://get.sepay.vn/sepay-cli-install.sh | shSau đó chạy sepay login, bạn bấm xác nhận đăng nhập trên trình duyệt - 3Tạo sandbox và webhook thửCLI
sepay sandbox init --with-webhook-listen --yes - 4Viết tích hợpXác thực webhook, chống xử lý trùng, tách mã đơn, xử lý thiếu thừa tiềnSkills
- 5Chạy thửCLI
sepay webhook test --forward localhost:3000 --amount 50000 --expect-status 200✓ handler responded 200 in 12ms - 6Đưa vào bán hàngCLI
sepay webhook create --env production --url https://shop.vn/sepay --bank-mode allTrước khi ghi lên hệ thống đang chạy, CLI hỏi lại hoặc nhờ bạn tự gõ lệnh - 7Theo dõi hằng ngày“Hôm nay webhook gửi về có lỗi không?”MCP
AI Agent làm được gì với dữ liệu ngân hàng
Hỏi số liệu bằng tiếng Việt, hoặc nhờ AI viết code tích hợp. Bấm từng việc để xem.
Hỏi số liệuSePay MCP
Viết code tích hợpSePay SkillsSePay CLI
Tuần này tiền vào so với tuần trước thế nào?
Mình lấy báo cáo dòng tiền theo tuần.
Loaded SePay
Used SePay: Báo cáo dòng tiền
Tuần này tiền vào 121,9 triệu, tuần trước 98,7 triệu, tăng 24%. Thứ Sáu cao nhất với 31,4 triệu.
| Triệu đ | T2 | T3 | T4 | T5 | T6 | T7 | CN |
|---|---|---|---|---|---|---|---|
| Tuần này | 14,2 | 16,8 | 15,1 | 18,6 | 31,4 | 14,5 | 11,3 |
Hôm nay thu được bao nhiêu, so với hôm qua thế nào?
Mình tổng hợp giao dịch hôm nay trên SePay.
Loaded SePay
Used SePay: Liệt kê giao dịch
Hôm nay có 27 giao dịch tiền vào, tổng 48.350.000 đ. Hôm qua 43.120.000 đ, hôm nay tăng 12%.
| Hôm qua | Hôm nay | |
|---|---|---|
| Số giao dịch | 24 | 27 |
| Tiền vào | 43.120.000 đ | 48.350.000 đ |
| Khoản lớn nhất | 5.200.000 đ | 6.500.000 đ |
Liệt kê 5 giao dịch gần nhất trên 500.000 đ vào tài khoản ACB.
Mình lọc giao dịch tiền vào tài khoản ACB, số tiền trên 500.000 đ.
Loaded SePay
Used SePay: Liệt kê giao dịch
5 giao dịch gần nhất trên 500.000 đ vào tài khoản ACB:
| Giờ | Nội dung | Số tiền |
|---|---|---|
| 14:52 | DH00251 | 1.250.000 đ |
| 13:30 | DH00249 | 780.000 đ |
| 11:48 | DH00236 | 2.150.000 đ |
| 10:42 | DH00231 | 6.500.000 đ |
| 09:31 | DH00226 | 700.000 đ |
Hôm nay webhook gửi về hệ thống có lỗi không?
Mình xem báo cáo webhook hôm nay.
Loaded SePay
Used SePay: Báo cáo tình trạng webhook
Hôm nay gửi 312 lần, 309 thành công, 3 lần lỗi. Cả 3 lỗi cùng một endpoint, trả HTTP 500 từ 14:02 đến 14:10.
Bạn nên kiểm tra máy chủ nhận webhook trong khoảng thời gian đó.
Làm cổng thanh toán cho web bán hàng: khách chuyển khoản đúng mã đơn thì đơn tự xác nhận.
Mình làm theo SePay Skills nhé.
Loaded SePay Skills
Used SePay CLI: chạy thử trên sandbox
Xong. Mình đã:
- Làm trang thanh toán có mã QR, nội dung chuyển khoản là mã đơn
- Viết code nhận webhook: xác thực, chống xử lý trùng, khớp mã đơn
- Chạy thử trên sandbox: đơn DH00068 tự chuyển sang Đã thanh toán
Thêm nút tạo link thanh toán cho từng hóa đơn để gửi khách qua Zalo.
Mình thêm nút gửi link thanh toán theo SePay Skills.
Loaded SePay Skills
Used SePay CLI: tạo trang thanh toán thử
Đã thêm nút Gửi link thanh toán ở mỗi hóa đơn. Khách bấm link, quét QR là trả được; trả xong hóa đơn tự chuyển sang Đã thu.
Thử với hóa đơn HD-0068, 8.500.000 đ: chạy đúng.
Thêm tính năng nạp tiền vào ví, mỗi khách một mã nạp riêng.
Mình làm phần nạp ví theo SePay Skills.
Loaded SePay Skills
Used SePay CLI: giả lập khách nạp tiền
Đã xong phần nạp ví:
- Mỗi khách có một mã nạp riêng, hiện kèm mã QR trên trang Nạp tiền
- Tiền về là cộng đúng ví, có lịch sử nạp
- Webhook gửi lại không bị cộng tiền hai lần
Mỗi ngày lấy tiền vào, tiền ra từ SePay đưa vào CRM, làm thêm trang dòng tiền theo tháng.
Mình nối SePay vào CRM.
Loaded SePay Skills
Used SePay API: lấy giao dịch hằng ngày
Đã đặt lịch đồng bộ lúc 23:00 mỗi ngày và thêm trang Dòng tiền trong CRM. Số tháng 10 sau lần đồng bộ đầu:
| Tháng 10 | Tiền vào | Tiền ra | Chênh lệch |
|---|---|---|---|
| Đến 21/10 | 412,6 triệu | 305,1 triệu | +107,5 triệu |
Khách thanh toán xong thì tự xuất hóa đơn điện tử và gửi email cho khách.
Mình nối thanh toán với hóa đơn điện tử SePay.
Loaded SePay Skills
Used SePay CLI: einvoice
Xong. Khi SePay báo đơn đã thanh toán, hệ thống tự xuất hóa đơn điện tử qua SePay eInvoice và gửi email cho khách.
Thử trên sandbox với đơn DH00068: hóa đơn đã xuất, email đã gửi.
AI Agent không cần kết nối từng ngân hàng, đã có SePay
Thay vì kết nối với từng ngân hàng, AI chỉ cần kết nối với SePay. SePay đã kết nối sẵn với 13 ngân hàng và NAPAS, đồng thời lo phần phân quyền và lưu lại mọi lần truy cập.
AI của doanh nghiệp
ClaudeChatGPT
Claude CodeCursor
- Phần mềm bạn tự làm
SePay
- Định danhBiết AI nào đang làm việc cho doanh nghiệp nào
- Phân quyềnAI chỉ truy cập phần bạn cho phép, thu hồi quyền lúc nào cũng được
- Xác nhận tiềnTiền về chưa, đúng đơn không, đủ tiền không
- Lưu dấu vếtAI nào, của ai, đọc gì, lúc mấy giờ
Ngân hàng
Đủ công cụ để AI làm việc với SePay
Lập trình viên thường dùng theo thứ tự: Skills để viết code, CLI để chạy thử, MCP để theo dõi khi đã bán hàng. Dùng một cái cũng được.
-
1Viết code
SePay Skills
Cho lập trình viên
AI viết code tích hợp SePay đúng ngay từ đầu.
- Xác thực webhook, chống xử lý trùng giao dịch
- Tách mã đơn từ nội dung chuyển khoản
- Dùng với Claude Code, Codex, Cursor và ứng dụng chat ChatGPT, Claude, Gemini, Grok
-
2Chạy thử
SePay CLI
Cho lập trình viên
Chạy thử cả quy trình thanh toán ngay trên máy, không tốn đồng nào.
- Nhận webhook về máy, không cần địa chỉ công khai
- Giả lập khách chuyển khoản, kể cả thiếu hoặc thừa tiền
- Trả kết quả dạng bảng hoặc JSON để AI đọc
-
3Theo dõi
SePay MCP
Cho chủ doanh nghiệp, kế toán
Hỏi AI về giao dịch, dòng tiền bằng tiếng Việt.
- Dùng ngay trong Claude, ChatGPT
- Mặc định chỉ đọc. Thao tác ghi chỉ chạy khi bạn cấp quyền và xác nhận từng lần.
- Cấp quyền theo từng nhóm dữ liệu
- Không cần cài phần mềm, chỉ dán địa chỉ và Client ID
AI cũng đọc được tài liệu của SePay: developer.sepay.vn/llms.txt và bản Markdown cho từng trang.
Bạn cho phép đến đâu, AI làm đến đó
Bạn quyết định AI được xem dữ liệu nào, phần nào được phân quyền. Thu hồi quyền lúc nào cũng được.
- Không đăng nhập ngân hàng thay bạnSePay kết nối API thẳng với ngân hàng, không cần mật khẩu Internet Banking của bạn.
- Không chuyển tiền, không đổi cài đặtMặc định chỉ đọc. Thao tác ghi chỉ chạy khi bạn cấp quyền và xác nhận từng lần.
- Không đọc quá phần bạn choChọn từng nhóm dữ liệu; giấu được tiền ra, nội dung chuyển khoản, mã tham chiếu, số tài khoản.
- Nhân viên phải được cấp quyềnNhân viên cần SuperAdmin hoặc Admin cấp quyền “Cho phép kết nối AI qua MCP” mới kết nối được.
- Thu hồi là dừng ngayBấm Thu hồi ở trang AI Agent trên my.sepay.vn là AI hết quyền. Nhật ký hoạt động lưu 90 ngày.
Kết nối API trực tiếp với ngân hàng13 ngân hàng và NAPAS, hợp tác chính thức với từng ngân hàng.
SePay chỉ gửi những nhóm dữ liệu bạn cho phép. Sau đó dữ liệu được ứng dụng AI bạn chọn xử lý theo chính sách của bên đó.
Câu hỏi thường gặp
Không thấy câu bạn cần? Liên hệ SePay.
AI Agent là gì?
AI Agent là AI tự làm việc theo lời bạn dặn: tra cứu, tổng hợp số liệu, viết code. Ví dụ Claude, ChatGPT, hoặc Claude Code, Cursor cho việc lập trình. SePay cung cấp công cụ để các AI này làm việc được với dữ liệu và API của SePay (xem thêm trên Wikipedia).
Kết nối ChatGPT, Claude với ngân hàng thế nào?
Qua SePay MCP, vào my.sepay.vn → AI Agent → Tạo kết nối, chọn ChatGPT hoặc Claude rồi làm theo hướng dẫn: chép địa chỉ máy chủ và Client ID vào ứng dụng, đăng nhập SePay, chọn nhóm dữ liệu AI được đọc. Sau đó hỏi bằng tiếng Việt như nhắn tin.
Tôi không rành kỹ thuật, có dùng được không?
Được. Chủ doanh nghiệp và kế toán dùng SePay MCP: vào my.sepay.vn → AI Agent → Tạo kết nối, chép địa chỉ máy chủ và Client ID vào Claude hoặc ChatGPT, đăng nhập SePay, rồi hỏi bằng tiếng Việt. Không cần cài phần mềm. Nếu bạn là Người dùng bình thường, nhờ SuperAdmin hoặc Admin bật quyền “Cho phép kết nối AI qua MCP” trước.
Sao không cho AI kết nối thẳng với ngân hàng?
SePay đã kết nối chính thức với từng ngân hàng, nên AI chỉ cần kết nối với SePay một lần là dùng được với mọi tài khoản bạn đã liên kết. Quyền truy cập, xác nhận tiền và lịch sử truy cập nằm một chỗ để bạn dễ kiểm soát.
AI có chuyển tiền hay sửa dữ liệu của tôi được không?
SePay MCP không chuyển tiền, không đổi cài đặt. Mặc định chỉ đọc. Thao tác ghi chỉ chạy khi bạn cấp quyền và xác nhận từng lần. SePay CLI dành cho lập trình viên nên sửa được dữ liệu trong phạm vi được cấp, nhưng mặc định chạy trên sandbox. Trên production, lệnh thay đổi dữ liệu phải ghi rõ --env production, và AI chỉ chạy tiếp bằng --yes khi lệnh nêu đúng mã của một tài nguyên; còn lại CLI dừng và nhờ bạn tự gõ lệnh.
Dữ liệu của tôi được xử lý thế nào?
SePay chỉ gửi những nhóm dữ liệu bạn cho phép. Sau đó dữ liệu được ứng dụng AI bạn chọn xử lý theo chính sách của bên đó. Bạn thu hồi quyền lúc nào cũng được trên my.sepay.vn.
MCP, CLI và Skills khác nhau thế nào?
MCP để hỏi số liệu SePay ngay trong ứng dụng AI. CLI để chạy lệnh và thử tích hợp trên sandbox. Skills là bộ hướng dẫn để AI viết code tích hợp SePay cho đúng. Dùng riêng hay dùng chung đều được.
Tôi nên bắt đầu từ đâu?
Nếu bạn là chủ doanh nghiệp hoặc kế toán, bắt đầu với SePay MCP. Nếu bạn đang viết tích hợp thanh toán, hay không biết code nhưng đang nhờ AI làm phần mềm (vibe coding), bắt đầu với SePay Skills rồi chạy thử bằng SePay CLI.
Cho AI Agent đọc dữ liệu ngân hàng qua SePay
Cần số liệu thì bắt đầu với SePay MCP.
Cần làm tích hợp thì bắt đầu với SePay Skills.


