Chuyển đến nội dung chính

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.
Tích hợp này lý tưởng cho cộng đồng trả phí, ưu đãi cho người ủng hộ, và các kênh truy cập phân cấp.

Kết nối Discord

1

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.
2

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.
Panel quyền lợi mới nhắc thương nhân 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ủ đó.
Màn hình Discord OAuth hỏi máy chủ nào để thêm bot Dodo Payments vàoMàn hình xác nhận quyền của bot Discord
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.
Trang xác nhận kết nối thành công Discord Access
3

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ền lợi mới - Biểu mẫu truy cập Discord với máy chủ đã kết nối, chọn máy chủ, danh sách thả xuống vai trò, và trường tên
4

Save the entitlement

Lưu quyền lợi. Nó hiện có sẵn để đính kèm vào bất kỳ sản phẩm nào.

Quy trình của khách hàng

  1. Khách hàng hoàn tất thanh toán.
  2. Dodo Payments tạo một quyền cấp ở trạng thái pending với một oauth_url chỉ vào Discord.
  3. 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ọ.
  4. 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.
  5. 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.
Đảm bảo vai trò của bot Dodo Payments được đặt cao hơn vai trò bạn cấp. Discord ngăn cản bot gán vai trò xếp hạng cao hơn vai trò của chúng.

Cấu hình yêu cầu

TrườngBắt buộcMô tả
guild_idID 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_idKhôngVai 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

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
  environment: 'test_mode',
});

const entitlement = await client.entitlements.create({
  name: 'Patrons Discord Role',
  integration_type: 'discord',
  integration_config: {
    guild_id: '123456789012345678',
    role_id: '987654321098765432',
  },
});

Webhooks

Đăng ký sự kiện webhook entitlement_grant.* để theo dõi các quyền cấp trên Discord:
  • entitlement_grant.created kích hoạt với status: "pending" và một oauth_url cho khách hàng ủy quyền.
  • entitlement_grant.delivered kích hoạt khi vai trò được gán.
  • entitlement_grant.revoked kích hoạt khi vai trò bị xóa.

Khắc phục sự cố

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.
Đả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.
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.
Last modified on May 14, 2026