Kết nối Dodo Payments

Những gì bạn cần

Trường	Nó làm gì
API key	Cho phép chúng tôi gọi Dodo để tạo khâu thanh toán được lưu trữ. Bí mật.
Webhook signing secret (whsec_…)	Xác nhận một webhook thực sự đến từ Dodo. Bí mật.
Return URL	Nơi người mua đáp xuống sau khi thanh toán.

Cho phép tạo khâu thanh toán được lưu trữ, để khoản phí chạy qua tài khoản của bạn.

Chứng minh một webhook đến thực sự từ Dodo, nên không ai có thể giả mạo một sự kiện "đã trả tiền". Nó là một giá trị riêng tách khỏi API key.

Cài đặt thông thường: nơi người mua đáp xuống sau khi thanh toán. Không bí mật.

Dùng chế độ thử nghiệm (miễn phí)
Dodo có một môi trường thử nghiệm riêng. Khóa chế độ thử nghiệm chạy đối với host thử nghiệm của Dodo, và không có tiền thật nào di chuyển.
1. Đăng nhập tại app.dodopayments.com.
2. Dodo tách riêng khóa Live và Test. Thiết lập thử nghiệm trước, rồi lặp lại ở live.
Sao chép API key của bạn
Vào Developer → API Keys và sao chép khóa Test để kiểm chứng, hoặc khóa Live để nhận thanh toán thật.
Dodo → Developer → API Keys
Thêm webhook
1. Thêm một webhook trong Dodo.
2. Đặt URL webhook thành địa chỉ webhook dự án của bạn (bên dưới).
3. Sao chép webhook signing secret (whsec_…). Thêm một webhook riêng ở test và ở live.
```
https://api.coinmoebius.com/webhook/dodopayments/<your project id>
```
Dodo → Developer → Webhooks
Kết nối trong bảng điều khiển
Thêm nhà cung cấp → Dodo Payments. Nhập Return URL và nhóm Live (Live API key, Live webhook signing secret). Thêm nhóm Test tùy chọn để kiểm chứng trước. Nhóm Test đi theo cặp: thêm cả một test API key và một test webhook secret, hoặc để cả hai trống. Live và test được kiểm tra riêng.

Chạy một khoản thanh toán thử nghiệm trước khi chạy thật:

Tạo một sản phẩm và đặt Môi trường của nó thành Testing. Việc đó chạy sản phẩm trên thông tin xác thực test của bạn, nên bạn có thể đặt một đơn hàng đầy đủ mà không di chuyển tiền. (Nếu bạn bỏ qua bộ test, một sản phẩm Testing sẽ quay về live, nên hãy thêm nó trước.)
Đặt nút mua lên một trang (một tệp HTML cục bộ cũng được) trỏ về dự án của bạn.
Hoàn tất thanh toán ở chế độ thử nghiệm của Dodo.
Mở tab Giao dịch. Một hàng mới xuất hiện, gắn nhãn Testing. Khi trạng thái của nó đạt succeeded, thông tin xác thực và webhook của bạn đều hoạt động trọn vẹn đầu cuối.

Chuyển Môi trường sản phẩm sang Live khi bạn sẵn sàng cho thanh toán thật.

Bắt đầu với Xác minh. Trong bảng điều khiển, nhấp Xác minh (hoặc Xác minh thông tin xác thực thử nghiệm) để kiểm tra API key của bạn.

Thêm một test API key trong tab Test, lưu nhà cung cấp, rồi mở lại hộp thoại và xác minh.

Xác nhận URL webhook khớp và rằng signing secret khớp với webhook trong cùng môi trường (test secret cho test, live cho live).

Nhóm Test đi theo cặp: thêm cả một test API key và một test webhook secret, hoặc để cả hai trống.

Dodo Dashboard → Developer → Webhooks → Send Example (hoặc Dodo CLI) trỏ về URL webhook của bạn, rồi quan sát đơn hàng cập nhật.

Chỉ thanh toán một lần. Coin Moebius dùng Dodo cho các khoản thanh toán đơn lẻ, không phải gói đăng ký.

Xoay secret. Xoay API key hoặc webhook secret bất cứ lúc nào, rồi dán giá trị mới. Các trường bí mật vẫn để trống khi chỉnh sửa.