Discord Entitlement

​

Apa yang akan dikirimkan

• Pelanggan menghubungkan akun Discord mereka melalui tautan OAuth di email pengiriman atau portal pelanggan mereka.
• Setelah mereka mengotorisasi, Dodo Payments menambahkan mereka ke server Anda (atau menemukan keanggotaan yang ada) dan memberikan peran yang Anda atur.
• Jika Anda tidak memilih peran tertentu, hanya keanggotaan server yang diberikan.

​

Hubungkan Discord

1

Open Entitlements

Di dashboard Dodo Payments Anda, pergi ke Entitlements dan klik + untuk memulai hak baru.

2

Pick Discord

Pilih Discord Access sebagai integrasi. Jika Anda belum menghubungkan Discord untuk bisnis Anda, Anda akan diminta untuk Connect Discord.

Mengklik akan membuka Discord di tab baru. Masuk, pilih server yang ingin Anda atur, dan konfirmasi izin bot (Manage Roles, Kick Members, Create Invite) di server tersebut.

Saat Discord mengarahkan kembali, Anda akan melihat konfirmasi bahwa server telah terhubung.

3

Pick a server and role

Kembali ke dashboard, pilih server (guild) yang baru saja Anda hubungkan. Pilih sebuah peran untuk diberikan saat pengiriman, atau biarkan kosong untuk hanya memberikan keanggotaan server. Beri hak tersebut sebuah nama dan klik Create Entitlement.

4

Save the entitlement

Simpan haknya. Sekarang tersedia untuk dilampirkan ke produk apa pun.

​

Alur pelanggan

1. Pelanggan menyelesaikan checkout.
2. Dodo Payments membuat grant dengan status Pending. oauth_url adalah null hingga pelanggan memulai alur accept, dan pada saat itu akan diisi dengan URL otorisasi Discord.
3. Pelanggan menerima email dengan tombol “Join the Discord” (tautan OAuth). Tautan tersebut juga terlihat di customer portal mereka.
4. Setelah pelanggan memberikan otorisasi, bot menambahkan mereka ke server dan menetapkan role yang dikonfigurasi. Grant berpindah ke Delivered.
5. Jika subscription dibatalkan, dijeda, atau kedaluwarsa, atau jika merchant mencabutnya secara manual, bot menghapus role tersebut dan grant berpindah ke Revoked.

​

Konfigurasi yang diperlukan

​

Membuat via 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 terpicu dengan status: "Pending". oauth_url adalah null pada tahap ini — nilainya diisi setelah pelanggan memulai alur accept dari email delivery atau customer portal mereka.
• entitlement_grant.delivered terpicu setelah role ditetapkan.
• entitlement_grant.revoked terpicu saat role dihapus.

​

Memecahkan Masalah