Checkout Page MCP

chính thức

Cho phép các ứng dụng AI thêm thanh toán vào trang web của bạn. Tạo trang thanh toán, sự kiện và biểu mẫu rồi nhúng chúng vào trang web của bạn chỉ trong vài phút.

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

  • Tạo trang thanh toán — Tạo, chỉnh sửa và liệt kê các trang thanh toán có giá, mô tả và trường mã giảm giá bằng create_checkout_page và update_checkout_page.
  • Thiết lập sự kiện và vé — Tạo sự kiện với các nhóm vé, loại vé và mức giá, sau đó cập nhật hoặc lưu trữ sự kiện khi tình hình bán vé thay đổi.
  • Tạo biểu mẫu và câu hỏi — Tạo biểu mẫu đăng ký và thêm, chỉnh sửa hoặc xóa câu hỏi bằng create_form và create_field.
  • Thêm sản phẩm mua kèm và mã giảm giá — Cung cấp các sản phẩm bổ sung như vé gửi xe, sắp xếp lại thứ tự và tạo mã giảm giá, chẳng hạn như mã giảm 20%.
  • Tùy chỉnh giao diện và nhúng trang — Áp dụng giao diện thương hiệu cho các trang và lấy mã nhúng, cửa sổ bật lên hoặc liên kết sẵn sàng để dán bằng add_to_website.
  • Tra cứu doanh số và khách hàng — Tìm các khoản thanh toán, gói đăng ký, lượt đặt chỗ, nội dung gửi qua biểu mẫu và hồ sơ khách hàng để giải đáp thắc mắc về thanh toán.

Tài liệu

Xây dựng trang thanh toán, sự kiện và biểu mẫu bằng công cụ AI của bạn với máy chủ MCP Checkout Page chính thức

Máy chủ MCP Checkout Page cho phép các công cụ AI như Claude, ChatGPT và Cursor xây dựng trang thanh toán, sự kiện và biểu mẫu trong tài khoản Checkout Page của bạn. Hãy mô tả sản phẩm bạn bán bằng ngôn ngữ thông thường. AI sẽ tạo trang, chỉnh sửa trang khi bạn yêu cầu và thêm trang vào trang web của bạn.

Máy chủ được xây dựng dựa trên Model Context Protocol, một tiêu chuẩn mở để kết nối trợ lý AI với các công cụ và dữ liệu mà chúng cần.

Đang xây dựng trang web bằng AI? Xem cách Checkout Page thêm tính năng thanh toán vào các trang web được xây dựng bằng AI.

URL của máy chủ là:

https://mcp.checkoutpage.com

Checkout Page MCP có thể làm gì?

Sau khi kết nối, bạn có thể yêu cầu công cụ AI thực hiện những việc như:

  • "Tạo trang thanh toán có tên 'Spring Workshop' với giá $99."
  • "Thiết lập sự kiện cho buổi dạ tiệc tháng 5 của chúng tôi, với vé Early bird giá $40 và vé Standard giá $60, giới hạn 200 chỗ."
  • "Tạo biểu mẫu đăng ký cho hội thảo trực tuyến tháng 5. Thu thập tên, email và phiên mà người tham dự muốn tham gia."
  • "Thêm câu hỏi 'Nhu cầu ăn uống' vào sự kiện dạ tiệc."
  • "Cung cấp vé đỗ xe giá $15 dưới dạng tiện ích bổ sung cho sự kiện dạ tiệc."
  • "Tạo mã giảm giá 20% tên SPRING20, hết hạn vào ngày 31 tháng 5."
  • "Chỉnh trang Spring Workshop theo thương hiệu của chúng tôi: nút màu xanh lá đậm và phông chữ serif cho tiêu đề."
  • "Thêm trang thanh toán Spring Workshop vào phần giá của trang web chúng tôi đang xây dựng, dưới dạng nút bật lên."
  • "Cho tôi xem 10 lượt đăng ký gần đây nhất cho hội thảo trực tuyến tháng 5."

AI của bạn sử dụng các công cụ bên dưới để tạo và chỉnh sửa trang thanh toán, sự kiện và biểu mẫu.

Các công cụ hiện có

