SePay Skills

SePay Skills: AI viết tích hợp thanh toán đúng ngay từ đầu

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.

Tải sepay.zipbản mới nhất

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.

Dùng được với

  • Logo ClaudeClaude
  • Logo ChatGPTChatGPT
  • Logo GeminiGemini
  • Logo GrokGrok
  • Logo Claude CodeClaude Code
  • Logo CodexCodex
  • Logo CursorCursor
  • Logo Gemini CLIGemini CLI
Tích hợp SePay cho web bán hàng

Tích hợp SePay: khách chuyển khoản đúng mã đơn thì tự xác nhận đơn

Logo SePay Skills thanh toá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:

  • Kiểm tra khoá xác thực SePay gửi kèm webhook
  • Bỏ qua giao dịch đã xử lý, không cộng tiền hai lần
  • Tách mã đơn DH… từ nội dung chuyển khoản
  • So số tiền với đơn hàng

Đã 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ó Skills, AI hay mắc 5 lỗi thanh toán này

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.

  1. 1

    Xác thực webhook đến từ SePay

    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.

  2. 2

    Chống xử lý trùng giao dịch

    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.

  3. 3

    Tách mã đơn từ nội dung chuyển khoản

    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.

  4. 4

    Xử lý tiền về thiếu hoặc thừa

    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ợ.

  5. 5

    Chạy thử trước khi bán hàng

    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.

Chép câu lệnh, dán vào AI là chạy

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.

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.

Tích hợp thanh toán chuyển khoản qua SePay cho web bán hàng này. Mỗi đơn có mã dạng DH kèm số, hiện mã QR khi khách thanh toán. Khi nhận webhook SePay có đúng mã đơn và đủ số tiền thì chuyển đơn sang Đã thanh toán. Chống xử lý trùng giao dịch. Chạy thử bằng SePay CLI trên sandbox.

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.

App nạp tiền vào ví

Mỗi khách một mã nạp riêng, tiền về là cộng vào đúng ví.

Thêm tính năng nạp tiền vào ví cho app này qua SePay. Mỗi khách có một mã nạp riêng. Khi nhận webhook SePay, cộng tiền vào đúng ví theo mã nạp và ghi lịch sử nạp. Không cộng trùng khi webhook gửi lại. Chạy thử bằng SePay CLI trên sandbox.

AI sẽ làm: mã nạp theo khách, cộng ví, lịch sử nạp, chống cộng trùng.

Trang thanh toán cho từng hóa đơn

Khách trả qua cổng thanh toán SePay, trả xong là hóa đơn tự cập nhật.

Thêm vào hệ thống này trang thanh toán cho từng hóa đơn, dẫn khách sang cổng thanh toán SePay để trả bằng thẻ hoặc VietQR NAPAS. Link tới trang này gửi cho khách qua Zalo hoặc email. Khách thanh toán xong thì hóa đơn tự chuyển sang Đã thu. Chạy thử bằng SePay CLI trên sandbox.

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.

Cài SePay Skills

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.

  1. Tải sepay.zip, giữ nguyên tệp, không giải nén.
  2. Chọn ảnh đại diện ở góc dưới bên trái, rồi chọn Cài đặt (Settings).
  3. Ở menu bên trái của cửa sổ Cài đặt, chọn Skills → Thêm (Add) → Tải Skill lên (Upload skill).
  4. Kéo thả hoặc chọn tệp sepay.zip, rồi chọn Tải lên (Upload).
  5. Claude mở trang skill sepay, công tắc đã bật sẵn. Chọn Thử trong đoạn chat (Try in chat) để hỏi thử.

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.

Dùng Skills thanh toán cùng CLI và MCP

Mỗi công cụ lo một việc, từ lúc viết code đến khi bán hàng.

  1. 1. SePay Skills: viết codeAI viết code nhận thanh toán theo đúng quy tắc của SePay.
  2. 2. SePay CLI: chạy thửThử trên sandbox, kiểm thử trong CI.Xem SePay CLI →
  3. 3. SePay MCP: theo dõiKhi đã bán hàng, hỏi AI về giao dịch và webhook.Xem SePay MCP →

Câu hỏi thường gặp

Không thấy câu bạn cần? Liên hệ SePay.

Skills có đọc dữ liệu tài khoản của tôi không?

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à gì? SePay Skills khác gì?

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.

Dùng được với AI nào?

Ứ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.

Có cần cài SePay CLI không?

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.

Dự án viết bằng ngôn ngữ nào cũng dùng được chứ?

Đượ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.

Cập nhật Skills thế nào?

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.

Lệnh npx skills có gửi thông tin ra ngoài không?

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.

Cài SePay Skills cho AI của bạn

Rồi dán một câu lệnh mẫu là bắt đầu được.