MCP Server có thu phí: Hướng dẫn Claude thu tiền trong hội thoại

2026-10-13 · AgentPay VN

aipythonmcpvietqrpayment

Tình huống: Khi AI của bạn chỉ biết nói chuyện mà không biết kiếm tiền

Bạn vừa huấn luyện một chatbot bán khoá học lập trình. Nó trả lời tuyệt vời, người dùng muốn mua, nhưng... rồi sao? Bot phải nói: "Bạn vui lòng chuyển khoản vào tài khoản này" và chờ người dùng tự động gửi tiền? Quá phiền toái. Hoặc chuyển link thanh toán Stripe, rồi bot không biết người dùng đã thanh toán chưa?

Nếu bot của bạn có thể tự động tạo mã QR, gửi ngay cho khách hàng, và tự động biết khi nào tiền đã vào tài khoản ngân hàng của bạn – mà KHÔNG cần phải giữ tiền ở bên thứ ba – thì sao?

Đó là sức mạnh của MCP server có thu phí kết hợp với AgentPay VN.

Đâu là vấn đề với các giải pháp thanh toán cũ?

Hầu hết các nền tảng thanh toán hiện tại:

AgentPay VN giải quyết tất cả những vấn đề này.

AgentPay VN là gì? Tại sao nó khác biệt?

AgentPay VN là:

Ví dụ thực tế: Một bot bán khoá học Python online. Khách hàng nói "Mình muốn mua khoá này". Bot tạo payment request, gửi mã QR VietQR ngay, khách quét, chuyển 299k – tiền vào tài khoản của bạn ngay lập tức. Bot tự động phát hiện và gửi link download khoá học. Toàn bộ quá trình diễn ra trong 1 hội thoại.

Bước 1: Cài đặt AgentPay VN SDK

Trước tiên, cài đặt package Python:

pip install agentpay-vn

Xác minh cài đặt:

import agentpay_vn
print(agentpay_vn.__version__)  # Kiểm tra phiên bản

Nếu bạn muốn sử dụng MCP server (tích hợp với Claude), cài thêm:

pip install agentpay-mcp

Bước 2: Tạo Payment Request đầu tiên

Hãy tạo một thanh toán đơn giản. Đây là lõi của tất cả:

from agentpay_vn import PaymentRequest, AgentPayClient

# Khởi tạo client (cần thông tin tài khoản ngân hàng)
client = AgentPayClient(
    account_number="1234567890",      # Số tài khoản của bạn
    bank_code="970418",                # Mã ngân hàng (ví dụ: TPBank)
    account_name="SHOP ONLINE"         # Tên tài khoản
)

# Tạo request thanh toán
payment_request = client.create_payment_request(
    amount=299000,                      # Số tiền (VND) - ví dụ: 299k
    description="Khoá học Python nâng cao",  # Mô tả
    order_id="KH_20250122_001"         # ID đơn hàng duy nhất
)

# payment_request chứa:
# - qr_code_url: đường dẫn ảnh QR
# - checkout_url: link cho khách thoải mái nhất
# - vietqr_string: chuỗi VietQR để render thủ công
print(f"Gửi mã QR này cho khách: {payment_request.checkout_url}")

Giải thích từng dòng:

Bước 3: Chờ xác nhận thanh toán

Sau khi khách hàng quét mã QR và chuyển tiền, bạn cần biết khi nào tiền đã về tài khoản. SDK cung cấp cách để điều này:

import asyncio

# Chờ thanh toán hoàn tất (với timeout 10 phút)
settlement = await client.await_settlement(
    order_id="KH_20250122_001",
    timeout_seconds=600
)

# Nếu thanh toán thành công
if settlement.status == "completed":
    print(f"✓ Thanh toán thành công!")
    print(f"  Số tiền: {settlement.amount} VND")
    print(f"  Mã giao dịch: {settlement.transaction_id}")
    # Tại đây, bạn có thể:
    # - Cấp phát sản phẩm/dịch vụ cho khách
    # - Cập nhật database
    # - Gửi email xác nhận
else:
    print(f"✗ Thanh toán thất bại hoặc timeout")

Lưu ý quan trọng: Hàm await_settlement() là async, nên bạn cần chạy nó trong event loop:

# Cách chạy
async def process_order(order_id):
    settlement = await client.await_settlement(order_id)
    return settlement

# Hoặc từ trong một hàm async khác
result = asyncio.run(process_order("KH_20250122_001"))

Bước 4: Tích hợp với Claude qua MCP Server

Đây là phần làm cho AI agent của bạn có khả năng thu tiền tự động trong cuộc hội thoại.

Trước tiên, tạo file agentpay_mcp_config.json để cấu hình MCP server:

{
  "mcpServers": {
    "agentpay-vn": {
      "command": "python",
      "args": ["-m", "agentpay_mcp"],
      "env": {
        "AGENTPAY_ACCOUNT_NUMBER": "1234567890",
        "AGENTPAY_BANK_CODE": "970418",
        "AGENTPAY_ACCOUNT_NAME": "SHOP ONLINE",
        "AGENTPAY_API_KEY": "your_api_key_here"
      }
    }
  }
}

