Xây dựng với AI Coding Agents - Dodo Payments Documentation

Dodo Agent Plugin kết nối hai máy chủ MCP và tám kỹ năng tích hợp vào agent coding AI của bạn trong một lần cài đặt. Nó hoạt động với Claude Code, Codex CLI, Cursor, và OpenCode — và các máy chủ MCP và kỹ năng CLI hoạt động với bất kỳ client tương thích MCP nào.

Ba nguyên thủy, một plugin. Agent Plugin tổng hợp mọi thứ bạn cần:

API MCP server — truy cập trực tiếp vào thanh toán, đăng ký, khách hàng, sản phẩm, hoàn tiền, giấy phép, và sử dụng. Xác thực qua OAuth trình duyệt (không cần khóa cục bộ).
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 thông tin xác thực.
Tám kỹ năng agent — các ghi chú tóm tắt mà agent của bạn nạp khi cần cho quy trình thanh toán, đăng ký, webhooks, hóa đơn dựa trên sử dụng, hóa đơn dựa trên tín dụng, khóa giấy phép, BillingSDK, và các thực tiễn tốt nhất.

Cài đặt plugin

Chọn agent coding của bạn bên dưới. Việc cài đặt tự động thêm cả hai máy chủ MCP và tất cả tám kỹ năng.

Claude Code

Cài đặt từ marketplace:

claude plugins marketplace add dodopayments/dodo-agent-plugin
claude plugins install dodopayments@dodopayments

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 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.

codex plugin marketplace add dodopayments/dodo-agent-plugin

Install from the Codex TUI

Mở Codex và chạy lệnh slash /plugins:

codex

Sau đó nhập /plugins, chuyển sang marketplace Dodo Payments, chọn plugin dodopayments, và chọn Cài đặt plugin.

Cả các máy chủ MCP và tám kỹ năng đều được đăng ký tự động ngay khi plugin được cài đặt.

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.

Nếu bạn đã thêm marketplace trước đây và plugin không xuất hiện dưới /plugins, hãy làm mới nó:

codex plugin marketplace upgrade dodopayments

Cursor

Cài đặt thủ công — clone repo vào thư mục plugin cục bộ của Cursor:

git clone https://github.com/dodopayments/dodo-agent-plugin.git ~/.cursor/plugins/local/dodo-agent-plugin

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 phân phối qua npm. Thêm plugin vào opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@dodopayments/opencode-plugin"]
}

Khởi động lại OpenCode. Cả các máy chủ MCP (dodopayments-api, dodo-knowledge) đều được đăng ký tự động thông qua hook cấu hình của plugin, và tám kỹ năng được phát hiện tự động từ gói 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

Khi plugin được cài đặt, agent của bạn có quyền truy cập vào hai máy chủ MCP và tám kỹ năng.

Máy chủ MCP

Máy chủ	Mục đích	Xác thực
`dodopayments-api`	Truy cập API trực tiếp — thanh toán, đăng ký, khách hàng, sản phẩm, hoàn tiền, giấy phép, sử dụng	OAuth (trình duyệt)
`dodo-knowledge`	Tìm kiếm ngữ nghĩa trong tất cả tài liệu của Dodo Payments	Không

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	Mô tả
`best-practices`	Hướng dẫn toàn diện về tích hợp Dodo Payments với các phương pháp tốt nhất
`checkout-integration`	Tạo các phiên checkout và luồng thanh toán
`subscription-integration`	Triển khai các luồng thanh toán đăng ký
`webhook-integration`	Thiết lập và xử lý các webhook cho các sự kiện thanh toán
`usage-based-billing`	Triển khai thanh toán theo metering với các sự kiện và đồng hồ
`credit-based-billing`	Quyền lợi tín dụng, số dư, và khấu trừ tín dụng theo metering
`license-keys`	Quản lý các khoá cấp phép cho sản phẩm kỹ thuật số
`billing-sdk`	Sử dụng các thành phần React của BillingSDK

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ử:

Set up Dodo Payments webhook handlers in my Next.js app for payment.succeeded and subscription.active events.

Agent của bạn sẽ tải kỹ năng 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:

