Discord 权限

Discord entitlement 会将付费客户添加到您的 Discord 服务器，并可为其分配角色。客户的订阅激活或一次性付款成功后，会连接其 Discord 账户。当授权被撤销时，例如取消订阅或退款，Dodo Payments 会移除该角色并将客户从服务器中移除。

交付内容

客户可从 Customer Portal 连接其 Discord 账户。付款确认邮件会将该 entitlement 标记为 Action Required，并提供指向门户的链接。
客户完成授权后，Dodo Payments bot 会将其添加到您的服务器，或找到其现有成员身份，并分配您配置的角色。
如果您未选择角色，客户只会获得服务器成员身份。

可用于付费社区、支持者权益和分层访问频道。

连接 Discord

Open Entitlements

在 Dodo Payments 控制面板中，前往 Entitlements，然后点击 + 以开始创建新的 entitlement。

Pick Discord

选择 Discord Access 作为集成。如果您的企业尚未连接 Discord，请点击 Connect Discord。

New entitlement panel prompting the merchant to connect Discord — Connect Discord prompt before the OAuth handoff.

Discord 会在新标签页中打开。登录后，选择您希望控制访问权限的服务器，并批准 bot 在该服务器上的权限：Manage Roles、Kick Members 和 Create Invite。

Discord OAuth screen asking which server to add the Dodo Payments bot to — Discord OAuth: pick the server to add the bot to.

Discord bot permission confirmation screen — Discord OAuth: confirm the bot's permissions on the server.

Discord 重定向回来后，确认页面会显示服务器已连接。

Discord Access connected successfully confirmation page — Server connected. Return to the Dodo Payments dashboard to continue.

Pick a Server and Role

返回控制面板后，选择您连接的 Server。如需在交付时分配角色，请在 Role 下选择该角色。如只授予服务器成员身份，请将 Role 保持为 No specific role。输入 entitlement 的 Name，然后点击 Create Entitlement。

New Entitlement - Discord Access form with connected server, server picker, role dropdown, and name field

Attach It to a Product

entitlement 已保存，可附加到任何产品。请参阅将 Entitlements 附加到产品。

客户流程

客户完成结账。
Dodo Payments 创建一个处于 Pending 状态的授权。Dodo Payments 会立即尝试创建 Discord 授权 URL，并将其存储在 oauth_url 中。如果失败，oauth_url 会保持为 null，直到客户开始接受流程。
支付确认邮件会将该权益列为 需要操作，并提供指向 Customer Portal 的链接。在门户中，客户点击该权益上的连接。
客户在 Discord 上授权 Dodo Payments。机器人会将客户添加到服务器并分配配置的角色，授权状态变为 Delivered。
当授权被撤销时（订阅被取消、暂停、搁置或过期，一次性付款被退款，或你撤销了授权），机器人会移除该角色并将客户从服务器中移除。授权状态变为 Revoked。

授权链接会在生成 30 分钟后过期。如果客户在此之后返回 Customer Portal，Dodo Payments 会生成新的链接。如果客户自行离开您的服务器，Dodo Payments 会使用 revocation_reason: platform_external 撤销其 grant。

请将 Dodo Payments bot 的角色置于您要授予的角色上方。Discord 不允许 bot 分配级别等于或高于其自身最高角色的角色。托管角色（例如 bot 和集成角色）无法分配。

必需配置

Field	Required	Description
`guild_id`	是	Discord 服务器（guild）的 ID。控制面板的服务器选择器会自动为您填写。
`role_id`	否	交付时要分配的角色。省略此项或传入 `null`，即表示仅授予服务器成员身份。

通过 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.* webhook events，以跟踪 Discord grant：

entitlement_grant.created 会随 status: "Pending" 触发。oauth_url 中可能已经存有授权 URL。如果其值为 null，则会在客户从 Customer Portal 开始接受流程后填充。
客户加入服务器并被分配角色后，entitlement_grant.delivered 会触发一次。
角色被移除且客户被从服务器中移除时，entitlement_grant.revoked 会触发。

故障排除

Customer never sees the role assigned

在客户完成 Discord 授权前，grant 会一直处于 Pending 状态。在控制面板中打开 entitlement 并检查客户的 grant。如果仍为 Pending，请让客户打开 Customer Portal，并点击 Discord entitlement 上的 Connect。

Grant moves to failed with permission errors

请确保 Dodo Payments 机器人仍在服务器中，拥有 管理角色 权限，并且位于待分配角色的上方。如果机器人被从服务器中移除，Dodo Payments 会撤销该服务器中待处理和已交付的授权。重新保存权益只会检查其设置，不会检查机器人的权限。修复权限后，请客户打开 Customer Portal，并点击 Discord 权益上的连接，以重试授权。

Customer cancelled but still has the role

撤销会移除角色并将客户从服务器中移除。如果 grant 显示为 Revoked，但客户仍在服务器中，请确认 bot 仍拥有 Manage Roles 和 Kick Members 权限，并且位于该角色的上方。如果客户的 Discord 应用仍显示该角色，请让其刷新。服务器端状态是唯一事实来源。

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

交付内容

连接 Discord

客户流程

必需配置

通过 API 创建

Webhooks

故障排除

​交付内容

​连接 Discord

​客户流程

​必需配置

​通过 API 创建

​Webhooks

​故障排除

交付内容

连接 Discord

客户流程

必需配置

通过 API 创建

Webhooks

故障排除