Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt

Use this file to discover all available pages before exploring further.

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.
Panel hak baru yang meminta pedagang untuk menghubungkan 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.
Layar OAuth Discord yang menanyakan server mana yang akan ditambahkan bot Dodo PaymentsLayar konfirmasi izin bot Discord
Saat Discord mengarahkan kembali, Anda akan melihat konfirmasi bahwa server telah terhubung.
Halaman konfirmasi berhasil terhubung dengan Discord Access
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.
Formulir Akses Discord untuk Pemberian Hak Baru dengan server yang terhubung, pemilih server, dropdown peran, dan kolom nama
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

BidangDiperlukanDeskripsi
guild_idYesID server Discord. Pemilih dashboard akan mengisi ini untuk Anda.
role_idNoPeran yang akan diberikan saat pengiriman. Lewati untuk akses hanya keanggotaan server.

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

​
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

Hak berada dalam pending hingga pelanggan menyelesaikan alur OAuth. Periksa daftar hak dan pastikan mereka mengklik tautan OAuth. Kirim ulang email jika diperlukan.
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.
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.
Last modified on May 14, 2026