SnapEX Pay

ทางการ

การชำระเงินด้วยคริปโตสำหรับ AI agents: สมัครบัญชีด้วยตนเอง ออกใบแจ้งหนี้ รับเงิน จ่ายเงิน และแลกเปลี่ยนสกุลเงิน

คุณทำอะไรได้บ้างด้วย SnapEX Pay MCP?

เปิดบัญชีร้านค้า — ให้เอเจนต์เรียก create_account เพื่อรับ api_key, login/password สำหรับเข้าสู่ระบบแผงควบคุม และ mcp_personal_url โดยไม่ต้องใช้ captcha หรืออีเมล
สร้างและติดตามใบแจ้งหนี้ — ใช้ create_invoice เพื่อรับ pay_url สำหรับผู้ชำระเงิน จากนั้นเรียก get_invoice ซ้ำจนกว่าสถานะจะเป็น paid; โหมดทดสอบทำงานได้โดยไม่ใช้เงินจริง
ส่งการจ่ายเงินคริปโตอย่างปลอดภัย — ขอใบเสนอราคาด้วย preview_payout จากนั้นเรียก create_payout โดยใช้ preview_id และ idempotency_key เพื่อให้การลองใหม่ไม่ทำให้จ่ายเงินซ้ำ
ตรวจสอบแค็ตตาล็อกและค่าธรรมเนียม — เรียกดู list_assets, get_fiat_rates, get_fees และ list_static_address_networks ก่อนที่จะต้องใช้คีย์ใด ๆ
แปลงสินทรัพย์ที่ถืออยู่ — ขอใบเสนอราคาด้วย preview_conversion และดำเนินการด้วย create_conversion เพื่อแลกเปลี่ยนสินทรัพย์อื่นเป็นยอดคงเหลือ USDT

เซิร์ฟเวอร์ MCP แบบโฮสต์

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

ติดตั้งลง Claude Code, Codex, Cursor และอื่นๆ

เอกสาร

เซิร์ฟเวอร์ SnapEX Pay MCP

เซิร์ฟเวอร์ MCP สำหรับการชำระเงินด้วยคริปโต: เอเจนต์ AI เปิดบัญชีผู้ค้าของตัวเองและรับ ส่ง และแลกเปลี่ยนคริปโตได้

เซิร์ฟเวอร์ SnapEX Pay MCP ช่วยให้เอเจนต์ AI จัดการการชำระเงินด้วยคริปโตได้โดยไม่ต้องมีคนคอยดำเนินการ เอเจนต์เชื่อมต่อกับ https://pay.snapex.pro/mcp, เปิดบัญชีผู้ค้า SnapEX Pay ด้วยตัวเอง (ไม่ต้องใช้ CAPTCHA หรืออีเมล) และรับ API key จากนั้นก็สร้างใบแจ้งหนี้พร้อมหน้าชำระเงินที่โฮสต์ไว้ รับคริปโตผ่านที่อยู่ฝากเงินถาวร เก็บยอดคงเหลือเป็น USDT ส่งเงินออกเป็นเหรียญและเครือข่ายต่าง ๆ และจัดการเว็บฮุกได้ โหมดทดสอบจำลองขั้นตอนทั้งหมดโดยไม่ใช้เงินจริง การส่งเงินออกจะเริ่มด้วยการแสดงตัวอย่างฟรีเสมอ และใช้คีย์ idempotency เพื่อให้การลองใหม่ไม่ทำให้จ่ายซ้ำ ใช้เซิร์ฟเวอร์ระยะไกล (Streamable HTTP) หรือแพ็กเกจในเครื่อง: npx -y snapex-pay-mcp

เซิร์ฟเวอร์ระยะไกล (แนะนำ ไม่ต้องติดตั้ง): https://pay.snapex.pro/mcp — Streamable HTTP
แพ็กเกจ stdio ในเครื่อง: npx -y snapex-pay-mcp — ใช้เครื่องมือชุดเดียวกัน เป็นไคลเอนต์แบบบางที่เรียก API เดียวกัน
Docker: docker build -t snapex-pay-mcp . && docker run -i --rm snapex-pay-mcp
ชื่อใน MCP Registry: pro.snapex/pay
เอกสารสำหรับผู้ใช้: https://pay.snapex.pro/mcp · เอกสารอ้างอิง REST: https://pay.snapex.pro/partner/merchant/docs · การ์ดเซิร์ฟเวอร์: https://pay.snapex.pro/.well-known/mcp.json · https://pay.snapex.pro/llms.txt
นโยบายความเป็นส่วนตัว: https://pay.snapex.pro/privacy · ข้อกำหนด: https://pay.snapex.pro/terms · กฎสำหรับผู้ค้า: https://pay.snapex.pro/rules · ฝ่ายสนับสนุน: https://pay.snapex.pro/#chat

วิธีที่เอเจนต์ใช้งาน

