Quyền lợi trên Discord

​

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

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.

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.

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.

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 quy trình thanh toán.
2. Dodo Payments tạo một grant ở trạng thái Pending. oauth_url của grant là null cho đến khi khách hàng bắt đầu accept flow; tại thời điểm đó, trường này được điền bằng URL ủy quyền Discord.
3. Khách hàng nhận được email có nút “Join the Discord” (liên kết OAuth). Liên kết này cũng hiển thị trong Customer Portal của họ.
4. Sau khi khách hàng cấp quyền, bot thêm họ vào server và gán role đã cấu hình. Grant chuyển sang Delivered.
5. Nếu subscription bị hủy, tạm dừng hoặc hết hạn, hoặc merchant thu hồi thủ công, bot sẽ gỡ role và grant chuyển sang Revoked.

​

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

​

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',
  },
});

client.entitlements.create(
    name="Patrons Discord Role",
    integration_type="discord",
    integration_config={
        "guild_id": "123456789012345678",
        "role_id": "987654321098765432",
    },
)

client.Entitlements.New(ctx, dodopayments.EntitlementNewParams{
  Name:            dodopayments.F("Patrons Discord Role"),
  IntegrationType: dodopayments.F(dodopayments.EntitlementIntegrationTypeDiscord),
  IntegrationConfig: dodopayments.F[dodopayments.IntegrationConfigUnionParam](
    dodopayments.IntegrationConfigDiscordConfigParam{
      GuildID: dodopayments.F("123456789012345678"),
      RoleID:  dodopayments.F("987654321098765432"),
    },
  ),
})

​

Webhooks

• entitlement_grant.created được kích hoạt với status: "Pending". oauth_url là null tại thời điểm này — trường này được điền khi khách hàng bắt đầu accept flow từ email giao hàng hoặc Customer Portal của họ.
• entitlement_grant.delivered được kích hoạt sau khi role được gán.
• entitlement_grant.revoked được kích hoạt khi role bị gỡ.

​

Khắc phục sự cố