Bạn có thể làm gìCông cụ
Tạo trang thanh toáncreate_checkout_page, update_checkout_page, get_checkout_page, list_checkout_pages
Tạo sự kiện và vécreate_event, update_event, get_event, list_events, create_ticket_group, update_ticket_group, archive_ticket_group, create_ticket_type, update_ticket_type, archive_ticket_type
Tạo biểu mẫucreate_form, update_form, get_form, list_forms
Thêm câu hỏi vào trangcreate_field, update_field, delete_field
Thiết lập sản phẩmcreate_product, update_product, delete_product, get_product, list_products
Cung cấp ưu đãi mua thêm và tiện ích bổ sungcreate_order_bump, update_order_bump, delete_order_bump, reorder_order_bumps, list_order_bumps
Tạo mã giảm giácreate_coupon, update_coupon, list_coupons
Tính thuếcreate_tax_rate, list_tax_rates
Tạo kiểu cho trang bằng giao diệncreate_theme, update_theme, delete_theme, get_theme, list_themes, list_theme_properties
Tải hình ảnh và tệp lênupload_file
Đưa trang lên trang web của bạnadd_to_website: mã sẵn sàng dán để nhúng, tạo nút bật lên hoặc liên kết
Tra cứu khoản thanh toán và gói đăng kýlist_payments, get_payment, list_subscriptions, get_subscription, list_subscription_payments, get_subscription_payment, prepare_subscription_cancellation
Tra cứu lượt đặt chỗ và người tham dựlist_bookings, get_booking, create_booking, list_tickets, update_ticket
Tra cứu nội dung gửi qua biểu mẫulist_submissions, get_submission
Tra cứu khách hàng và hóa đơnlist_customers, get_customer, update_customer, list_invoices, get_invoice, regenerate_invoice
Gửi sự kiện đến máy chủ của riêng bạncreate_webhook, update_webhook, delete_webhook, get_webhook, list_webhooks

prepare_subscription_cancellation không hủy bất cứ thứ gì. Công cụ này kiểm tra gói đăng ký và cung cấp liên kết đến trang tổng quan để bạn tự hủy. create_booking phát hành vé thật và gửi email xác nhận mà không thu tiền qua thẻ.

Trước khi bắt đầu

Bạn cần có tài khoản Checkout Page. Máy chủ MCP sử dụng OAuth nên bạn không cần sao chép hay dán khóa API. Lần đầu kết nối, công cụ AI sẽ hướng dẫn bạn đăng nhập chỉ bằng một cú nhấp.

Kết nối công cụ AI của bạn

Mỗi công cụ AI có màn hình cài đặt riêng để thêm trình kết nối. Chọn công cụ của bạn bên dưới. Các bước chỉ mất khoảng một phút. Sau khi kết nối, hãy thử câu lệnh kiểm tra ở cuối mỗi mục để xác nhận mọi thứ hoạt động.

ChatGPT

Checkout Page có trong thư mục plugin của ChatGPT:

  1. Mở plugin Checkout Page trong ChatGPT.
  2. Nhấp Connect, sau đó đăng nhập vào Checkout Page.

Hoặc thêm công cụ này làm trình kết nối tùy chỉnh trong Developer mode:

  1. Mở ChatGPT.com và vào Settings → Security and login. Bật Developer mode.
  2. Đóng phần cài đặt rồi truy cập chatgpt.com/plugins.
  3. Nhấp vào dấu + ở góc trên bên phải.
  4. Nhập:
  5. Bật I understand and want to continue.
  6. Nhấp Create, sau đó làm theo quy trình OAuth của Checkout Page để kết nối.
  7. Bắt đầu một cuộc trò chuyện mới.
  8. Nhấp + và tìm Checkout Page.

Kiểm tra: hỏi "Liệt kê các trang thanh toán, sự kiện và biểu mẫu của tôi trong Checkout Page."

Claude

  1. Mở Claude và vào Settings → Connectors.
  2. Nhấp Add custom connector.
  3. Nhập:
  4. Nhấp Add, sau đó nhấp Connect trên trình kết nối Checkout Page và đăng nhập.

Kiểm tra: hỏi "Liệt kê các trang thanh toán, sự kiện và biểu mẫu của tôi trong Checkout Page."

Cursor

Cách nhanh nhất là cài đặt bằng một cú nhấp:

Hoặc thêm thủ công:

  1. Mở Cursor, rồi vào Settings → MCP.
  2. Nhấp Add new MCP server.
  3. Nhập:
  4. Nhấp Save, sau đó đăng nhập qua lời nhắc OAuth.

Kiểm tra: trong cuộc trò chuyện của Cursor, hỏi "Liệt kê các trang thanh toán, sự kiện và biểu mẫu của tôi trong Checkout Page."

VS Code