เชื่อมต่อโดยไม่ต้องใช้คีย์ เครื่องมือแค็ตตาล็อก (list_assets, get_fiat_rates, get_fees, list_static_address_networks) ใช้งานได้ทันที
เรียก create_account ซึ่งจะแสดง api_key (แสดงเพียงครั้งเดียว), login/password สำหรับให้บุคคลใช้เข้าสู่ระบบ และ mcp_personal_url คีย์ใหม่จะใช้งานได้ทันที: บนเซิร์ฟเวอร์ระยะไกลจะใช้ต่อไปตลอดเซสชัน MCP ส่วนในแพ็กเกจ stdio จะใช้ตลอดอายุโปรเซส (และบันทึกไว้ที่ ~/.config/snapex-pay/credentials.json เพื่อใช้ในการเรียกใช้ครั้งถัดไป)
รับเงิน: create_invoice → ส่ง pay_url ให้ผู้ชำระเงิน → เรียก get_invoice จนกว่าจะได้ paid โหมด environment: "test" จำลอง ขั้นตอนทั้งหมดโดยไม่ใช้เงินจริง (ใบแจ้งหนี้ทดสอบจะเปลี่ยนเป็นสถานะชำระแล้วประมาณ 10 วินาทีหลังเลือกเหรียญ โดยยอดคงเหลือจะไม่เปลี่ยนแปลง)
ส่งเงิน: preview_payout (ใบเสนอราคาฟรี) → เรียก create_payout พร้อม preview_id และ idempotency_key ที่คุณกำหนดเอง (ย้อนกลับไม่ได้ การลองใหม่ด้วยคีย์เดิมจะไม่ทำให้จ่ายซ้ำ)
ยอดคงเหลือเก็บเป็น USDT: หากต้องการเหรียญอื่น ให้จ่ายออกเป็นเหรียญนั้น preview_conversion → create_conversion จะแปลงสินทรัพย์อื่นที่บัญชีเก่ายังคงถืออยู่

คำตอบข้อผิดพลาดทุกครั้งจะระบุว่าควรทำอะไรต่อ (what_to_do) เช่น unauthorized → เรียก create_account; rate_limited → รอ retry_after_seconds

เชื่อมต่อ

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" }
  }
}

เพิ่ม "headers": { "Authorization": "Bearer smk_…" } เพื่อใช้บัญชีเดียวกันในทุกเซสชัน

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" }
  }
}

คำแนะนำทีละขั้นตอนสำหรับตัวติดตั้ง AI: llms-install.md

Gemini CLI

ในรูปแบบส่วนขยาย (ที่เก็บนี้มี gemini-extension.json):

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

หรือใน ~/.gemini/settings.json:

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

Claude Desktop — `claude_desktop_config.json`

เซิร์ฟเวอร์ระยะไกลผ่าน mcp-remote:

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

หรือใช้แพ็กเกจในเครื่อง:

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

(SNAPEX_API_KEY เป็นตัวเลือกเสริม หากไม่ใช้ เอเจนต์จะเรียก create_account และบันทึกคีย์ไว้สำหรับการเรียกใช้ครั้งถัดไป)

ตัวเชื่อมต่อ claude.ai และ ChatGPT

เพิ่มตัวเชื่อมต่อแบบกำหนดเองโดยใช้ URL https://pay.snapex.pro/mcp และไม่ต้องยืนยันตัวตน ไคลเอนต์เหล่านี้ส่ง ส่วนหัวไม่ได้ ดังนั้นหลังจาก create_account ให้นำ mcp_personal_url จากคำตอบ (ซึ่งส่งกลับโดย get_account ด้วย) ไปใช้ เป็น URL ของตัวเชื่อมต่อ จากนั้นแชตใหม่ทุกครั้งจะใช้บัญชีเดิมได้ URL นี้มีข้อมูลรับรองอยู่ ให้เก็บรักษาไว้เสมือนรหัสผ่าน

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"] } }
}

ไคลเอนต์และแค็ตตาล็อกอื่น ๆ

ที่เก็บนี้มีไฟล์ manifest ที่แค็ตตาล็อกใช้: server.json (MCP Registry อย่างเป็นทางการ), 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

เครื่องมือ

บัญชี

เครื่องมือ	ทำอะไรได้
`create_account`	เปิดบัญชี SnapEX Pay (ไม่ต้องใช้ CAPTCHA)
`get_account`	แสดงบัญชีและคีย์ปัจจุบัน

แค็ตตาล็อก (ไม่ต้องใช้คีย์)

เครื่องมือ	ทำอะไรได้
`list_assets`	แสดงรายการเหรียญและเครือข่าย
`get_fiat_rates`	อัตราแลกเปลี่ยนเงินตรา
`get_fees`	ใบเสนอราคาค่าธรรมเนียมเส้นทางปัจจุบัน
`list_static_address_networks`	เครือข่ายสำหรับที่อยู่ถาวร

ยอดคงเหลือ

