Discord Entitlement

​

제공되는 기능

• 고객은 Customer Portal에서 Discord 계정을 연결합니다. 결제 확인 이메일에는 entitlement가 Action Required로 표시되고 포털 링크가 포함됩니다.
• 고객이 인증하면 Dodo Payments bot이 고객을 서버에 추가하거나 기존 멤버십을 찾아 구성한 역할을 부여합니다.
• 역할을 선택하지 않으면 고객에게 서버 멤버십만 부여됩니다.

​

Discord 연결

1

Open Entitlements

Dodo Payments 대시보드에서 Entitlements로 이동한 다음 **+**를 클릭하여 새 entitlement를 시작합니다.

2

Pick Discord

통합으로 Discord Access를 선택합니다. 아직 비즈니스에 Discord가 연결되지 않았다면 Connect Discord를 클릭합니다.

Discord가 새 탭에서 열립니다. 로그인하고 액세스를 제한할 서버를 선택한 다음 해당 서버에서 bot의 권한을 승인합니다: Manage Roles, Kick Members 및 Create Invite.

Discord가 다시 리디렉션하면 확인 페이지에 서버가 연결되었다는 메시지가 표시됩니다.

3

Pick a Server and Role

대시보드로 돌아와 연결한 Server를 선택합니다. 전달 시 역할을 부여하려면 Role에서 역할을 선택합니다. 서버 멤버십만 부여하려면 Role을 No specific role로 둡니다. entitlement의 Name을 입력하고 Create Entitlement를 클릭합니다.

4

Attach It to a Product

entitlement가 저장되며 모든 제품에 연결할 수 있습니다. 제품에 Entitlements 연결하기를 참고하세요.

​

고객 플로우

1. 고객이 결제를 완료합니다.
2. Dodo Payments가 Pending 상태로 grant를 생성합니다. Dodo Payments는 즉시 Discord authorization URL을 생성하려고 시도하고 이를 oauth_url에 저장합니다. 이 작업이 실패하면 고객이 accept flow를 시작할 때까지 oauth_url는 null 상태로 유지됩니다.
3. 결제 확인 이메일에는 entitlement가 Action Required로 표시되고 Customer Portal 링크가 포함됩니다. 포털에서 고객은 entitlement의 Connect를 클릭합니다.
4. 고객이 Discord에서 Dodo Payments를 authorize합니다. 봇이 고객을 서버에 추가하고 구성된 role을 할당하면 grant가 Delivered 상태로 전환됩니다.
5. grant가 revoked되면(구독이 cancelled, paused, put on hold 상태가 되거나 만료된 경우, 일회성 결제가 refunded된 경우 또는 사용자가 grant를 revoke한 경우) 봇이 role을 제거하고 서버에서 고객을 제거합니다. grant가 Revoked 상태로 전환됩니다.

​

필수 구성

​

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가 status: "Pending"와 함께 발생합니다. oauth_url에 authorization URL이 이미 저장되어 있을 수 있습니다. 값이 null인 경우 고객이 Customer Portal에서 accept flow를 시작하면 값이 채워집니다.
• 고객이 서버에 참여하고 role이 할당되면 entitlement_grant.delivered가 발생합니다.
• role이 제거되고 고객이 서버에서 제거되면 entitlement_grant.revoked가 발생합니다.

​

문제 해결