GitHub Copilot Chat và tiện ích MCP chính thức đều hỗ trợ máy chủ của chúng tôi.

  1. Mở VS Code và chạy lệnh MCP: Add Server từ Command Palette (Cmd/Ctrl + Shift + P).
  2. Chọn HTTP.
  3. Nhập URL: https://mcp.checkoutpage.com
  4. Đặt tên: checkoutpage
  5. Đăng nhập qua lời nhắc OAuth mở trong trình duyệt.

Kiểm tra: trong Copilot Chat, hỏi "Liệt kê các trang thanh toán, sự kiện và biểu mẫu của tôi trong Checkout Page."

Codex

Trong Codex CLI, một lệnh sẽ thêm máy chủ và bắt đầu quy trình đăng nhập:

codex mcp add checkoutpage --url https://mcp.checkoutpage.com

Hoặc thêm máy chủ trong ứng dụng Codex:

  1. Mở Codex và vào Settings → MCP servers.
  2. Nhấp + Add server.
  3. Chọn Streamable HTTP làm phương thức truyền tải.
  4. Nhập:
  5. Nhấp Save, sau đó đăng nhập qua lời nhắc OAuth.

Kiểm tra: hỏi "Liệt kê các trang thanh toán, sự kiện và biểu mẫu của tôi trong Checkout Page."

Claude Code

Thực hiện hai bước: thêm máy chủ, sau đó đăng nhập từ bên trong Claude Code.

claude mcp add --transport http checkoutpage https://mcp.checkoutpage.com

Sau đó bắt đầu một phiên:

claude

Trong phiên:

  1. Nhập /mcp.
  2. Dùng các phím mũi tên để tô sáng checkoutpage rồi nhấn enter.
  3. Chọn authenticate và làm theo lời nhắc OAuth.

Kiểm tra: hỏi "Liệt kê các trang thanh toán, sự kiện và biểu mẫu của tôi trong Checkout Page."

Lovable

  1. Trong Lovable, mở Connectors và chọn nút +.
  2. Chọn MCP server.
  3. Nhập:
  4. Giữ nguyên OAuth, nhấp Add & authorize, sau đó đăng nhập vào Checkout Page.

Kiểm tra: hỏi "Liệt kê các trang thanh toán, sự kiện và biểu mẫu của tôi trong Checkout Page."

Cline

  1. Trong bảng Cline, nhấp biểu tượng MCP Servers trên thanh công cụ phía trên.
  2. Mở thẻ Remote Servers.
  3. Nhập:
  4. Nhấp Add Server. Cline sẽ mở thẻ Configure.
  5. Nhấp Authenticate trên máy chủ checkoutpage, sau đó đăng nhập vào Checkout Page trong trình duyệt.

Kiểm tra: trong Cline, hỏi "Liệt kê các trang thanh toán, sự kiện và biểu mẫu của tôi trong Checkout Page."

Các công cụ AI khác

Bất kỳ ứng dụng khách nào hỗ trợ MCP đều có thể kết nối với https://mcp.checkoutpage.com bằng OAuth. Nếu công cụ yêu cầu phương thức truyền tải, hãy chọn Streamable HTTP. Hầu hết ứng dụng khách đều chấp nhận cấu hình sau:

{
  "mcpServers": {
    "checkoutpage": {
      "url": "https://mcp.checkoutpage.com"
    }
  }
}

Câu lệnh mẫu

Ra mắt sản phẩm mới

Bạn đang chuẩn bị tổ chức một hội thảo mới và muốn nhanh chóng đưa trang thanh toán cùng ưu đãi giảm giá cho người đăng ký sớm vào hoạt động.

Dán nội dung này vào công cụ AI của bạn:

Create a checkout page called "Pricing Strategy Workshop" priced at $199. Write a confident product description (3–4 sentences) that pitches a half-day workshop for founders and product leaders who want to raise prices without losing customers. Turn on the coupon code field so customers can apply discounts. Then create a coupon code EARLYBIRD that takes 20% off and expires May 15. Send me both the checkout URL and the coupon code when you're done.

Trợ lý gọi create_checkout_page (kèm mô tả bằng văn bản và bật trường mã giảm giá), sau đó gọi create_coupon, rồi trả về URL thanh toán đang hoạt động và mã giảm giá.

Bạn có thể áp dụng cách tương tự cho mọi ưu đãi mới: ra mắt khóa học, trang đăng ký dùng thử hoặc chương trình khuyến mãi có thời hạn.

Thiết lập sự kiện có bán vé