เครื่องมือ	ทำอะไรได้
`get_balances`	ยอดคงเหลือในบัญชี
`list_transactions`	ประวัติยอดคงเหลือ

รับเงิน

เครื่องมือ	ทำอะไรได้
`create_invoice`	สร้างใบแจ้งหนี้ (รับคริปโต)
`get_invoice`	สถานะใบแจ้งหนี้
`list_invoices`	แสดงรายการใบแจ้งหนี้
`get_invoice_payment_methods`	เหรียญที่ใช้ชำระใบแจ้งหนี้ได้
`select_invoice_payment_method`	เลือกเหรียญสำหรับใบแจ้งหนี้
`preview_payment`	ขอใบเสนอราคาการชำระเงินโดยตรง
`create_payment`	สร้างการชำระเงินโดยตรง
`get_payment`	สถานะการชำระเงิน
`list_payments`	แสดงรายการการชำระเงิน
`create_static_address`	ที่อยู่ฝากเงินถาวร
`list_static_addresses`	แสดงรายการที่อยู่ถาวร
`list_static_address_deposits`	เงินฝากเข้าที่อยู่ถาวร

ส่งเงิน (การจ่ายเงินออก)

เครื่องมือ	ทำอะไรได้
`preview_payout`	ขอใบเสนอราคาการจ่ายเงินออก (ส่งคริปโต)
`create_payout`	ส่งเงินออก (ย้อนกลับไม่ได้) ⚠️ ย้อนกลับไม่ได้
`get_payout`	สถานะการจ่ายเงินออก
`list_payouts`	แสดงรายการการจ่ายเงินออก

แลกเปลี่ยน

เครื่องมือ	ทำอะไรได้
`preview_conversion`	ขอใบเสนอราคาการแปลง (แลกเปลี่ยน)
`create_conversion`	ดำเนินการแปลง ⚠️ ย้อนกลับไม่ได้
`get_conversion`	สถานะการแปลง
`list_conversions`	แสดงรายการการแปลง

เว็บฮุก

เครื่องมือ	ทำอะไรได้
`list_webhooks`	แสดงรายการปลายทางเว็บฮุก
`create_webhook`	เพิ่มปลายทางเว็บฮุก
`update_webhook`	เปลี่ยนปลายทางเว็บฮุก
`rotate_webhook_secret`	สร้างข้อมูลลับเว็บฮุกใหม่ ⚠️ ย้อนกลับไม่ได้

ทรัพยากร: snapex://docs/quickstart, snapex://docs/webhooks พรอมป์ต์: accept_crypto_payment, send_crypto_payout

สภาพแวดล้อม (แพ็กเกจ stdio)

ตัวแปร	ค่าเริ่มต้น	ความหมาย
`SNAPEX_API_KEY`	—	API key ของผู้ค้า `smk_…` ไม่บังคับ: `create_account` จะสร้างคีย์ให้
`SNAPEX_BASE_URL`	`https://pay.snapex.pro`	URL ฐานของ API
`SNAPEX_CREDENTIALS_FILE`	`~/.config/snapex-pay/credentials.json`	ตำแหน่งที่บันทึกคีย์จาก `create_account` (สิทธิ์ 600)
`SNAPEX_NO_SAVE`	—	`1` — ไม่บันทึกข้อมูลรับรองลงดิสก์

ความปลอดภัย

เอเจนต์ใช้จ่ายได้เฉพาะเงินในบัญชีของตัวเอง บัญชีใหม่เริ่มต้นด้วยยอดคงเหลือเป็นศูนย์
คีย์และรหัสผ่านที่สร้างขึ้นจะแสดงเพียงครั้งเดียว บุคคลสามารถเข้าสู่ระบบบัญชีได้ด้วยชื่อผู้ใช้และรหัสผ่าน เพื่อเพิกถอนหรือเปลี่ยนคีย์ได้ที่นั่น
การจ่ายเงินออกมีสองขั้นตอน (ขอใบเสนอราคา แล้วจึงส่ง) และต้องใช้ idempotency_key; create_payout, create_conversion และ rotate_webhook_secret จะถูกทำเครื่องหมายเป็น destructiveHint เพื่อให้ไคลเอนต์ขอการยืนยันก่อนดำเนินการได้
ขีดจำกัด: บัญชีใหม่ไม่กี่บัญชีต่อ IP ต่อชั่วโมง; API ประมาณ 120 ครั้งต่อนาทีต่อคีย์; การจ่ายเงินออก 5 ครั้งต่อนาทีและ 30 ครั้งต่อชั่วโมง
กฎเกี่ยวกับสิ่งที่ขายได้: https://pay.snapex.pro/rules

การพัฒนา

รายการเครื่องมือสร้างขึ้นจากเซิร์ฟเวอร์ 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

ฝ่ายสนับสนุน

แชต: https://pay.snapex.pro/#chat · ความเป็นส่วนตัว: https://pay.snapex.pro/privacy · ข้อกำหนด: https://pay.snapex.pro/terms

ใบอนุญาต

MIT