SnapEX Pay

chính thức

Thanh toán tiền mã hóa cho các tác nhân AI: tài khoản tự phục vụ, hóa đơn, nhận tiền, chi trả, trao đổi.

Bạn có thể làm gì với SnapEX Pay MCP?

Mở tài khoản người bán — Yêu cầu agent gọi create_account để nhận api_key, login/password đăng nhập vào trang quản trị và mcp_personal_url mà không cần captcha hoặc email.
Tạo và theo dõi hóa đơn — Dùng create_invoice để lấy pay_url cho người thanh toán, sau đó thăm dò get_invoice cho đến khi trạng thái là paid; chế độ thử nghiệm không sử dụng tiền thật.
Gửi khoản chi trả bằng tiền mã hóa an toàn — Lấy báo giá bằng preview_payout, sau đó gọi create_payout với preview_id và idempotency_key để các lần thử lại không bao giờ thanh toán hai lần.
Kiểm tra danh mục và phí — Truy vấn list_assets, get_fiat_rates, get_fees và list_static_address_networks trước khi cần bất kỳ khóa nào.
Chuyển đổi tài sản đang nắm giữ — Lấy báo giá bằng preview_conversion và thực hiện bằng create_conversion để đổi các tài sản khác sang số dư USDT.

Máy chủ MCP được lưu trữ

npx add-mcp 'https://pay.snapex.pro/mcp'

Cài vào Claude Code, Codex, Cursor và nhiều công cụ khác

Tài liệu

Máy chủ MCP SnapEX Pay

Máy chủ MCP dành cho thanh toán tiền mã hóa: tác nhân AI tự mở tài khoản người bán và chấp nhận, gửi, trao đổi tiền mã hóa.

Máy chủ MCP SnapEX Pay cho phép tác nhân AI xử lý thanh toán tiền mã hóa mà không cần người tham gia. Tác nhân kết nối với https://pay.snapex.pro/mcp,, tự mở tài khoản người bán SnapEX Pay (không cần captcha, không cần email) và nhận khóa API. Sau đó, tác nhân có thể tạo hóa đơn kèm trang thanh toán lưu trữ, nhận tiền mã hóa qua địa chỉ nạp tiền cố định, giữ số dư USDT, gửi khoản chi trả bằng nhiều đồng tiền và trên nhiều mạng, cũng như quản lý webhook. Chế độ thử nghiệm chạy toàn bộ quy trình mà không dùng tiền thật. Khoản chi trả luôn bắt đầu bằng bản xem trước miễn phí và sử dụng khóa idempotency, vì vậy thử lại sẽ không bao giờ thanh toán hai lần. Máy chủ từ xa (Streamable HTTP) hoặc gói cục bộ: npx -y snapex-pay-mcp.

Máy chủ từ xa (khuyên dùng, không cần cài đặt): https://pay.snapex.pro/mcp — Streamable HTTP.
Gói stdio cục bộ: npx -y snapex-pay-mcp — cùng các công cụ, là ứng dụng khách gọn nhẹ của cùng API.
Docker: docker build -t snapex-pay-mcp . && docker run -i --rm snapex-pay-mcp.
Tên trong MCP Registry: pro.snapex/pay.
Tài liệu dành cho người dùng: https://pay.snapex.pro/mcp · Tài liệu tham khảo REST: https://pay.snapex.pro/partner/merchant/docs · thẻ máy chủ: https://pay.snapex.pro/.well-known/mcp.json · https://pay.snapex.pro/llms.txt
Chính sách quyền riêng tư: https://pay.snapex.pro/privacy · Điều khoản: https://pay.snapex.pro/terms · Quy định dành cho người bán: https://pay.snapex.pro/rules · Hỗ trợ: https://pay.snapex.pro/#chat

Cách tác nhân sử dụng

Kết nối mà không cần khóa. Các công cụ danh mục (list_assets, get_fiat_rates, get_fees, list_static_address_networks) hoạt động ngay.
Gọi create_account. Công cụ trả về api_key (chỉ hiển thị một lần), thông tin đăng nhập login/password dành cho người dùng và mcp_personal_url. Khóa mới được sử dụng ngay: trên máy chủ từ xa trong phần còn lại của phiên MCP, trong gói stdio trong suốt quá trình chạy (và được lưu vào ~/.config/snapex-pay/credentials.json để dùng cho các lần chạy sau).
Nhận tiền: create_invoice → cung cấp pay_url cho người thanh toán → gọi get_invoice cho đến khi có paid. environment: "test" chạy toàn bộ quy trình mà không dùng tiền thật (hóa đơn thử nghiệm chuyển sang trạng thái đã thanh toán khoảng 10 giây sau khi chọn đồng tiền; số dư không thay đổi).
Gửi tiền: preview_payout (báo giá miễn phí) → gọi create_payout với preview_id và idempotency_key của riêng bạn (không thể hoàn tác; thử lại với cùng khóa sẽ không bao giờ thanh toán hai lần).
Số dư được giữ bằng USDT: để nhận một đồng tiền khác, hãy chi trả bằng đồng tiền đó. preview_conversion → create_conversion chuyển đổi các tài sản khác mà tài khoản cũ vẫn còn giữ.