Bạn đang tổ chức một buổi dạ tiệc và muốn mở bán vé ngay hôm nay, với giá ưu đãi cho người đăng ký sớm và một câu hỏi dành cho mỗi khách.

Dán nội dung này vào công cụ AI của bạn:

Create an event called "Spring Gala" on May 16 at 7:00 PM at the Riverside Hall. Add two ticket types: "Early bird" at $40 and "Standard" at $60, with 200 tickets in total. Ask each guest for their dietary needs. Write a short, warm description of the evening, then send me the event link.

Trợ lý gọi create_event với nhóm vé, cả hai loại vé và câu hỏi về nhu cầu ăn uống, rồi trả về liên kết sự kiện đang hoạt động. Sau đó, bạn có thể yêu cầu thêm loại vé, đổi giá hoặc đóng bán vé ưu đãi sớm; trợ lý sẽ gọi update_event hoặc update_ticket_type.

Thêm trang thanh toán vào trang web bạn đang xây dựng

Bạn đang xây dựng trang web bằng công cụ AI như Lovable, Bolt, v0, Cursor hoặc Claude Code và muốn khách hàng mua hàng ngay trên trang.

Dán nội dung này vào công cụ AI của bạn:

Create a checkout page called "Pricing Strategy Workshop" priced at $199, then add it to the pricing section of this website as an inline embed.

Trợ lý gọi create_checkout_page, sau đó gọi add_to_website và thêm mã nhúng vào trang web của bạn. Nếu trang web được xây dựng bằng React, trợ lý sẽ dùng thành phần React; nếu không, trợ lý sẽ dùng HTML thuần. Thay vào đó, hãy yêu cầu tạo nút bật lên nếu bạn muốn khách hàng ở lại trang cho đến khi họ nhấp vào nút.

Kiểm tra trang thanh toán

Trước khi ra mắt, bạn muốn tự mua hàng qua trang thanh toán và xem chính xác khách hàng sẽ nhận được gì mà không phải trả tiền.

Dán nội dung này vào công cụ AI của bạn:

Test my "Pricing Strategy Workshop" checkout page in Checkout Page test mode. Put the page in test mode, open it in the browser and buy it with the test card 4242 4242 4242 4242 and a new email address. Then find the test payment it created and check that it's marked livemode false. Switch test mode back off when you're done, and tell me what you bought and what you found.

Trợ lý gọi list_checkout_pages để tìm trang và update_checkout_page cùng với testmode: true, thanh toán trong trình duyệt, gọi list_payments cùng với livemode: false để tìm khoản thanh toán thử nghiệm, rồi gọi lại update_checkout_page để tắt chế độ thử nghiệm.

Bạn có thể áp dụng cách tương tự cho sự kiện hoặc biểu mẫu, hoặc để kiểm tra webhook hay tích hợp có hoạt động trước khi bạn dựa vào chúng hay không.

Trả lời câu hỏi về thanh toán của khách hàng

Một khách hàng gửi email hỏi khi nào khoản thanh toán tiếp theo sẽ được trừ và bạn muốn soạn câu trả lời để gửi lại chỉ trong vài giây.

Dán câu hỏi của họ vào công cụ AI:

A customer named Jane Smith (jane@example.com) just emailed asking: "When is my next payment, and how much will I be charged?" Look up her account in Checkout Page, find her active subscription, and draft a friendly reply I can send back. Include the next billing date and the amount.

Trợ lý gọi list_customers để tìm Jane theo email, sau đó gọi list_subscriptions để lấy thông tin gói đang hoạt động của cô ấy, rồi soạn câu trả lời sẵn sàng gửi với ngày thanh toán tiếp theo và số tiền.

Bạn có thể áp dụng cách tương tự cho yêu cầu hoàn tiền, gửi lại biên nhận hoặc bất kỳ câu hỏi hỗ trợ riêng lẻ nào cần thông tin tài khoản.

Mẹo để có kết quả tốt hơn

  • Yêu cầu AI viết nội dung cho bạn: tiêu đề sản phẩm, mô tả, thông báo xác nhận. Nếu không, các trang có thể trống hoặc chung chung.
  • Nêu rõ những cài đặt mà AI không thể tự đoán (ví dụ: "bật trường mã giảm giá").
  • Tập trung vào các bản ghi cụ thể và tác vụ tạo mới. Trợ lý AI kém tin cậy hơn khi tính tổng và xếp hạng ("5 trang có doanh thu cao nhất") vì việc đó đòi hỏi đọc mọi khoản thanh toán. Với những số liệu như vậy, hãy dùng chế độ xem phân tích trong trang tổng quan.
  • Một số cài đặt chưa được hỗ trợ qua MCP. Nếu yêu cầu không có hiệu lực, hãy mở trang trong trang tổng quan để hoàn tất thay đổi.

