Discord Entitlement

Berikan pelanggan Anda sebuah peran di server Discord Anda saat mereka membeli, dan cabut secara otomatis saat berlangganan mereka berakhir.

Pemberian hak Discord menambahkan pelanggan yang membayar ke server Anda (dan opsional memberikan mereka sebuah peran) saat langganan mereka aktif atau pembelian satu kali mereka selesai. Pembatalan, pengembalian dana, dan perubahan rencana akan secara otomatis mencabut peran tersebut.

​

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.

Integrasi ini ideal untuk komunitas berbayar, keuntungan pendukung, dan saluran akses bertingkat.

​

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.

   

   Connect Discord prompt before the OAuth handoff.

   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.

   

   Discord OAuth: pick the server, then confirm the bot's permissions on it.

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

   

   Server connected — return to the Dodo Payments dashboard to continue.

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 pembayaran.
2. Dodo Payments membuat hak dalam status pending dengan oauth_url yang mengarah ke Discord.
3. Pelanggan menerima email dengan tombol “Bergabung dengan Discord” (tautan OAuth). Tautan ini juga dapat dilihat di portal pelanggan mereka.
4. Setelah pelanggan mengotorisasi, bot menambahkan mereka ke server dan memberikan peran yang dikonfigurasi. Hak berubah menjadi delivered.
5. Jika langganan dibatalkan, dijeda, atau berakhir, atau jika pedagang mencabut secara manual, bot akan menghapus peran dan hak berubah menjadi revoked.

Pastikan peran bot Dodo Payments diposisikan di atas peran yang Anda berikan. Discord mencegah bot memberikan peran yang lebih tinggi dari mereka sendiri.

​

Konfigurasi yang diperlukan

Bidang	Diperlukan	Deskripsi
guild_id	Yes	ID server Discord. Pemilih dashboard akan mengisi ini untuk Anda.
role_id	No	Peran yang akan diberikan saat pengiriman. Lewati untuk akses hanya keanggotaan server.

​

Membuat via API

TypeScript

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

Berlangganan ke entitlement_grant.* webhook events untuk melacak pemberian hak Discord:

• entitlement_grant.created terjadi dengan status: "pending" dan oauth_url bagi pelanggan untuk mengotorisasi.
• entitlement_grant.delivered terjadi setelah peran diberikan.
• entitlement_grant.revoked terjadi saat peran dihapus.

​

Memecahkan Masalah

Customer never sees the role assigned

Hak berada dalam pending hingga pelanggan menyelesaikan alur OAuth. Periksa daftar hak dan pastikan mereka mengklik tautan OAuth. Kirim ulang email jika diperlukan.

Grant moves to failed with permission errors

Pastikan bot Dodo Payments tetap ada di server, memiliki izin Manage Roles, dan diposisikan di atas peran yang sedang diberikan. Menyimpan ulang hak akan menjalankan validasi kembali.

Customer cancelled but still has the role

Discord menyebarkan penghapusan peran secara langsung, tetapi klien Discord lokal pelanggan mungkin menyimpan sementara. Mereka harus menyambung ulang atau menyegarkan; status sisi server sudah benar.