Ba primitive, một plugin. Agent Plugin tích hợp mọi thứ bạn cần:
- API MCP server — truy cập trực tiếp vào payments, subscriptions, customers, products, refunds, licenses và usage. Xác thực qua browser OAuth (không cần local key).
- Knowledge MCP server — tìm kiếm ngữ nghĩa trên toàn bộ tài liệu Dodo Payments. Không cần credentials.
- Mười bảy agent skill — các cheat sheet mà agent tải theo yêu cầu cho checkout, subscriptions, webhooks, billing dựa trên usage và credit, license key, product catalog, discounts, localized pricing, mobile checkout, refunds và disputes, customer management, framework adapter, BillingSDK, Better Auth, testing và go-live, cùng các best practice.
Cài đặt plugin
Chọn coding agent bên dưới. Quá trình cài đặt sẽ tự động thêm cả hai MCP server và toàn bộ mười bảy skill.Claude Code
Claude Code
Cài đặt từ marketplace:Máy chủ API MCP sử dụng OAuth trình duyệt theo mặc định — không cần khóa cài đặt. Lần đầu tiên agent của bạn gọi công cụ Dodo, bạn sẽ được nhắc đăng nhập.
Dodo Agent Plugin on GitHub
Mã nguồn, tùy chọn cấu hình, và hướng dẫn phát triển cục bộ
Codex CLI
Codex CLI
Codex cài đặt plugin qua hai bước: đăng ký marketplace từ shell của bạn, sau đó cài đặt plugin từ bên trong Codex TUI.Cả hai MCP server và toàn bộ mười bảy skill sẽ được tự động đăng ký sau khi plugin được cài đặt.Nếu bạn đã thêm marketplace trước đây và plugin không xuất hiện dưới
1
Register the marketplace
2
Install from the Codex TUI
Mở Codex và chạy lệnh slash Sau đó nhập
/plugins:/plugins, chuyển sang marketplace Dodo Payments, chọn plugin dodopayments, và chọn Cài đặt plugin.Codex CLI không có lệnh con
codex plugin install — việc cài đặt plugin luôn được thực hiện thông qua dòng /plugins trong TUI. Xem tài liệu chính thức về plugin Codex./plugins, hãy làm mới nó:Cursor
Cursor
Cài đặt thủ công — clone repo vào thư mục plugin cục bộ của Cursor:Khởi động lại Cursor. Plugin tải các kỹ năng từ
.claude/skills/ (thông qua lớp tương thích Claude Code của Cursor) và các máy chủ MCP từ .mcp.json.Hỗ trợ marketplace của Cursor sẽ sớm có. Hiện tại, hãy sử dụng cài đặt thủ công trên.
OpenCode
OpenCode
OpenCode phân phối qua npm. Thêm plugin vào Khởi động lại OpenCode. Cả hai MCP server (
opencode.json:dodopayments-api, dodo-knowledge) được tự động đăng ký thông qua config hook của plugin, còn mười bảy skill được tự động phát hiện từ package đã cài đặt. Không cần block mcp thủ công.Sử dụng một agent khác? Hướng dẫn MCP Server và Agent Skills bao gồm Cursor, Claude Desktop, VS Code, Windsurf, Cline, Zed, và bất kỳ client tương thích nào với MCP.
Những gì bạn nhận được
Sau khi plugin được cài đặt, agent của bạn có quyền truy cập vào hai MCP server và mười bảy skill.Máy chủ MCP
Cả hai máy chủ được kết nối thông qua
mcp-remote để chúng chạy trong bất kỳ client nào tương thích với MCP.
Kỹ năng của Agent
Kỹ năng tải tự động — agent của bạn sẽ chọn cái phù hợp khi phát hiện nhiệm vụ liên quan. Xem tài liệu về Agent Skills để biết danh sách đầy đủ và cài đặt từng cái.
Thử nhắc nhở này trước
Khi plugin hoạt động, hãy thử:webhook-integration, sử dụng MCP dodo-knowledge để lấy các kiểu payload mới nhất, và viết một handler với xác minh chữ ký theo chuẩn Standard Webhooks.
Các agent hỗ trợ khác
Agent Plugin bao gồm Claude Code, Codex CLI, Cursor, và OpenCode. Nếu bạn sử dụng một agent khác, hãy kết nối với Dodo Payments thông qua các máy chủ MCP và CLI kỹ năng:Tài liệu xây dựng cho các agent
Mỗi trang tài liệu của Dodo Payments đều có sẵn ở định dạng tối ưu cho tiêu thụ AI:- Mục lục tài liệu đầy đủ:
docs.dodopayments.com/llms.txt— phục vụ chỉ mục tài liệu hoàn chỉnh để nhập cảnh. - Markdown đơn giản: Thêm
.mdvào bất kỳ URL tài liệu nào để có phiên bản markdown gốc (ví dụ:/api-reference/introduction.md). - Kho nguồn:
github.com/dodopayments/dodo-docs— clone để lập chỉ mục ngoại tuyến.
Những gì agent của bạn có thể làm
Với plugin được cài đặt, agent mã hóa của bạn có thể:- Tạo checkout session và payment link — Thanh toán một lần và subscription
- Thiết lập billing dựa trên subscription và usage từ đầu đến cuối — Subscriptions, Billing dựa trên usage, Billing dựa trên credit
- Tạo handler tương thích với Standard Webhooks kèm xác minh chữ ký — Webhooks
- Gắn route handler vào framework bằng các adapter chính thức — Framework adapter
- Kết nối component BillingSDK React cho pricing table và quản lý subscription — BillingSDK
- Xây dựng flow license key cho sản phẩm kỹ thuật số — License key
- Triển khai billing dựa trên credit với entitlement, số dư, rollover và overage — Credit
- Xây dựng và quản lý product catalog với add-on và collection — Product, Add-on, Product collection
- Thêm discount và localized pricing — Discount code, Localized pricing, Adaptive Currency
- Ra mắt checkout trong ứng dụng trên mobile cho React Native, Flutter, iOS và Android — Tích hợp mobile
- Xử lý refund, dispute và self-service cho customer — Refund, Dispute, Customer portal
- Kiểm thử integration và go-live an toàn — Test mode và live mode
Bảo mật và các phương pháp tốt nhất
- Sử dụng chế độ thử nghiệm trước. Cách ly tích hợp của bạn với các khóa
dodo_test_...trước khi hoạt động thực tế. Xem Chế độ thử nghiệm vs Chế độ hoạt động thực tế. - OAuth là mặc định. Agent Plugin xác thực qua OAuth trình duyệt (không có bí mật cục bộ). Chỉ sử dụng chế độ API-key nếu bạn cần — xem phần Cấu hình bên dưới.
- Xem xét mã do agent tạo ra. Luôn xác minh các webhook handler có chứa xác minh chữ ký theo chuẩn Standard Webhooks.
Cấu hình với khóa API
Mặc định, Agent Plugin sử dụng máy chủ MCP từ xa với OAuth trình duyệt — không cần thông tin đăng nhập cục bộ. Nếu quy trình làm việc của bạn yêu cầu khóa API cục bộ (ví dụ: môi trường CI, máy chủ headless), bạn có thể chuyển sang chế độ stdio.Local API key mode — Claude Code
Local API key mode — Claude Code
Mở Chạy
/plugins trong Claude Code, chọn Dodo Payments, và chọn Cấu hình tùy chọn. Điền vào:dodo_api_key— khóadodo_test_...hoặcdodo_live_...của bạndodo_webhook_key— bí mật chữ ký webhook của bạndodo_environment—test_modehoặclive_mode
.mcp.json để hướng dodopayments-api đến máy chủ stdio cục bộ:/reload-plugins để áp dụng thay đổi cho phiên hiện tại của bạn.Local API key mode — OpenCode
Local API key mode — OpenCode
Tự khai báo Khởi động lại OpenCode để áp dụng.
dodopayments-api trong opencode.json — mục nhập của bạn sẽ thắng trên máy chủ từ xa mặc định của plugin:Các bước tiếp theo
MCP Server
Tham khảo đầy đủ cho cả hai máy chủ MCP — tất cả các client được hỗ trợ, cấu hình và công cụ có sẵn
Agent Skills
Cài đặt kỹ năng cá nhân, tham khảo kỹ năng, và hướng dẫn thiết lập theo từng agent
Sentra IDE Assistant
Trợ lý thanh toán thông minh cho VS Code, Cursor, và Windsurf — hỏi, xây dựng, và lập kế hoạch trong trình soạn thảo của bạn
API Reference
Tham khảo OpenAPI đầy đủ cho tất cả các endpoint của Dodo Payments