Tính năng
- TUI tương tác — chạy
dodokhông có đối số để mở giao diện tương tác đầy đủ với bảng lệnh, lịch sử và thông báo trực tiếp. - Tích hợp sẵn trợ lý AI — đặt câu hỏi hoặc thực hiện thao tác bằng tiếng Anh thông thường với
/ai. Không cần thiết lập thêm, chạydodopayments-mcpcục bộ. - Bảo mật theo mặc định — API keys được lưu trong kho bí mật của hệ điều hành (macOS Keychain, Windows Credential Vault, Linux libsecret). Không lưu cấu hình dạng văn bản thuần trên đĩa.
- Tự động cập nhật — CLI kiểm tra phiên bản mới khi khởi động và thông báo trong ứng dụng. Chạy
/updateđể nâng cấp ngay tại chỗ. - Công cụ webhook — lắng nghe webhook trực tiếp hoặc kích hoạt payload ngoại tuyến cho việc phát triển cục bộ.
Cài đặt
Cài đặt CLI bằng một dòng lệnh trên macOS hoặc Linux:Cài đặt bằng npm hoặc Bun
Nếu bạn đã có Node hoặc Bun, các lệnh cài đặt bằng package manager luôn tải phiên bản mới nhất:Cài đặt thủ công (không yêu cầu Node / Bun)
Nếu bạn không muốn pipe một script từ xa vàosh, hãy tự tải binary xuống.
1
Download the binary
Tải binary dành cho nền tảng của bạn từ GitHub Release mới nhất.
2
Rename the binary to `dodo`
3
Move it to a directory on your PATH
Trên Windows, việc di chuyển đến
C:\Windows\System32 yêu cầu quyền quản trị viên.4
(Optional) Verify the download
Mỗi bản phát hành đều công bố một
SHA256SUMS.txt. Xác minh bản tải xuống bằng:Xác thực
Trước khi sử dụng các lệnh yêu cầu xác thực, hãy đăng nhập bằng API key của bạn:- Mở trình duyệt đến trang API Keys của Dodo Payments.
- Yêu cầu bạn dán API Key.
- Yêu cầu bạn chọn môi trường — Test Mode hoặc Live Mode.
- Lưu thông tin xác thực trong kho bí mật của hệ điều hành (Keychain trên macOS, Credential Vault trên Windows, libsecret trên Linux).
Vì thông tin xác thực được lưu trong kho bí mật của hệ điều hành, bạn có thể được yêu cầu nhập mật khẩu thiết bị lần đầu CLI đọc hoặc ghi thông tin xác thực. Nếu bạn nâng cấp từ phiên bản cũ, mọi API key dạng văn bản thuần hiện có sẽ được di chuyển sang kho bí mật và tự động xóa tệp cũ.
Chuyển đổi chế độ và đăng xuất
Bạn có thể xác thực đồng thời một key Test Mode và một key Live Mode. Để xóa thông tin xác thực:Cách sử dụng
Bạn có thể sử dụng CLI ở hai chế độ.1. TUI tương tác (khuyến nghị)
Chạydodo không có đối số để khởi chạy giao diện tương tác đầy đủ:
/ để mở bảng lệnh, hoặc chỉ cần bắt đầu nhập — mọi nội dung không phải slash command sẽ được gửi đến trợ lý AI.
2. Subcommand trực tiếp
Chạy lệnh trực tiếp mà không vào TUI:/; ở chế độ trực tiếp, bỏ tiền tố /.
Trợ lý AI
Đặt câu hỏi hoặc thực hiện thao tác bằng ngôn ngữ tự nhiên. Trợ lý sử dụngdodopayments-mcp chạy cục bộ — không cần thiết lập bổ sung hoặc quy trình OAuth, và lưu lượng AI của bạn không rời khỏi máy ngoại trừ khi giao tiếp với nhà cung cấp model.
Ví dụ:
Dựng khung dự án
dodo init dựng các route billing của Dodo Payments trực tiếp vào một dự án hiện có. Lệnh này tạo các tệp route boilerplate, cài đặt package adapter @dodopayments/* tương ứng và ghi an toàn các biến môi trường DODO_PAYMENTS_* vào .env (chỉ nối thêm các biến chưa tồn tại). Lệnh chạy mà không cần đăng nhập.
Đối với scaffold Better-Auth, bạn có thể truyền danh sách plugin phân tách bằng dấu phẩy để tạo (mặc định là tất cả):
checkout, portal, usage, webhooks.
Scaffolder tự động phát hiện thư mục
src/ và điều chỉnh các đường dẫn đầu ra tương ứng, đồng thời tự động phát hiện package manager của bạn (bun, pnpm, yarn hoặc npm) để chạy lệnh cài đặt phù hợp.Tài liệu tham khảo lệnh
Sản phẩm
Quản lý danh mục sản phẩm.Thanh toán
Xem các giao dịch thanh toán.Khách hàng
Quản lý cơ sở khách hàng.Discount
Quản lý coupon và discount.License
Quản lý license phần mềm.Addon
Quản lý addon sản phẩm.Hoàn tiền
Xem thông tin hoàn tiền.Checkout
Tạo các phiên checkout được lưu trữ.Webhook
CLI bao gồm hai công cụ mạnh để kiểm thử webhook trong quá trình phát triển: listener chuyển tiếp webhook kiểm thử trực tiếp đến server cục bộ của bạn và trigger gửi payload webhook giả lập đến bất kỳ endpoint nào.Lắng nghe webhook
Chuyển tiếp webhook từ Dodo Payments trực tiếp đến development server cục bộ của bạn theo thời gian thực.1
Enter your local endpoint URL
Cung cấp URL cục bộ nơi bạn muốn nhận webhook (ví dụ:
http://localhost:3000/webhook).2
Automatic setup
CLI tự động tạo webhook endpoint trên tài khoản Dodo Payments nếu endpoint chưa tồn tại, sau đó mở kết nối WebSocket để nhận sự kiện theo thời gian thực.
3
Receive and forward
Khi một sự kiện webhook được kích hoạt (từ giao dịch thanh toán kiểm thử, thay đổi subscription, v.v.), CLI tiếp nhận sự kiện, ghi lại loại sự kiện và chuyển tiếp toàn bộ request cùng headers và body đến endpoint cục bộ của bạn. Response từ endpoint của bạn được ghi lại và gửi ngược lại.
Kích hoạt webhook kiểm thử
Gửi payload webhook giả lập đến bất kỳ endpoint nào để kiểm thử nhanh mà không cần tạo giao dịch thực./wh trigger hướng dẫn bạn:
- Thiết lập endpoint URL đích
- Chọn một event cụ thể để kích hoạt từ menu tương tác
dodo wh trigger không yêu cầu đăng nhập. Đây là trình tạo payload webhook cục bộ/ngoại tuyến.Các sự kiện webhook được hỗ trợ
Biến môi trường
Cập nhật
CLI kiểm tra phiên bản mới hơn khi khởi động và hiển thị thông báo trên thanh trạng thái khi có phiên bản mới. Để nâng cấp:Tài nguyên
GitHub Repository
Xem mã nguồn và các bản phát hành
npm Package
Xem trên npm registry
Hỗ trợ
- Discord: Tham gia community server của chúng tôi
- GitHub: Mở issue trên repository
- Email: Liên hệ với chúng tôi qua support@dodopayments.com