Tóm tắt nhanh:
ak-payment-integrationgiúp bạn nhận tiền trong app với 9 nhà cung cấp: SePay, PayFS trong nước và Stripe, PayPal, Polar, Paddle, Creem, Dodo Payments, Lemon Squeezy quốc tế. Dù làm với nhà nào, nó giữ cùng bộ cổng an toàn và test trên sandbox. Nó không coi trang "Cảm ơn" là bằng chứng đã trả tiền, và không tự đổi phiên bản API bạn đang dùng.
Công khai: mình là maintainer của AgentKit và có quan hệ affiliate: link AgentKit trong bài là link affiliate, mua qua link này bạn được giảm 30%.
Tóm tắt
Dùng khi bạn cần thêm thanh toán vào app, chọn nhà cung cấp, thêm gói định kỳ, sửa webhook xử lý sai, hoặc gộp đơn từ nhiều nhà vào một bảng. Không cần khi việc không đụng tới tiền, checkout hay webhook thanh toán.
flowchart LR
A["Cần nhận tiền trong app"] --> B["ak-payment-integration"]
B --> C["Chọn hoặc giữ nhà cung cấp"]
C --> D["Checkout + webhook an toàn"]
D --> E["Test bằng sandbox"]
E --> F["Báo các chuyển trạng thái đã kiểm"]Nó xoay quanh 4 khái niệm:
| Khái niệm | Câu hỏi | Ví dụ |
|---|---|---|
| Nhà cung cấp và việc cần làm | Bạn làm với nhà nào, và làm phần nào? | /ak-payment-integration sepay rồi "thêm webhook xác nhận chuyển khoản" |
| Server giữ sự thật | Khi nào đơn được coi là đã trả tiền? | Chỉ khi webhook hợp lệ tới; số tiền, tiền tệ, trạng thái do server quyết |
| Webhook an toàn | Sự kiện tới hai lần, sai thứ tự, hoặc chữ ký sai thì sao? | Kiểm chữ ký trên body gốc, lưu khoá idempotency, sự kiện trùng thì bỏ qua |
| Merchant of Record | Ai đứng tên người bán và lo thuế các nước? | Polar, Creem, Dodo Payments, Lemon Squeezy, Paddle lo thuế thay bạn; PayPal thì không |
Chọn nhanh: bán VND qua chuyển khoản thì xem SePay hoặc PayFS, SaaS bán toàn cầu mà không muốn tự lo thuế thì xem các Merchant of Record, cần marketplace hay checkout tuỳ biến sâu thì xem Stripe. Phí, giới hạn và phiên bản API thay đổi theo thời gian, nên skill kiểm lại tài liệu chính thức trước khi ghim vào code.
Prompt mẫu cho chuyển khoản VietQR:
/ak-payment-integration sepay Thêm thanh toán chuyển khoản VietQR cho <tên shop>.
Kết quả: khách quét QR, đơn tự sang "đã thanh toán" khi tiền về tài khoản.
Ràng buộc: giá bằng VND, giữ bảng orders hiện có, webhook dùng HMAC.
Xong khi: test webhook trùng, sai chữ ký, chuyển thiếu tiền đều không giao hàng nhầm.Skill này không có cờ. Sau tên lệnh bạn ghi tên nhà cung cấp rồi việc cần làm ([provider] [task]). Chưa chọn nhà thì bỏ phần đầu và mô tả thị trường, tiền tệ, nhu cầu thuế.
Phần dưới đây là bản chi tiết: luồng chạy, 5 tình huống kèm prompt, cách ghi đầu vào, lịch sử thay đổi theo bản ak và các lỗi hay vấp. Bản chi tiết và trang trực quan dành cho subscriber. Agent của bạn cũng tìm được trong đó qua MCP của portal.
Mở khi tài khoản có quyền subscriber
Bài này dành cho subscriber
Khi tài khoản có quyền, toàn bộ bài, bản visual tương tác và lệnh gọi từ agent đều mở.
- Đăng nhập hoặc tạo tài khoản modernEngineerQuyền đọc gắn với email tài khoản.
- Chọn gói trên trang Bảng giáGói 1, 3 hoặc 12 tháng, trả bằng chuyển khoản VietQR. Quyền đọc mở khoảng một phút sau khi tiền về.
- Hoặc nhập mã Facebook subscriberNgười ủng hộ trang qua Facebook nhận mã kích hoạt qua tin nhắn mỗi tháng.
Đã là subscriber? Đăng nhập để đọc.
Dùng bài này trong agent của bạn
Lấy API keyChép đoạn dưới, dán vào Claude Code, Codex hay agent bạn đang dùng. Agent đọc bài rồi đối chiếu với repo đang mở.
Đọc bài "ak-payment-integration: thêm thanh toán với webhook an toàn" trên modernEngineer rồi áp dụng vào repo này.
1. Gọi tool content_get của MCP server modernengineer với locale "vi", slug "ak-payment-integration". Nếu chưa nối MCP server modernengineer, dừng lại và hướng dẫn tôi nối theo https://modernengineer.dev/vi/mcp.
2. Tóm tắt các bước chính của bài, chỉ ra bước nào áp dụng được cho repo này.
3. Đề xuất thay đổi cụ thể và hỏi tôi trước khi sửa file.Nối MCP cho Claude Code (một lần)
claude mcp add --transport http modernengineer \
https://api.modernengineer.dev/mcp \
--header "Authorization: Bearer <API key>"Đọc trọn bài qua MCP cần API key của tài khoản subscriber hoặc đã mua guide này. Không có quyền, agent sẽ chỉ đọc được phần mở đầu.
- Phiên bản
- v1.0.0
- Cập nhật
- 22/10/2026
- Giấy phép
- Bảo lưu mọi quyền
- Slug
- ak-payment-integration