Mọi câu trả lời lỗi đều cho biết bước tiếp theo cần làm (what_to_do), ví dụ: unauthorized → gọi create_account; rate_limited → chờ retry_after_seconds.

Kết nối

Claude Code

claude mcp add --transport http snapex-pay https://pay.snapex.pro/mcp
# with an existing key:
claude mcp add --transport http snapex-pay https://pay.snapex.pro/mcp --header "Authorization: Bearer smk_…"

Cursor — `~/.cursor/mcp.json`

{
  "mcpServers": {
    "snapex-pay": { "url": "https://pay.snapex.pro/mcp" }
  }
}

Thêm "headers": { "Authorization": "Bearer smk_…" } để dùng chung một tài khoản giữa các phiên.

VS Code — `.vscode/mcp.json`

{
  "servers": {
    "snapex-pay": { "type": "http", "url": "https://pay.snapex.pro/mcp" }
  }
}

Windsurf — `~/.codeium/windsurf/mcp_config.json`

{
  "mcpServers": {
    "snapex-pay": { "serverUrl": "https://pay.snapex.pro/mcp" }
  }
}

Cline — `cline_mcp_settings.json`

{
  "mcpServers": {
    "snapex-pay": { "type": "streamableHttp", "url": "https://pay.snapex.pro/mcp" }
  }
}

Hướng dẫn từng bước dành cho trình cài đặt AI: llms-install.md.

Gemini CLI

Dưới dạng tiện ích mở rộng (kho lưu trữ này có gemini-extension.json):

gemini extensions install https://github.com/snapexpay/snapex-pay-mcp

hoặc trong ~/.gemini/settings.json:

{
  "mcpServers": {
    "snapex-pay": { "httpUrl": "https://pay.snapex.pro/mcp" }
  }
}

Claude Desktop — `claude_desktop_config.json`

Máy chủ từ xa thông qua mcp-remote:

{
  "mcpServers": {
    "snapex-pay": { "command": "npx", "args": ["-y", "mcp-remote", "https://pay.snapex.pro/mcp"] }
  }
}

hoặc gói cục bộ:

{
  "mcpServers": {
    "snapex-pay": {
      "command": "npx",
      "args": ["-y", "snapex-pay-mcp"],
      "env": { "SNAPEX_API_KEY": "smk_…" }
    }
  }
}

(SNAPEX_API_KEY là tùy chọn: nếu không có, tác nhân sẽ gọi create_account và khóa sẽ được lưu để dùng cho các lần chạy sau.)

Trình kết nối claude.ai và ChatGPT

Thêm trình kết nối tùy chỉnh với URL https://pay.snapex.pro/mcp và không cần xác thực. Các ứng dụng này không thể gửi header, vì vậy sau khi gọi create_account, hãy lấy mcp_personal_url từ câu trả lời (cũng được trả về bởi get_account) và dùng nó làm URL trình kết nối — mỗi cuộc trò chuyện mới sau đó sẽ dùng cùng một tài khoản. URL đó chứa thông tin xác thực: hãy xem nó như mật khẩu.

OpenAI Responses API

{
  "type": "mcp",
  "server_label": "snapex_pay",
  "server_url": "https://pay.snapex.pro/mcp",
  "headers": { "Authorization": "Bearer smk_…" },
  "require_approval": { "always": { "tool_names": ["create_payout", "create_conversion"] } }
}

Các ứng dụng khách và danh mục khác

Kho lưu trữ có các tệp kê khai mà các danh mục đọc: server.json (MCP Registry chính thức), glama.json (Glama), gemini-extension.json + GEMINI.md (Gemini CLI), lhm.plugin.json (LobeHub), .cursor-plugin/plugin.json + mcp.json (Cursor Marketplace), plugin.json (Agent Plugins / Kiro), llms-install.md (Cline).

Docker

docker build -t snapex-pay-mcp .
docker run -i --rm -e SNAPEX_API_KEY=smk_… snapex-pay-mcp

Công cụ

Tài khoản

Công cụ	Chức năng
`create_account`	Mở tài khoản SnapEX Pay (không cần captcha)
`get_account`	Hiển thị tài khoản và khóa hiện tại

Danh mục (không cần khóa)

