Giao diện dòng lệnh để tương tác với API Dodo Payments từ terminal của bạn
Quản lý tài nguyên Dodo Payments của bạn, tạo phiên thanh toán và kiểm tra webhook trực tiếp từ terminal. Được thiết kế cho các nhà phát triển ưa thích giao diện dòng lệnh.
Trước khi sử dụng CLI, hãy xác thực bằng khóa API của bạn:
dodo login
Điều này sẽ:
Mở trình duyệt đến trang Khóa API Dodo Payments
Yêu cầu bạn nhập Khóa API
Yêu cầu bạn chọn môi trường (Chế độ Test hoặc Chế độ Live)
Lưu thông tin xác thực cục bộ vào ~/.dodopayments/api-key
CLI hỗ trợ lưu một khóa API cho mỗi môi trường. Nếu cả khóa chế độ Test và chế độ Live được cấu hình, bạn sẽ được nhắc chọn môi trường để sử dụng cho phiên hiện tại.
Chạy dodo không có đối số sẽ hiển thị tất cả các hạng mục hiện có. Chạy dodo <category> không có lệnh con sẽ hiển thị các lệnh con sẵn có cho danh mục đó.
CLI bao gồm hai công cụ mạnh mẽ để kiểm tra webhook trong quá trình phát triển: một listener chuyển tiếp webhook thử nghiệm trực tiếp đến máy chủ cục bộ của bạn, và một trigger gửi các payload webhook giả đến bất kỳ endpoint nào.
Chuyển tiếp webhook từ Dodo Payments trực tiếp tới 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 webhook (ví dụ: http://localhost:3000/webhook).
2
Automatic setup
CLI tự động tạo một endpoint 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 sự kiện theo thời gian thực.
3
Receive and forward
Khi một sự kiện webhook xảy ra (từ một thanh toán thử nghiệm, thay đổi đăng ký, v.v.), CLI sẽ nhận, ghi lại loại sự kiện và chuyển tiếp toàn bộ yêu cầu với tiêu đề và nội dung đến endpoint cục bộ của bạn. Phản hồi từ endpoint cũng được ghi lại và gửi lại.
Bộ lắng nghe webhook chỉ hoạt động với khóa API chế độ thử nghiệm. Hãy chắc chắn bạn đang đăng nhập với khóa chế độ thử nghiệm trước khi sử dụng dodo wh listen.
Bộ lắng nghe giữ nguyên các tiêu đề webhook gốc (webhook-id, webhook-signature, webhook-timestamp) khi chuyển tiếp tới endpoint cục bộ của bạn, giúp bạn kiểm tra logic xác minh chữ ký.
Gửi payload webhook giả đến bất kỳ endpoint nào để kiểm tra nhanh mà không cần tạo giao dịch thật.
dodo wh trigger
Điều này hướng dẫn bạn qua:
Thiết lập endpoint URL đích
Tùy chọn cấu hình Business ID, Product ID, và Metadata
Chọn một sự kiện cụ thể để kích hoạt từ menu tương tác
Gửi payload giả và xem phản hồi
Sau mỗi sự kiện, bạn có thể chọn sự kiện khác để kích hoạt hoặc thoát — giúp bạn dễ dàng kiểm tra nhiều bộ xử lý sự kiện trong một phiên.
Công cụ trigger gửi payload giả mà không có chữ ký webhook. Vô hiệu hóa việc xác minh chữ ký webhook trong quá trình thử nghiệm bằng cách sử dụng unsafe_unwrap() thay vì unwrap() trong trình xử lý webhook của bạn.
