AI agent với SePay

Dùng SePay trong AI agent của bạn. Tra cứu giao dịch qua MCP trong ChatGPT, Claude, cài SePay Skills cho agent lập trình, dùng SePay CLI để thử webhook và tự động tra cứu.

||

AI agent như Claude Code, Codex, Cursor hay ChatGPT làm việc với SePay qua SePay MCP, SePay Skills và SePay CLI. Các công cụ này phục vụ lúc phát triển và tra cứu; ứng dụng của bạn vẫn gọi SePay API và nhận SePay Webhooks như bình thường.

Chọn SePay MCP, Skills hay CLI

Chọn theo việc bạn muốn agent làm: tra dữ liệu, viết code hay thử tích hợp. Bạn không phải chọn một trong ba: dùng riêng từng công cụ, kết hợp hai, hoặc cả ba tùy nhu cầu, ví dụ Skills để agent viết code và CLI để thử webhook ngay trên máy.

Tra dữ liệu tài khoản với SePay MCP

Chẳng hạn bạn muốn xem dòng tiền từng tháng, hay biết đơn DH00012 đã được thanh toán chưa, mà không phải mở my.sepay.vn để tìm.

Bạn có thể dùng SePay MCP để hỏi Claude hoặc ChatGPT bằng câu thường và nhận câu trả lời lấy từ chính tài khoản SePay của bạn. Đang viết code trong Claude Code hay Codex, agent cũng tra được dữ liệu như "Tuần này có webhook nào gửi thất bại không?". Khi bạn hỏi cách tích hợp, agent tra thẳng tài liệu SePay, phần này không cần đăng nhập. Agent tự chọn dữ liệu cần đọc, trong phạm vi quyền bạn đã cấp.

Cùng một kết nối dùng được trong ứng dụng chat và agent lập trình:

Báo cáo dòng tiền theo từng tháng của tôi trên SePay
Đã gọi get_cashflow_report

Từ tháng 07 trở đi chưa có phát sinh. Tháng cao điểm là tháng 05 (vào 15.983.000); thấp nhất là tháng 06 (vào 13.177.000).

Tổng tiền vào
89.652.000
Tổng tiền ra
7.120.000
Ròng
82.532.000
Tiền vàoTiền ra
16 tr12 tr8 tr4 tr0 tr
T1T2T3T4T5T6

Kết nối Claude, ChatGPT, Claude Code hoặc Codex với tài khoản SePay của bạn.

Kết nối SePay MCP

Hỏi cách tích hợp SePay với SePay Skills

Chẳng hạn bạn muốn website tự xác nhận đơn hàng khi khách chuyển khoản, nhưng chưa rõ bắt đầu từ đâu và làm sao cho đúng.

Thêm SePay Skills vào ChatGPT hoặc Claude, rồi hỏi như hỏi nhân viên hỗ trợ: AI chỉ bạn nên cài plugin hay tự tích hợp, hướng dẫn từng bước trên my.sepay.vn theo đúng tên nút, giải thích webhook bằng lời thường.

ClaudeChatGPTGeminiGrok…và agent lập trình như Claude Code, Codex, CursorỨng dụng nhận sepay.zip

Minh họa ba bước: tải tệp sepay.zip chính thức của SePay, vào Cài đặt › Skills của ứng dụng chat AI, kéo thả sepay.zip vào khung tải lên, ứng dụng tự bật skill sepay, rồi hỏi cách xác thực thanh toán tự động cho cửa hàng.

Cách thêm tệp vào từng ứng dụng xem ở Cài SePay Skills vào ứng dụng chat AI.

Lập trình viên cài được skill vào agent lập trình như Claude Code, Codex, Cursor và các agent khác hỗ trợ skill. Khi bạn nhờ tích hợp SePay, agent viết code theo đúng tài liệu SePay và các quy tắc an toàn: mặc định dùng sandbox, giữ secret key ở server, kiểm tra chữ ký webhook, mỗi giao dịch chỉ xử lý một lần.

Cài skill SePay cho agent lập trình bạn đang dùng.

Cài cho agent lập trình

Thử tích hợp và tra cứu với SePay CLI

Chẳng hạn bạn đang tích hợp webhook trên máy tính, code nhận webhook chạy ở localhost:3000, và muốn thử ngay mà không phải đưa code lên server hay chờ khách chuyển khoản thật.

Bạn có thể dùng SePay CLI: terminal 1 nhận webhook về máy, terminal 2 giả lập một giao dịch tiền vào 50.000 đ có mã đơn DH1709 (--bank-account là mã tài khoản ngân hàng sandbox, xem bằng sepay bank-account list). Webhook của giao dịch tới code của bạn, terminal 1 in mã HTTP mà code trả về:

Terminal 1: nhận webhook
$ sepay webhook listen --forward localhost:3000env: sandbox  Delivering for every bank account of this company.✓ 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-xxxx-xxxx-xxxx-fa163e2f7c98   wh=5f0e2a7b-xxxx-xxxx-xxxx-3c9d81e04b6a
Terminal 2: giả lập giao dịch
$ sepay sandbox simulate payment_in --bank-account 8f3c2a10-xxxx-xxxx-xxxx-0c4e7b9d2f61 --amount 50000 --code DH1709env: sandboxSimulated payment_in event.a41c9e02-xxxx-xxxx-xxxx-fa163e2f7c98

Trên production, bạn dùng cùng bộ lệnh để tra cứu giao dịch, tạo và sửa webhook, cấu hình mã thanh toán, cập nhật tài khoản ngân hàng mà không cần mở my.sepay.vn. Ví dụ, tìm giao dịch có mã đơn DH1709:

$ sepay transaction list --env production --search DH1709 --json[  {    "id": "07ad3dc9-xxxx-xxxx-xxxx-0afffe87053b",    "transaction_date": "2026-10-31 11:24:40",    "transfer_type": "in",    "amount_in": 50000,    "transaction_content": "DH1709 thanh toan don hang",    "code": "DH1709",    "bank_brand_name": "ACB",    ...  }]

Cài CLI và nhận webhook đầu tiên trên máy của bạn.

Cài SePay CLI

Giới hạn và an toàn

SePay MCP: 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. Agent chỉ thấy phần dữ liệu bạn cấp quyền khi kết nối. Bạn đổi hoặc thu hồi quyền bất cứ lúc nào trên trang AI Agent (chi tiết).

Với SePay CLI, mọi lệnh sửa dữ liệu trên production chỉ chạy khi bạn tự xác nhận trên terminal của mình. AI không tự xác nhận thay bạn: gặp lệnh này, AI đưa lệnh để bạn tự chạy (luật xác nhận).

Cho agent đọc tài liệu SePay

Agent chưa dùng SePay MCP, Skills hay CLI vẫn đọc được tài liệu SePay dạng văn bản qua các địa chỉ sau:

NguồnĐịa chỉDùng khi
Mục lục cho AI/llms.txtAgent cần danh sách mọi trang kèm mô tả ngắn
Toàn bộ tài liệu/llms-full.txtCông cụ cần nạp cả bộ tài liệu, ví dụ để lập chỉ mục. Tệp rất lớn (vài MB), vượt sức chứa của một phiên agent, nên agent không đọc thẳng tệp này
Markdown từng trangThêm .md vào cuối URL, ví dụ /vi/sepay-webhooks/tong-quan.mdAgent cần đọc một trang, nhanh và tốn ít chi phí hơn
Tool tài liệu của SePay MCPlist_docs, fetch_contentỨng dụng AI đã kết nối SePay MCP, không cần đăng nhập

Tiếp theo