Công cụ	Chức năng
`list_assets`	Liệt kê đồng tiền và mạng
`get_fiat_rates`	Tỷ giá hối đoái tiền pháp định
`get_fees`	Báo giá phí tuyến hiện tại
`list_static_address_networks`	Các mạng hỗ trợ địa chỉ cố định

Số dư

Công cụ	Chức năng
`get_balances`	Số dư tài khoản
`list_transactions`	Lịch sử số dư

Nhận tiền

Công cụ	Chức năng
`create_invoice`	Tạo hóa đơn (nhận tiền mã hóa)
`get_invoice`	Trạng thái hóa đơn
`list_invoices`	Liệt kê hóa đơn
`get_invoice_payment_methods`	Các đồng tiền có thể dùng để thanh toán hóa đơn
`select_invoice_payment_method`	Chọn đồng tiền cho hóa đơn
`preview_payment`	Báo giá thanh toán trực tiếp
`create_payment`	Tạo khoản thanh toán trực tiếp
`get_payment`	Trạng thái thanh toán
`list_payments`	Liệt kê khoản thanh toán
`create_static_address`	Địa chỉ nạp tiền cố định
`list_static_addresses`	Liệt kê địa chỉ cố định
`list_static_address_deposits`	Các khoản nạp vào địa chỉ cố định

Gửi tiền (chi trả)

Công cụ	Chức năng
`preview_payout`	Báo giá khoản chi trả (gửi tiền mã hóa)
`create_payout`	Gửi khoản chi trả (không thể hoàn tác) ⚠️ không thể hoàn tác
`get_payout`	Trạng thái khoản chi trả
`list_payouts`	Liệt kê khoản chi trả

Trao đổi

Công cụ	Chức năng
`preview_conversion`	Báo giá chuyển đổi (trao đổi)
`create_conversion`	Thực hiện chuyển đổi ⚠️ không thể hoàn tác
`get_conversion`	Trạng thái chuyển đổi
`list_conversions`	Liệt kê các lần chuyển đổi

Webhook

Công cụ	Chức năng
`list_webhooks`	Liệt kê điểm cuối webhook
`create_webhook`	Thêm điểm cuối webhook
`update_webhook`	Thay đổi điểm cuối webhook
`rotate_webhook_secret`	Tạo bí mật webhook mới ⚠️ không thể hoàn tác

Tài nguyên: snapex://docs/quickstart, snapex://docs/webhooks. Lời nhắc: accept_crypto_payment, send_crypto_payout.

Biến môi trường (gói stdio)

Biến	Mặc định	Ý nghĩa
`SNAPEX_API_KEY`	—	Khóa API người bán `smk_…`. Tùy chọn: `create_account` sẽ tạo khóa.
`SNAPEX_BASE_URL`	`https://pay.snapex.pro`	URL cơ sở của API.
`SNAPEX_CREDENTIALS_FILE`	`~/.config/snapex-pay/credentials.json`	Nơi lưu khóa từ `create_account` (chế độ 600).
`SNAPEX_NO_SAVE`	—	`1` — không lưu thông tin xác thực vào đĩa.

An toàn

Tác nhân chỉ chuyển tiền từ tài khoản của chính mình; tài khoản mới bắt đầu với số dư bằng không.
Khóa và mật khẩu được tạo chỉ hiển thị một lần. Người dùng có thể đăng nhập vào trang quản lý bằng tên đăng nhập và mật khẩu để thu hồi hoặc xoay vòng khóa.
Khoản chi trả gồm hai bước (báo giá, sau đó gửi) và cần có idempotency_key; create_payout, create_conversion và rotate_webhook_secret được đánh dấu là destructiveHint, để ứng dụng khách có thể hỏi trước khi thực hiện.
Giới hạn: mỗi IP có thể tạo vài tài khoản mới mỗi giờ; khoảng 120 lệnh gọi API mỗi phút cho mỗi khóa; chi trả tối đa 5 lần mỗi phút và 30 lần mỗi giờ.
Quy định về những mặt hàng được phép bán: https://pay.snapex.pro/rules.

Phát triển

Danh sách công cụ được tạo từ máy chủ SnapEX Pay (app/Mcp/McpToolCatalog.php):

php artisan mcp:export-tools      # writes src/tools.json, syncs the version of the manifests and LobeHub's tools
npm ci && npm test                # build + offline smoke test with the official MCP SDK client
SNAPEX_E2E_BASE_URL=http://127.0.0.1:8765 node test/smoke.mjs   # full flow against a local (never production) server

Hỗ trợ

Trò chuyện: https://pay.snapex.pro/#chat · Quyền riêng tư: https://pay.snapex.pro/privacy · Điều khoản: https://pay.snapex.pro/terms

Giấy phép

MIT