Quyền lợi trên Discord

​

Nội dung được cung cấp

• Khách hàng kết nối tài khoản Discord từ Customer Portal. Email xác nhận thanh toán đánh dấu entitlement là Action Required và liên kết đến portal.
• Sau khi họ cấp quyền, bot Dodo Payments sẽ thêm họ vào máy chủ của bạn hoặc tìm membership hiện có của họ, rồi gán vai trò bạn đã cấu hình.
• Nếu bạn không chọn vai trò, khách hàng chỉ có membership trong máy chủ.

​

Kết nối Discord

1

Open Entitlements

Trong dashboard Dodo Payments, đi đến Entitlements và nhấp vào + để bắt đầu tạo entitlement mới.

2

Pick Discord

Chọn Discord Access làm integration. Nếu Discord chưa được kết nối cho doanh nghiệp của bạn, hãy nhấp vào Connect Discord.

Discord sẽ mở trong tab mới. Đăng nhập, chọn máy chủ bạn muốn kiểm soát quyền truy cập và phê duyệt các quyền của bot trên máy chủ đó: Manage Roles, Kick Members và Create Invite.

Khi Discord chuyển hướng trở lại, một trang xác nhận sẽ cho biết máy chủ đã được kết nối.

3

Pick a Server and Role

Quay lại dashboard, chọn Server bạn đã kết nối. Để gán vai trò khi cung cấp, hãy chọn vai trò đó trong Role. Để chỉ cấp membership trong máy chủ, giữ Role ở No specific role. Nhập Name cho entitlement và nhấp vào Create Entitlement.

4

Attach It to a Product

Entitlement đã được lưu và có thể đính kèm vào bất kỳ sản phẩm nào. Xem Đính kèm Entitlements vào sản phẩm.

​

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. Dodo Payments ngay lập tức cố gắng tạo URL ủy quyền Discord và lưu URL đó vào oauth_url. Nếu không thành công, oauth_url vẫn giữ giá trị null cho đến khi khách hàng bắt đầu quy trình chấp nhận.
3. Email xác nhận thanh toán liệt kê entitlement là Yêu cầu thao tác và liên kết đến Customer Portal. Trong portal, khách hàng nhấp vào Connect trên entitlement.
4. Khách hàng ủy quyền cho Dodo Payments trên Discord. Bot thêm khách hàng vào server và gán role đã cấu hình, đồng thời grant chuyển sang Delivered.
5. Khi grant bị thu hồi (subscription bị hủy, tạm dừng, đặt ở trạng thái chờ hoặc hết hạn, khoản thanh toán một lần được hoàn tiền, hoặc bạn thu hồi grant), bot xóa role và xóa khách hàng khỏi server. Grant chuyển sang Revoked.

​

Cấu hình bắt buộc

​

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

import os
from dodopayments import DodoPayments

client = DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),
    environment="test_mode",
)

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

// client is a *dodopayments.Client, for example from
// dodopayments.NewClient(option.WithEnvironmentTestMode()); ctx is a context.Context.
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 có thể đã chứa URL ủy quyền. Nếu có giá trị null, URL sẽ được điền khi khách hàng bắt đầu quy trình chấp nhận từ Customer Portal.
• entitlement_grant.delivered được kích hoạt sau khi khách hàng tham gia server và role được gán.
• entitlement_grant.revoked được kích hoạt khi role bị xóa và khách hàng bị xóa khỏi server.

​

Khắc phục sự cố