Tạo MCP Server Thu Phí: Claude Có Thể Nhận Thanh Toán Trong Chat

2026-10-07 · AgentPay VN

aipythonmcpvietqragentpay

Vấn Đề: AI Của Bạn Trò Chuyện Nhưng Không Thể Nhận Tiền

Hãy tưởng tượng bạn vừa xây dựng một bot bán khoá học trực tuyến. Nó trò chuyện tuyệt vời, trả lời câu hỏi, giải thích nội dung—nhưng khi khách hàng nói "Tôi muốn mua", bot chỉ có thể gửi link thanh toán thủ công. Hoặc còn tệ hơn, bạn phải tự xử lý từng đơn hàng, từng hoá đơn.

Đó là khoảng trống mà hầu hết các AI agents hiện nay vẫn còn gặp phải: chúng có thể nói chuyện và ra quyết định, nhưng không thể hành động tài chính trực tiếp. Các giải pháp cũ yêu cầu gateway thanh toán phức tạp, quản lý tài khoản trung gian, hoặc tích hợp đầu tức đầu cuối.

AgentPay VN giải quyết vấn đề này một cách đơn giản và an toàn: cho phép AI agents của bạn tạo yêu cầu thanh toán và xác nhận settlement trong vòng vài dòng Python.

Tại Sao AgentPay VN Khác Biệt?

Không Giữ Tiền, Chỉ Kết Nối

Điều quan trọng nhất: AgentPay VN KHÔNG bao giờ giữ tiền. Nó không phải là e-wallet hay payment processor trung gian. Thay vào đó, nó tạo mã QR VietQR trỏ trực tiếp đến tài khoản ngân hàng của bạn. Khi khách thanh toán, tiền lập tức vào tài khoản thật của bạn, và webhook từ ngân hàng xác nhận.

Diều này có nghĩa: - ✅ Bạn kiểm soát 100% tiền - ✅ Không phí trung gian ẩn - ✅ Hoàn toàn tuân thủ pháp luật Việt Nam - ✅ Nhanh chóng, minh bạch

Tích Hợp Gốc Với MCP & Claude

AgentPay VN cung cấp: 1. Python SDK (mã nguồn mở MIT): pip install agentpay-vn 2. MCP Server: agentpay-mcp — cho phép Claude gọi trực tiếp 3. Bank Feed Integration: xác nhận settlement tự động

Nó không yêu cầu bạn là chuyên gia blockchain hay API gateway. Ba dòng mã Python là đủ.

Cách Hoạt Động: Luồng 3 Bước

Bộ khung của AgentPay VN vô cùng đơn giản:

Bước 1: Tạo Yêu Cầu Thanh Toán
        ↓
Bước 2: Gửi URL Checkout cho Khách
        ↓
Bước 3: Chờ Xác Nhận Từ Ngân Hàng

Mỗi bước là một method Python.

Cài Đặt & Cấu Hình Ban Đầu

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

Trên terminal hoặc command prompt:

pip install agentpay-vn

Xong. Không cần file config phức tạp hay API keys nhiều lớp.

Bước 2: Cấu Hình MCP Server Cho Claude

Nếu bạn dùng Claude Desktop hoặc API với MCP, thêm vào file claude_desktop_config.json (hoặc mcp_config.json):

{
  "mcpServers": {
    "agentpay-vn": {
      "command": "agentpay-mcp",
      "env": {
        "AGENTPAY_MERCHANT_ID": "your_merchant_id_here",
        "AGENTPAY_BANK_ACCOUNT": "your_bank_account_here",
        "AGENTPAY_BANK_CODE": "MB"
      }
    }
  }
}

