Giao diện dòng lệnh chính thức cho Dodo Payments — quản lý tài nguyên, chạy truy vấn sử dụng AI, tạo phiên thanh toán, và kiểm tra webhooks từ terminal của bạn.
Use this file to discover all available pages before exploring further.
Quản lý tài nguyên Dodo Payments của bạn, chạy truy vấn sử dụng AI đối với tài khoản của bạn, tạo phiên thanh toán, và kiểm tra webhooks — tất cả từ terminal. CLI đi kèm với một TUI tương tác, trợ lý AI tích hợp do MCP cung cấp và kiểm tra webhook ngoại tuyến.
TUI tương tác — khởi chạy dodo mà khô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.
Trợ lý AI tích hợp sẵn — hỏi câu hỏi hoặc thực hiện hành động bằng tiếng Anh đơn giản với /ai. Không cần thiết lập thêm, chạy dodopayments-mcp tại chỗ.
Bảo mật mặc định — API keys được lưu trữ trong kho bí mật của hệ điều hành của bạn (macOS Keychain, Windows Credential Vault, Linux libsecret). Không có cấu hình văn bản đơn giả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 cho bạn trong ứng dụng. Chạy /update để nâng cấp tại chỗ.
Công cụ Webhook — lắng nghe các webhook trực tiếp hoặc kích hoạt tải trọng offline cho phát triển cục bộ.
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:
dodo login
Hoặc từ bên trong TUI tương tác:
/login
Lưu đồ đăng nhập sẽ:
Mở trình duyệt của bạn tới trang API Keys của Dodo Payments.
Nhắc bạn dán API Key của bạn.
Yêu cầu bạn chọn một môi trường — Test Mode hoặc Live Mode.
Lưu thông tin đăng nhập trong kho bí mật của hệ điều hành của bạn (Keychain trên macOS, Credential Vault trên Windows, libsecret trên Linux).
Vì thông tin đăng nhập được lưu trữ 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ị của bạn lần đầu tiên CLI đọc hoặc ghi thông tin đăng nhập. Nếu bạn nâng cấp từ phiên bản cũ hơn, bất kỳ API key văn bản thuần túy nào hiện có sẽ được di chuyển vào kho bí mật và tệp cũ sẽ được xóa tự động.
Hỏi câu hỏi hoặc thực hiện hành động bằng ngôn ngữ tự nhiên. Trợ lý sử dụng dodopayments-mcp chạy tại chỗ — không cần thiết lập thêm hoặc quy trình OAuth, và lưu lượng AI của bạn không rời khỏi máy của bạn ngoại trừ để nói chuyện với nhà cung cấp mô hình.
Lệnh
Mô tả
/ai <query>
Hỏi trợ lý AI một câu hỏi hoặc đưa ra một hướng dẫn
(bất kỳ văn bản không phải dấu gạch chéo)
Được gửi đến trợ lý AI theo mặc định trong khi ở TUI
Ví dụ:
how much revenue did I make this week?/ai create a new customer named Acme Inc./ai find my last failed payment
Trợ lý tôn trọng môi trường hoạt động của bạn (Test / Live), vì vậy nó chỉ hoạt động trên dữ liệu từ môi trường bạn đang đăng nhập vào.
CLI bao gồm hai công cụ mạnh mẽ để kiểm tra webhooks trong quá trình phát triển: một listener chuyển tiếp các webhook kiểm tra trực tiếp đến máy chủ cục bộ của bạn, và một trigger gửi tải trọng webhook giả đến bất kỳ điểm cuối nào.
Lệnh
Mô tả
dodo wh listen
Lắng nghe các webhooks theo thời gian thực và chuyển tiếp chúng đến máy chủ phát triển cục bộ của bạn
dodo wh trigger
Kích hoạt sự kiện webhook kiểm tra tương tác — ngay cả khi đã đăng xuất
Chuyển tiếp webhooks từ Dodo Payments trực tiếp đến máy chủ phát triển cục bộ của bạn theo thời gian thực.
dodo wh listen
1
Enter your local endpoint URL
Cung cấp URL cục bộ nơi bạn muốn nhận webhooks (ví dụ: http://localhost:3000/webhook).
2
Automatic setup
CLI tự động tạo một điểm cuối webhook trên tài khoản Dodo Payments của bạn nếu chưa có, sau đó mở kết nối WebSocket để nhận các sự kiện theo thời gian thực.
3
Receive and forward
Khi một sự kiện webhook bắn ra (từ một thanh toán thử nghiệm, thay đổi đăng ký, v.v.), CLI nhận, đăng nhập loại sự kiện và chuyển tiếp yêu cầu đầy đủ với tiêu đề và nội dung thân đến điểm cuối cục bộ của bạn. Phản hồi từ điểm cuối của bạn được ghi lại và gửi lại.
dodo wh listen yêu cầu một khóa API Test Mode. Khóa Live Mode không được hỗ trợ bởi lưu đồ lắng nghe.
Listener bảo lưu các tiêu đề webhook gốc (webhook-id, webhook-signature, webhook-timestamp) khi chuyển tiếp đến điểm cuối cục bộ của bạn, để bạn có thể kiểm tra logic xác minh chữ ký của mình.
Gửi tải trọng webhook giả mạo đến bất kỳ điểm cuối nào để kiểm tra nhanh mà không cần tạo các giao dịch thực tế.
dodo wh trigger
Lưu đồ /wh trigger hướng dẫn bạn qua:
Thiết lập một điểm cuối URL đích
Chọn một sự kiện cụ thể để kích hoạt từ menu tương tác
dodo wh trigger không yêu cầu đăng nhập. Nó hoạt động như một trình tạo tải webhook cục bộ/ngoại tuyến.
Các sự kiện được kích hoạt không được ký. Trong khi kiểm tra, vô hiệu hóa xác minh chữ ký webhook trên điểm cuối của bạn — ví dụ, sử dụng unsafe_unwrap() thay vì unwrap() trong bộ xử lý webhook của bạn chỉ khi kiểm tra.