Agent	Đường dẫn nhanh nhất	Cũng hỗ trợ
Claude Code	Agent Plugin (một lệnh)	Máy chủ MCP, kỹ năng cá nhân
Codex CLI	Agent Plugin (một lệnh)	Máy chủ MCP
Cursor	Agent Plugin (git clone)	Cấu hình máy chủ MCP, CLI kỹ năng
OpenCode	Agent Plugin (npm)	Cấu hình máy chủ MCP, CLI kỹ năng
GitHub Copilot (VS Code)	Hướng dẫn MCP Server	Skills CLI
Claude Desktop	Hướng dẫn MCP Server	—
Windsurf	Hướng dẫn MCP Server	Skills CLI
Cline / Zed / others	Hướng dẫn MCP Server	Skills CLI

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 .md và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 phiên thanh toán và liên kết thanh toán — Thanh toán một lần và đăng ký
Triển khai thanh toán theo đăng ký và dựa trên mức sử dụng từ đầu đến cuối — Đăng ký, Thanh toán dựa trên mức sử dụng, Thanh toán dựa trên tín dụng
Tạo các trình xử lý tuân thủ Standard Webhooks với xác minh chữ ký — Webhooks
Kết nối các thành phần BillingSDK React để quản lý bảng giá và đăng ký — BillingSDK
Viết luồng khóa giấy phép cho sản phẩm kỹ thuật số — Khóa giấy phép
Triển khai thanh toán dựa trên tín dụng với quyền lợi, số dư, chuyển tiếp và sử dụng quá mức — Tín dụng

Bảo mật và các phương pháp tốt nhất

Không bao giờ chuyển các khóa API sản xuất. Sử dụng chế độ thử nghiệm trong quá trình phát triển. Agent Plugin mặc định sử dụng OAuth qua trình duyệt — chỉ chuyển sang các khóa API cục bộ nếu quy trình làm việc của bạn yêu cầu.

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

Mở /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óa dodo_test_... hoặc dodo_live_... của bạn
dodo_webhook_key — bí mật chữ ký webhook của bạn
dodo_environment — test_mode hoặc live_mode

Sau đó chỉnh sửa .mcp.json để hướng dodopayments-api đến máy chủ stdio cục bộ:

{
  "mcpServers": {
    "dodopayments-api": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "${user_config.dodo_api_key}",
        "DODO_PAYMENTS_WEBHOOK_KEY": "${user_config.dodo_webhook_key}",
        "DODO_PAYMENTS_ENVIRONMENT": "${user_config.dodo_environment}"
      }
    }
  }
}

Chạy /reload-plugins để áp dụng thay đổi cho phiên hiện tại của bạn.

Local API key mode — OpenCode

Tự khai báo 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:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@dodopayments/opencode-plugin"],
  "mcp": {
    "dodopayments-api": {
      "type": "local",
      "command": ["npx", "-y", "dodopayments-mcp@latest"],
      "environment": {
        "DODO_PAYMENTS_API_KEY": "dodo_test_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "whsec_...",
        "DODO_PAYMENTS_ENVIRONMENT": "test_mode"
      },
      "enabled": true
    }
  }
}

Khởi động lại OpenCode để áp dụng.

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

Documentation Index

​Cài đặt plugin

Dodo Agent Plugin on GitHub

​Những gì bạn nhận được

​Máy chủ MCP

​Kỹ năng của Agent

​Thử nhắc nhở này trước

​Các agent hỗ trợ khác

​Tài liệu xây dựng cho các agent

​Những gì agent của bạn có thể làm

​Bảo mật và các phương pháp tốt nhất

​Cấu hình với khóa API

​Các bước tiếp theo

MCP Server

Agent Skills

Sentra IDE Assistant

API Reference

Cài đặt plugin

Những gì bạn nhận được

Máy chủ MCP

Kỹ năng của Agent

Thử nhắc nhở này trước

Các agent hỗ trợ khác

Tài liệu xây dựng cho các agent

Những gì agent của bạn có thể làm

Bảo mật và các phương pháp tốt nhất

Cấu hình với khóa API

Các bước tiếp theo