Chế độ thử nghiệm

Trợ lý có thể thực hiện giao dịch mua thử nghiệm trên trang thanh toán, sự kiện hoặc biểu mẫu mà không phải trả tiền, sau đó kiểm tra những gì đã tạo. Xem Chế độ thử nghiệm để biết cách hoạt động.

  • Bật và tắt chế độ này. create_checkout_page, create_event và create_form, cùng các công cụ update_* tương ứng, nhận testmode: true hoặc testmode: false. list_checkout_pages, list_events và list_forms nhận testmode: true để tìm các trang vẫn đang ở chế độ thử nghiệm.
  • Đọc bản ghi thử nghiệm. Các công cụ liệt kê và lấy thông tin cho khoản thanh toán, lượt đặt chỗ, gói đăng ký, khoản thanh toán gói đăng ký, hóa đơn và nội dung gửi, cùng với list_tickets, nhận livemode: false. Nếu không có tham số này, chúng chỉ trả về bản ghi thực tế.

Khi công cụ AI kết nối, máy chủ cũng cung cấp cho trợ lý hướng dẫn ngắn về chế độ thử nghiệm để bạn có thể yêu cầu bằng ngôn ngữ thông thường.

Lời nhắc kiểm thử

Hai lời nhắc sẽ chạy toàn bộ quy trình kiểm thử. Chúng xuất hiện dưới dạng lệnh gạch chéo hoặc lời nhắc trong các công cụ AI hỗ trợ lời nhắc MCP. Ví dụ, trong Claude Code, hãy nhập /mcp__checkoutpage__ rồi chọn một lời nhắc.

Lời nhắcChức năngĐối số
test_checkoutChuyển trang thanh toán, sự kiện hoặc biểu mẫu sang chế độ kiểm thử, thực hiện giao dịch mua thử trong trình duyệt, kiểm tra các bản ghi, rồi khôi phục chế độ kiểm thử về trạng thái ban đầu.pageId, và tùy chọn pageType: checkout (mặc định), event hoặc form
test_upsell_funnelChuyển cả hai trang của phễu bán thêm một lần nhấp hiện có sang chế độ kiểm thử, chạy phễu một lần bằng cách chấp nhận và một lần bằng cách từ chối ưu đãi, kiểm tra các bản ghi, rồi khôi phục chế độ kiểm thử về trạng thái ban đầu. Lời nhắc này không tạo trang.initialPageId, và tùy chọn upsellPageId

Ví dụ: để kiểm thử một sự kiện trong Claude Code, hãy nhập tên lời nhắc, id của sự kiện và loại trang:

/mcp__checkoutpage__test_checkout {eventId} event

Đối với phễu, xem Kiểm thử phễu bán thêm.

Để thanh toán, trợ lý của bạn cần một công cụ trình duyệt, chẳng hạn như Claude in Chrome, máy chủ Playwright MCP hoặc chế độ tác nhân của ChatGPT. Nếu không có công cụ này, trợ lý sẽ cung cấp liên kết để bạn tự thanh toán, rồi tiếp tục kiểm tra các bản ghi.

Khắc phục sự cố

Bảo mật và quyền riêng tư

  • Máy chủ MCP chỉ thay mặt bạn thực hiện thao tác sau khi bạn đăng nhập qua OAuth.
  • Token được giới hạn trong tài khoản của bạn. Bạn có thể thu hồi quyền truy cập bất cứ lúc nào trong phần cài đặt Checkout Page.
  • Các công cụ đọc (list_*, get_*) không bao giờ thay đổi dữ liệu. Các công cụ ghi (create_*, update_*, upload_*, archive_*, reorder_*) và công cụ phá hủy (delete_*) được đặt tên rõ ràng để trợ lý có thể hỏi trước khi thực hiện thay đổi. Không thể hoàn tác thao tác xóa, vì vậy hãy xác nhận trước khi trợ lý chạy công cụ delete_*.
  • Dữ liệu mà trợ lý tra cứu (thông tin khách hàng, thông tin thanh toán) được gửi đến công cụ AI của bạn để tạo phản hồi, tương tự cách hoạt động của mọi trình kết nối khác. Hãy chọn các công cụ AI có chính sách xử lý dữ liệu phù hợp với nhu cầu của bạn.