Các biến môi trường này bạn lấy từ ngân hàng hoặc dashboard AgentPay (xem tại https://agentpay.servicesai.vn/v1/docs).

Bước 3: Khởi Tạo Client Python

Trong ứng dụng của bạn:

from agentpay_vn import AgentPayClient

# Khởi tạo client với merchant ID của bạn
client = AgentPayClient(
    merchant_id="your_merchant_id",
    bank_account="your_bank_account",
    bank_code="MB"  # Hoặc "VCB", "TCB", etc.
)

Hướng Dẫn Từng Bước: Tạo Một Request Thanh Toán

Ví Dụ Thực Tế: Bot Bán Khoá Học Online

Giả sử bạn có một AI tutor bot trên Discord/Telegram. Khi khách nói "Tôi muốn mua khoá Python Advanced", bot cần:

  1. Tạo yêu cầu thanh toán cho khoá học (499.000 VND)
  2. Gửi checkout link cho khách
  3. Chờ khách quét QR và thanh toán
  4. Tự động cấp quyền truy cập khi tiền đến

Đây là code thực tế:

from agentpay_vn import AgentPayClient
import asyncio
from datetime import datetime, timedelta

# Khởi tạo
client = AgentPayClient(
    merchant_id="TUTOR_BOT_001",
    bank_account="1234567890",
    bank_code="MB"
)

async def sell_course(customer_name, customer_phone):
    """
    Bán khoá học cho khách hàng
    """

    # Bước 1: Tạo yêu cầu thanh toán
    # create_payment_request nhận: số tiền, mô tả, metadata tuỳ chọn
    payment_request = await client.create_payment_request(
        amount=499000,  # 499k VND cho khoá Python Advanced
        description="Khoá học Python Advanced - 3 tháng access",
        order_id=f"course_{customer_name}_{datetime.now().timestamp()}",
        metadata={
            "customer_name": customer_name,
            "customer_phone": customer_phone,
            "course_id": "python_advanced_2024",
            "duration_months": 3
        }
    )
    # payment_request.checkout_url: "https://agentpay.vn/checkout/xxx"
    # payment_request.qr_code: mã QR (base64)

    # Bước 2: Gửi link checkout cho khách
    checkout_link = payment_request.checkout_url
    print(f"Gửi link: {checkout_link}")
    # (Bạn sẽ gửi cái này qua Discord, Telegram, email, v.v.)

    # Bước 3: Chờ xác nhận thanh toán
    # await_settlement chờ bank feed thông báo tiền đã vào
    # timeout=600 = chờ tối đa 10 phút
    settlement = await client.await_settlement(
        payment_request_id=payment_request.id,
        timeout=600
    )

    if settlement.status == "completed":
        print(f"✅ Thanh toán thành công! Tiền vào lúc {settlement.timestamp}")
        # Bây giờ bạn có thể:
        # - Gửi link khoá học
        # - Tạo tài khoản khách hàng
        # - Lưu vào database
        return {"success": True, "course_access_url": "https://..."}
    else:
        print(f"❌ Thanh toán thất bại hoặc hết timeout")
        return {"success": False, "error": settlement.error_message}

# Chạy
result = asyncio.run(sell_course(
    customer_name="Nguyễn Văn A",
    customer_phone="0912345678"
))
print(result)

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

Tích Hợp Với Claude: Gọi Từ Chatbot

Bây giờ, cách để Claude gọi các hàm này trực tiếp từ trong cuộc hội thoại.

Cấu Hình MCP Resource Cho Claude

AgentPay VN hỗ trợ MCP (Model Context Protocol), cho phép Claude gọi các tool như create_payment_request hoặc await_settlement như một công cụ bình thường.

Sau khi cài agentpay-mcp, Claude sẽ có quyền truy cập vào:

Tool Chức Năng
agentpay.create_payment_request Tạo yêu cầu thanh toán, trả checkout_url
agentpay.get_payment_status Kiểm tra trạng thái đơn hàng
agentpay.await_settlement Chờ xác nhận từ ngân hàng
agentpay.get_merchant_balance Kiểm tra số dư tài khoản

Khi bạn nói với Claude:

"Tạo một yêu cầu thanh toán 299,000 VND cho khóa học lập trình Python, mô tả là 'Khóa học Python cơ bản - 30 ngày'"

Claude sẽ tự động gọi tool, nhận checkout_url, và trả lại cho bạn:

Tôi đã tạo yêu cầu thanh toán cho bạn!

💳 Chi tiết:
- Số tiền: 299,000 VND
- Mô tả: Khóa học Python cơ bản - 30 ngày
- Link checkout: https://agentpay.vn/checkout/req_abc123xyz
- QR Code: [hình ảnh]

Khách hàng có thể quét mã QR hoặc vào link trên để thanh toán. Tôi sẽ chờ xác nhận từ ngân hàng...

Ví Dụ: Bot Quán Cà Phê Tự Động Thanh Toán

Bạn quản lý một quán cà phê nhỏ. Claude bot của bạn:

  1. Tiếp đơn: "Tôi muốn 1 cà phê espresso + 1 croissant"
  2. Tính tiền: "Tổng 85,000 VND. Bạn muốn thanh toán bằng cách nào?"
  3. Nếu khách chọn VietQR: - Claude gọi create_payment_request(amount=85000, description="Cà phê + Croissant") - Trả QR code cho khách quét - Chờ bank feed xác nhận (thường 5-10 giây) - In hoá đơn tự động, cập nhật doanh thu

Toàn bộ quá trình mất < 1 phút, không cần nhân viên can thiệp.

Các Nên Làm & Không Nên Làm

✅ NÊN ❌ KHÔNG NÊN
Sử dụng await_settlement để tránh cấp quyền trước khi tiền vào Cấp quyền trước khi nhận xác nhận từ ngân hàng
Lưu metadata để tracking chi tiết từng đơn Lưu thông tin nhạy cảm (số điện thoại, email) trong metadata
Đặt timeout hợp lý (300-600s tùy use case) Timeout quá ngắn (< 60s) vì bank feed có độ trễ
Xử lý exception khi network gián đoạn Giả định await_settlement luôn thành công
Test với số tiền nhỏ trước Deploy sản xuất với config chưa verify
Sử dụng order_id unique để tránh trùng lặp Dùng order_id trùng giữa các request

Câu Hỏi Thường Gặp (FAQ)

1. Nếu khách thanh toán rồi nhưng mạng internet của tôi bị ngắt, sao?

AgentPay VN không phụ thuộc vào kết nối real-time của bạn. Nó sử dụng webhook & bank feed: khi tiền vào tài khoản, ngân hàng sẽ gửi thông báo cho AgentPay server. Khi mạng của bạn khôi phục, bot sẽ lấy lại thông tin settlement. Bạn không bao giờ mất tiền hoặc yêu cầu.

2. Phí là bao nhiêu?

AgentPay VN là mã nguồn mở (MIT License), hoàn toàn miễn phí. Bạn chỉ trả phí chuyển tiền của ngân hàng (nếu có)—thường là 0-2,500 VND/giao dịch tuỳ từng ngân hàng.

3. Hỗ trợ những ngân hàng nào?

Hiện tại AgentPay VN hỗ trợ các ngân hàng có VietQR: MB, VCB, TCB, ACB, v.v. (gần như toàn bộ ngân hàng lớn Việt Nam). Danh sách đầy đủ tại https://agentpay.servicesai.vn/v1/docs.

4. Liệu có thể hoàn tiền / refund không?

AgentPay VN chỉ quản lý VietQR & xác nhận settlement. Hoàn tiền được xử lý thông qua ngân hàng của bạn (API chuyển khoản ngân hàng chuẩn). Bạn có thể dễ dàng tích hợp một tool riêng cho refund nếu cần.

Ví Dụ Nâng Cao: Recurring Billing

Ngoài thanh toán một lần, bạn cũng có thể xây dựng recurring billing (ví dụ: khách hàng VIP hàng tháng). Dưới đây là sketch code:

from agentpay_vn import AgentPayClient
from datetime import datetime, timedelta
import asyncio

client = AgentPayClient(
    merchant_id="VIP_SUBSCRIPTION",
    bank_account="1234567890",
    bank_code="MB"
)

async def create_monthly_subscription(customer_name, monthly_fee):
    """
    Tạo subscription hàng tháng.
    Lưu ý: AgentPay VN hiện chưa hỗ trợ auto-debit, 
    nhưng bạn có thể:
    1. Lưu subscription trong DB
    2. Hàng tháng tạo payment request tự động
    3. Gửi reminder cho khách qua bot
    """

    # Mỗi tháng, tạo yêu cầu mới
    subscription_id = f"sub_{customer_name}_{datetime.now().month}"

    payment = await client.create_payment_request(
        amount=monthly_fee,
        description=f"Subscription VIP - Tháng {datetime.now().month}",
        order_id=subscription_id,
        metadata={
            "subscription_type": "monthly",
            "customer": customer_name
        }
    )

    # Gửi reminder qua bot
    print(f"🔔 Nhắc nhở {customer_name}: Thanh toán VIP tháng này")
    print(f"Link: {payment.checkout_url}")

    return payment

Tóm Tắt Nhanh

Bước Tiếp Theo

Bạn đã sẵn sàng để AI của mình nhận tiền?

  1. Cài đặt SDK: bash pip install agentpay-vn

  2. Đọc tài liệu đầy đủ và API reference: https://agentpay.servicesai.vn/v1/docs

  3. Xem GitHub repo (code mẫu, issues, discussions): https://github.com/phuocdu/agentpay-vn

  4. Thử ngay: Tạo merchant ID đầu tiên, test với số tiền nhỏ, sau đó scale up

Hôm nay là ngày AI của bạn có thể bắt đầu kiếm tiền. Không cần chờ đợi, không cần gateway phức tạp—chỉ cần Python và tư duy sáng tạo.

Chúc bạn thành công! 🚀

Bắt đầu →

← Tất cả bài