Web bán hàng tự xác nhận đơn
Khách chuyển khoản đúng mã đơn, đơn tự chuyển sang Đã thanh toán.
AI sẽ làm: mã đơn, trang QR, handler webhook, bài kiểm thử. Bạn tự làm trên my.sepay.vn: bật nhận diện mã thanh toán DH và tạo webhook.
SePay Skills
SePay Skills là bộ Agent Skills về thanh toán, cài vào Claude, ChatGPT, Gemini, Grok và agent lập trình như Claude Code, Codex, Cursor. Có nó, AI biết kiểm tra webhook có đúng do SePay gửi, không cộng tiền hai lần và tách đúng mã đơn. Vẫn chạy thử trên sandbox và kiểm tra trước khi bán hàng thật.
Không biết code? Dùng ứng dụng chat như Claude, ChatGPT, Gemini, Grok: tải sepay.zip rồi tải lên mục Skills, xem các bước.
Dùng cho Claude Desktop (chat, Cowork, Code) và claude.ai: bấm ảnh đại diện ở góc dưới bên trái → Cài đặt (Settings) → Skills → Thêm (Add) → Tải Skill lên (Upload skill), chọn sepay.zip. Xem các bước.
Ở thanh bên ChatGPT, chọn Plugin (Plugins) → tab Skills → Tạo (Create) → Tải lên từ máy tính (Upload from your computer), chọn sepay.zip. Chỉ gói Plus, Business, Enterprise, Healthcare và Edu thêm được skill. Xem các bước.
$ claude plugin marketplace add sepayvn/sepay-skills && claude plugin install sepay@sepayChạy trong terminal, không cần Node.js. Mở phiên Claude Code mới để nạp skill.
$ codex plugin marketplace add sepayvn/sepay-skills && codex plugin add sepay@sepayChạy trong terminal, không cần Node.js. Mở phiên Codex mới để nạp skill.
$ npx skills add sepayvn/sepay-skills -a cursor -g -yLệnh npx skills cần Node.js 22.20 trở lên, đây là yêu cầu của công cụ cài skill bên thứ ba, không phải của SePay Skills. Máy chưa có Node.js thì dùng tệp sepay.zip, plugin Claude Code hoặc plugin Codex. Agent khác: chọn Khác.
Chọn ứng dụng trong danh sách Khác.
Tải lên nguyên tệp zip ở mục Skills (Kỹ năng) của Gemini, xem các bước.
$ npx skills add sepayvn/sepay-skills -a github-copilot -g -yLệnh npx skills cần Node.js 22.20 trở lên, đây là yêu cầu của công cụ cài skill bên thứ ba, không phải của SePay Skills. Máy chưa có Node.js thì dùng tệp sepay.zip, plugin Claude Code hoặc plugin Codex. Thay <tên-agent> bằng mã trong danh sách agent hỗ trợ.
Dùng được với
Tích hợp SePay: khách chuyển khoản đúng mã đơn thì tự xác nhận đơn
Đã dùng skill sepay
Đã tạo SepayWebhookController.php
Đã chạy sepay webhook test --forward localhost:3000 --amount 50000 --expect-status 200
Xong rồi. Phần nhận thanh toán đã làm theo SePay Skills:
Đã chạy thử trên sandbox: đơn DH1709 đủ tiền tự chuyển sang Đã thanh toán, webhook gửi lại không bị cộng trùng.
Không có hướng dẫn, AI vẫn viết ra code chạy được. Nhưng lỗi thường chỉ lộ ra khi khách đã chuyển tiền.
Thường saiNhận mọi yêu cầu gửi tới địa chỉ webhook. Ai biết địa chỉ cũng giả được giao dịch.
Có SkillsKiểm tra khoá xác thực SePay gửi kèm trước khi xử lý, sai thì từ chối.
Thường saiWebhook gửi lại khi mạng chập chờn, đơn bị cộng tiền hai lần.
Có SkillsLưu mã giao dịch SePay. Gặp lại thì bỏ qua và vẫn báo nhận thành công.
Thường saiChỉ khớp khi khách ghi đúng y mẫu. Khoản ghi lệch bị bỏ sót.
Có SkillsTách mã theo cấu hình mã thanh toán. Khoản không có mã thì không tự xác nhận đơn.
Thường saiCoi mọi khoản tiền về là đơn đã thanh toán đủ.
Có SkillsAI hỏi bạn cách xử lý tiền thiếu hoặc thừa. Hoàn tiền tự động chỉ có với ngân hàng hỗ trợ.
Thường saiĐưa thẳng vào bán hàng, lỗi lộ ra khi khách đã chuyển tiền.
Có SkillsChạy trên sandbox và kiểm thử webhook bằng SePay CLI trước.
Ba việc hay gặp nhất khi làm thanh toán. Đã cài SePay Skills thì AI tự làm đúng cách.
Khách chuyển khoản đúng mã đơn, đơn tự chuyển sang Đã thanh toán.
AI sẽ làm: mã đơn, trang QR, handler webhook, bài kiểm thử. Bạn tự làm trên my.sepay.vn: bật nhận diện mã thanh toán DH và tạo webhook.
Mỗi khách một mã nạp riêng, tiền về là cộng vào đúng ví.
AI sẽ làm: mã nạp theo khách, cộng ví, lịch sử nạp, chống cộng trùng.
Khách trả qua cổng thanh toán SePay, trả xong là hóa đơn tự cập nhật.
AI sẽ làm: trang thanh toán cho từng hóa đơn, trang nhận kết quả, cập nhật hóa đơn.
Chọn ứng dụng bạn dùng, mỗi ứng dụng một cách cài.
Claude, ChatGPT, Gemini và Grok nhận cùng một tệp: tải sepay.zip, giữ nguyên tệp, không giải nén.
Lệnh npx skills cần Node.js 22.20 trở lên, đây là yêu cầu của công cụ cài skill bên thứ ba, không phải của SePay Skills. Cài bằng tệp sepay.zip, plugin Claude Code hay plugin Codex thì không cần Node.js.
Cũng có trên
Dùng cho Claude Desktop (chat, Cowork, Code) và claude.ai.
Mở thẳng được trang Skills của Claude. Tên menu theo giao diện tháng 11/2026, có thể đổi theo phiên bản. Xem hướng dẫn có ảnh.
Chỉ gói Plus, Business, Enterprise, Healthcare và Edu thêm được skill.
Tên menu theo giao diện tháng 11/2026, có thể đổi theo phiên bản. Xem hướng dẫn đầy đủ.
$ claude plugin marketplace add sepayvn/sepay-skills && claude plugin install sepay@sepaysepay cho bạn, mọi dự án trên máy đều có skill. Muốn cả nhóm dùng chung khi commit thư mục .claude, chạy trong thư mục gốc của dự án và thêm --scope project vào lệnh cài.Hoặc gõ ngay trong Claude Code: /plugin install sepay --marketplace sepayvn/sepay-skills. Đã cài skill bằng npx thì gỡ bản đó bằng npx skills remove sepay -g, để Claude Code không có hai bản skill. Muốn chắc chắn AI dùng skill, nhắc tên trong câu lệnh: “dùng SePay Skills”. Cập nhật bằng claude plugin update sepay@sepay. Xem hướng dẫn đầy đủ.
$ codex plugin marketplace add sepayvn/sepay-skills && codex plugin add sepay@sepaysepay. Plugin dùng được cho mọi dự án trên máy.Hoặc gõ ngay trong Codex: $skill-installer install https://github.com/sepayvn/sepay-skills/tree/main/skills/sepay, skill nằm ở ~/.codex/skills/sepay. Xem hướng dẫn đầy đủ.
$ npx skills add sepayvn/sepay-skills -a cursor -g -y-a cursor cài cho Cursor, -g cài cho mọi dự án trên máy, -y không hỏi gì thêm. Skill nằm ở ~/.agents/skills/sepay.Lệnh npx skills cần Node.js 22.20 trở lên, đây là yêu cầu của công cụ cài skill bên thứ ba, không phải của SePay Skills. Máy chưa có Node.js thì dùng tệp sepay.zip, plugin Claude Code hoặc plugin Codex.
Muốn skill nằm trong dự án để commit cho cả nhóm, bỏ -g và chạy lệnh trong thư mục gốc của dự án. Dùng agent khác như GitHub Copilot, Windsurf, Gemini CLI, Cline thì chọn Khác. Xem hướng dẫn đầy đủ.
Chọn ứng dụng trong danh sách Khác.
$ npx skills add sepayvn/sepay-skills -a github-copilot -g -yLệnh npx skills cần Node.js 22.20 trở lên, đây là yêu cầu của công cụ cài skill bên thứ ba, không phải của SePay Skills. Máy chưa có Node.js thì dùng tệp sepay.zip, plugin Claude Code hoặc plugin Codex. Thay <tên-agent> bằng mã trong danh sách agent hỗ trợ.
Tên menu ứng dụng chat theo giao diện tháng 11/2026, có thể đổi theo phiên bản.
Mỗi công cụ lo một việc, từ lúc viết code đến khi bán hàng.
Không thấy câu bạn cần? Liên hệ SePay.
Không. Skills chỉ là hướng dẫn cho AI, không kết nối tới tài khoản SePay của bạn. Nếu phiên đã kết nối SePay MCP, AI dùng thêm công cụ tra tài liệu của MCP. Lệnh SePay CLI hay API chỉ chạy khi bạn yêu cầu.
Agent Skills là chuẩn chung để đóng gói hướng dẫn cho AI lập trình. SePay Skills là gói có một skill tên sepay: quy tắc tích hợp, luồng làm việc và link tới tài liệu SePay. Khi bạn giao việc liên quan đến thanh toán SePay, AI sẽ dùng tới.
Ứng dụng chat Claude, ChatGPT, Gemini, Grok (ChatGPT cần gói Plus, Business, Enterprise, Healthcare hoặc Edu) và agent lập trình Claude Code, Codex, Cursor, GitHub Copilot, Windsurf, Gemini CLI, Cline cùng các agent khác hỗ trợ Skills.
Không bắt buộc, nhưng nên cài. Skills hướng dẫn AI dùng SePay CLI để chạy thử trên sandbox trước khi đưa vào bán hàng.
Được. Skills hướng dẫn theo API của SePay, AI tự áp vào ngôn ngữ dự án bạn đang dùng. SePay có sẵn SDK cổng thanh toán cho PHP, Node.js.
Skill không tự cập nhật. Cài bằng tệp sepay.zip: mỗi bản phát hành trên trang Releases của SePay Skills có ngày trong tên (ví dụ v2026.11.06). Ngày phát hành mới hơn ngày bạn tải tệp thì tải lại sepay.zip (luôn là bản mới nhất), xóa skill sepay cũ rồi thêm lại. Cài bằng plugin Claude Code thì chạy claude plugin update sepay@sepay (hoặc gõ /plugin update sepay@sepay trong Claude Code), rồi mở phiên mới. Cài bằng plugin trong Codex thì chạy codex plugin marketplace upgrade sepay, rồi codex plugin remove sepay@sepay và codex plugin add sepay@sepay. Cài bằng $skill-installer trong Codex thì xóa thư mục ~/.codex/skills/sepay rồi chạy lại lệnh cài. Cài bằng npx thì chạy npx skills update sepay.
Có. Công cụ npx skills của bên thứ ba gửi tên repo, tên skill và agent bạn chọn về skills.sh của Vercel mỗi lần cài hoặc gỡ; bản thân SePay Skills không gửi gì. Muốn tắt thì đặt DISABLE_TELEMETRY=1 trước lệnh, ví dụ DISABLE_TELEMETRY=1 npx skills add sepayvn/sepay-skills -a cursor -g -y (Windows PowerShell: chạy $env:DISABLE_TELEMETRY=1 trước). Cài bằng tệp sepay.zip, plugin Claude Code hay plugin Codex thì không dùng công cụ này.
Rồi dán một câu lệnh mẫu là bắt đầu được.