Sau đó, cấu hình Claude (hoặc công cụ MCP client khác) để sử dụng MCP server này. Với Claude, bạn có thể sử dụng Claude Desktop hoặc API với MCP support.

Khi MCP server hoạt động, Claude sẽ có quyền truy cập vào các tool sau:

Lúc này, trong cuộc hội thoại với Claude:

Khách hàng: "Tôi muốn mua khoá học Python của bạn."

Claude: "Tuyệt vời! Khoá học này giá 299.000 VND. Để đăng ký, bạn chỉ cần quét mã QR này và chuyển khoản:

[Claude tự động gọi create_payment và gửi checkout_url]

Sau khi thanh toán, bạn sẽ nhận được link tải ngay."

Kịch bản thực tế: Bot bán khoá học online

Hãy tưởng tượng bạn chạy một cửa hàng bán khoá học lập trình online. Bạn muốn một chatbot tự động bán hàng 24/7.

Luồng:

  1. Khách hàng: "Bạn có khoá học Python không?"
  2. Bot: "Có! Khoá học 'Python từ 0 đến Master' giá 299k. Bạn có quan tâm không?"
  3. Khách hàng: "Có, tôi muốn mua."
  4. Bot (dùng MCP + AgentPay VN): - Tạo payment request với create_payment - Gửi checkout_url cho khách hàng - Chờ xác nhận thanh toán với await_settlement
  5. Khi tiền vào tài khoản (tự động phát hiện qua bank feed): - Bot: "Thanh toán thành công! Đây là link tải khoá học: [link]" - Database được cập nhật: khách hàng được ghi nhận là đã mua - Email xác nhận được gửi tự động

Lợi ích:

Nên vs. Không nên: Danh sách kiểm tra

Tiêu chí Nên Không nên
Loại sản phẩm Khoá học, ebook, phần mềm, dịch vụ số Hàng vật lý (cần logistics phức tạp)
Giá bán Từ 10k đến 100M+ VND Quá nhỏ (<5k, mất thời gian setup)
Tần suất bán Bán thường xuyên, cần tự động hoá Bán lâu lâu 1-2 lần/tháng
Yêu cầu bảo mật Bình thường (webhook, ngân hàng xử lý) Rất cao (không nên, tính đến PCI compliance)
Tích hợp AI agent Muốn bot tự bán hàng, tự động hoá Không có nhu cầu AI
Kỹ năng tech Bạn quen Python, API, async/await Hoàn toàn không biết lập trình

Mục FAQ

1. "Tiền có thực sự vào tài khoản ngân hàng của tôi không? Hay AgentPay VN sẽ giữ?"

Trả lời: Tiền vào trực tiếp tài khoản ngân hàng của bạn. AgentPay VN hoàn toàn không giữ tiền. Mã VietQR trong mã QR chỉ định tài khoản của bạn, phí chuyển khoản là phí ngân hàng thôi (thường 0-1%). Bạn kiểm soát 100% tiền của mình.

2. "Làm sao bot biết tiền đã vào? Có thể giả mạo được không?"

Trả lời: SDK kết nối trực tiếp với bank feed của tài khoản ngân hàng của bạn (qua API ngân hàng hoặc import file). Mỗi giao dịch được xác nhận bởi ngân hàng, không thể giả mạo. Hơn nữa, mã giao dịch được ghi lại, nên kiểm toán được.

3. "MCP server là gì? Có phức tạp không?"

Trả lời: MCP (Model Context Protocol) là chuẩn do Anthropic (tạo Claude) phát triển. Nó cho phép AI agents gọi các hàm/tool giống như một assistant con. Với AgentPay VN, bạn không cần viết MCP từ đầu – SDK đã cung cấp sẵn. Chỉ cần cài agentpay-mcp và cấu hình JSON là xong.

4. "Có hỗ trợ thanh toán qua các ngân hàng khác không? Chỉ VietQR?"

Trả lời: Hiện tại AgentPay VN tập trung vào VietQR (tiêu chuẩn chung của các ngân hàng Việt Nam). VietQR tương thích với tất cả ngân hàng, nên kỹ thuật bạn có thể nhận thanh toán từ bất kỳ khách hàng nào dùng app ngân hàng Việt Nam. Nếu cần hỗ trợ gateway khác (Stripe, PayPal, v.v.), bạn có thể tích hợp song song.

Tóm tắt nhanh: Những điều cần nhớ

Bắt đầu ngay

Bước 1: Cài đặt SDK:

pip install agentpay-vn

Bước 2: Đọc tài liệu đầy đủ:

https://agentpay.servicesai.vn/v1/docs

Bước 3: Xem code ví dụ trên GitHub:

https://github.com/phuocdu/agentpay-vn

Bước 4: Tạo payment request đầu tiên và test với webhook.

Bước 5: Tích hợp MCP server để Claude có thể bán hàng cho bạn.

Nếu bạn đang chạy một bot AI, một shop online nhỏ, hoặc bất kỳ doanh nghiệp nào cần thanh toán tự động – AgentPay VN sẽ tiết kiệm cho bạn hàng tháng code phức tạp và phí gateway đắt tiền. Hãy thử ngay!

Bắt đầu →

← Tất cả bài