ApiPay cho AI Agent của bạn
MCP server chính thức của ApiPay giúp AI assistant tạo payment request, quản lý sản phẩm Commerce, tra cứu giao dịch, quản lý webhook và xem số liệu — trực tiếp trong Claude, Cursor, Codex, Command Code, Grok Build, Gemini và hơn thế nữa.
Tương thích với: Claude Desktop · Claude Code · Cursor · Codex · Command Code · Grok Build +12
$ npx -y @apipay.vn/mcpapipay-mcp listening on stdio
23
Công cụ
18
Client
stdio
Local
MIT
Giấy phép
01
Vì sao dùng MCP
01
Ngôn ngữ tự nhiên → hành động
Bạn yêu cầu bằng tiếng Việt, agent tự gọi đúng API — tạo link thanh toán, kiểm tra giao dịch, cập nhật webhook mà không cần viết code.
02
Sandbox an toàn
Dùng key thử nghiệm ak_test_ và mô phỏng thanh toán sandbox để kiểm thử luồng end-to-end trước khi chạy thật.
03
Dữ liệu thời gian thực
Truy vấn giao dịch, số liệu tổng quan và lịch sử giao webhook từ cùng hệ thống API live của bạn.
04
Chạy local, bảo mật key
Server chạy qua stdio ngay trên máy bạn; thông tin xác thực được truyền qua biến môi trường và không được lưu trữ.
02
23 công cụ trong server
Toàn bộ công cụ sẵn sàng cho agent ngay khi kết nối.
03
Bắt đầu trong 3 bước
Từ tài khoản mới đến payment đầu tiên do AI tạo — trong vài phút.
01
Tạo API key
Vào Dashboard → Tích hợp → API Keys và tạo bộ key. Key thử nghiệm bắt đầu bằng ak_test_, key live bằng ak_live_.
02
Cài đặt & cấu hình
Chạy npx -y @apipay.vn/mcp trong client MCP của bạn và dán cấu hình bên dưới cho đúng client.
03
Yêu cầu bằng ngôn ngữ tự nhiên
Hỏi agent "Tạo link thanh toán 50.000đ cho tài khoản MB của tôi" — agent tự gọi công cụ và trả kết quả.
Cấu hình theo client
Chọn client bạn đang dùng và dán cấu hình tương ứng.
{
"mcpServers": {
"apipay": {
"command": "npx",
"args": [
"-y",
"@apipay.vn/mcp"
],
"env": {
"APIPAY_ACCESS_KEY": "ak_test_your_access_key",
"APIPAY_SECRET_KEY": "your_secret_key"
}
}
}
}04
Ví dụ bạn có thể hỏi
Một vài câu lệnh thực tế để bắt đầu — thử trực tiếp trong agent của bạn.
Tạo link thanh toán 50.000đ cho khách, nội dung "ĐH #1024", từ tài khoản MB, và gửi webhook về https://shop.example/hooks/payment
Tạo sản phẩm "Gói Pro" giá 99.000đ với lookupKey pro-monthly, rồi tạo payment link từ price đó trên tài khoản MB
Cho tôi số liệu tổng quan 7 ngày qua: tổng tiền, số giao dịch và tỷ lệ thành công
Liệt kê webhook đang hoạt động và gửi lại các lần giao thất bại trong 24 giờ qua
Hủy payment request pr_test_8x2k đang ACTIVE vì khách đã hủy đơn
Danh sách các tài khoản ngân hàng đang kết nối và tổng giao dịch hôm nay theo từng ngân hàng
✅ Đã tạo link thanh toán
• Mã: pr_test_9f3k...
• Số tiền: 50.000 VND
• Trạng thái: ACTIVE
Webhook đã đăng ký tới https://shop.example/hooks/payment — giao dịch sẽ được gửi về ngay khi khách chuyển khoản.05
Bảo mật
API key truyền qua biến môi trường (APIPAY_ACCESS_KEY / APIPAY_SECRET_KEY), server không lưu trữ thông tin xác thực.
Sandbox tách biệt: key ak_test_ chỉ chạm tới tài nguyên thử nghiệm — mô phỏng thanh toán không bao giờ liên quan tiền thật.
Server chạy local qua stdio, kết nối trực tiếp từ máy bạn tới API ApiPay.
⚠ Công cụ rủi ro
Một số công cụ thay đổi trạng thái vĩnh viễn và cần agent xác nhận rõ ràng trước khi thực thi: cancel_payment, remove_webhook, resend_webhook.
06
Câu hỏi thường gặp
Bắt đầu ngay với sandbox
Cài MCP server, dùng key thử nghiệm và để AI agent của bạn tạo payment đầu tiên trong vài phút.