Documentation Index
Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
Use this file to discover all available pages before exploring further.
Quyền lợi Discord thêm khách hàng trả tiền vào máy chủ của bạn (và tùy chọn gán cho họ một vai trò) ngay khi đăng ký của họ trở nên có hiệu lực hoặc thanh toán một lần của họ được xác nhận. Hủy bỏ, hoàn tiền và thay đổi gói sẽ tự động thu hồi vai trò.
Những gì được cung cấp
- Khách hàng kết nối tài khoản Discord của họ thông qua một liên kết OAuth trong email giao hàng hoặc cổng thông tin khách hàng của họ.
- Khi họ ủy quyền, Dodo Payments thêm họ vào máy chủ của bạn (hoặc tìm kiếm thành viên đã có) và gán vai trò bạn đã cấu hình.
- Nếu bạn không chọn một vai trò cụ thể, chỉ thành viên máy chủ được cấp.
Kết nối Discord
Open Entitlements
Trong bảng điều khiển Dodo Payments của bạn, đi đến Entitlements và nhấp vào + để bắt đầu một quyền lợi mới.
Pick Discord
Chọn Discord Access làm tích hợp. Nếu bạn chưa kết nối Discord cho doanh nghiệp của mình, bạn sẽ được yêu cầu Kết nối Discord.
Nhấn vào sẽ mở Discord trong một tab mới. Đăng nhập, chọn máy chủ bạn muốn kiểm soát truy cập, và xác nhận quyền của bot (Quản lý Vai trò, Kick Members, Create Invite) trên máy chủ đó.

Khi Discord chuyển hướng lại, bạn sẽ thấy xác nhận rằng máy chủ đã được kết nối.




Pick a server and role
Trở lại bảng điều khiển, chọn máy chủ (guild) bạn vừa kết nối. Tùy chọn chọn một vai trò để gán khi giao hàng, hoặc để trống để chỉ cấp thành viên máy chủ. Đặt tên cho quyền lợi và nhấp vào Tạo Quyền lợi.

Quy trình của khách hàng
- Khách hàng hoàn tất thanh toán.
- Dodo Payments tạo một quyền cấp ở trạng thái
pendingvới mộtoauth_urlchỉ vào Discord. - Khách hàng nhận được email với nút “Tham gia Discord” (liên kết OAuth). Liên kết cũng hiển thị trong cổng thông tin khách hàng của họ.
- Sau khi khách hàng ủy quyền, bot thêm họ vào máy chủ và gán vai trò đã cấu hình. Quyền cấp chuyển sang
delivered. - Nếu đăng ký bị hủy, tạm ngưng, hoặc hết hạn, hoặc nếu thương nhân thu hồi bằng tay, bot sẽ xóa vai trò và quyền cấp chuyển sang
revoked.
Cấu hình yêu cầu
| Trường | Bắt buộc | Mô tả |
|---|---|---|
guild_id | Có | ID máy chủ Discord. Bộ chọn bảng điều khiển sẽ điền thông tin này cho bạn. |
role_id | Không | Vai trò để gán khi giao hàng. Bỏ qua để chỉ có quyền truy cập thành viên máy chủ. |
Tạo qua API
Webhooks
Đăng ký sự kiện webhookentitlement_grant.* để theo dõi các quyền cấp trên Discord:
entitlement_grant.createdkích hoạt vớistatus: "pending"và mộtoauth_urlcho khách hàng ủy quyền.entitlement_grant.deliveredkích hoạt khi vai trò được gán.entitlement_grant.revokedkích hoạt khi vai trò bị xóa.
Khắc phục sự cố
Customer never sees the role assigned
Customer never sees the role assigned
Quyền cấp đang ở
pending cho đến khi khách hàng hoàn tất luồng OAuth. Kiểm tra danh sách quyền cấp của quyền lợi và xác nhận liệu họ đã nhấp vào liên kết OAuth chưa. Gửi lại email giao hàng nếu cần.Grant moves to failed with permission errors
Grant moves to failed with permission errors
Đảm bảo bot Dodo Payments vẫn ở trong máy chủ, có quyền
Manage Roles, và được đặt cao hơn vai trò đang được gán. Lưu lại quyền lợi sẽ chạy lại xác minh.Customer cancelled but still has the role
Customer cancelled but still has the role
Discord truyền tải việc loại bỏ vai trò ngay lập tức, nhưng ứng dụng Discord cục bộ của khách hàng có thể lưu bộ nhớ cache. Họ nên kết nối lại hoặc làm mới; trạng thái phía máy chủ là chính xác.