Discord Entitlement

​

Yang Diberikan

• Pelanggan menghubungkan akun Discord mereka dari Customer Portal. Email konfirmasi pembayaran menandai entitlement sebagai Action Required dan menyediakan tautan ke portal.
• Setelah memberikan otorisasi, bot Dodo Payments menambahkan mereka ke server Anda, atau menemukan keanggotaan mereka yang sudah ada, lalu menetapkan role yang Anda konfigurasi.
• Jika Anda tidak memilih role, pelanggan hanya mendapatkan keanggotaan server.

​

Hubungkan Discord

1

Open Entitlements

Di dasbor Dodo Payments, buka Entitlements lalu klik + untuk memulai entitlement baru.

2

Pick Discord

Pilih Discord Access sebagai integrasi. Jika Discord belum terhubung untuk bisnis Anda, klik Connect Discord.

Discord terbuka di tab baru. Masuk, pilih server yang ingin Anda lindungi, lalu setujui izin bot pada server tersebut: Manage Roles, Kick Members, dan Create Invite.

Saat Discord mengarahkan kembali, halaman konfirmasi akan menunjukkan bahwa server telah terhubung.

3

Pick a Server and Role

Kembali ke dasbor, pilih Server yang Anda hubungkan. Untuk menetapkan role saat delivery, pilih role tersebut di bawah Role. Untuk memberikan keanggotaan server saja, biarkan Role diatur ke No specific role. Masukkan Name untuk entitlement, lalu klik Create Entitlement.

4

Attach It to a Product

Entitlement disimpan dan tersedia untuk dilampirkan ke produk apa pun. Lihat Lampirkan Entitlement ke Produk.

​

Alur Pelanggan

1. Pelanggan menyelesaikan checkout.
2. Dodo Payments membuat grant dengan status Pending. Dodo Payments segera mencoba membuat URL otorisasi Discord dan menyimpannya di oauth_url. Jika gagal, oauth_url tetap null sampai pelanggan memulai alur penerimaan.
3. Email konfirmasi pembayaran mencantumkan entitlement sebagai Memerlukan Tindakan dan menautkan ke Customer Portal. Di portal, pelanggan mengeklik Hubungkan pada entitlement.
4. Pelanggan mengotorisasi Dodo Payments di Discord. Bot menambahkan pelanggan ke server dan menetapkan role yang dikonfigurasi, lalu grant berpindah ke Delivered.
5. Saat grant dicabut (subscription dibatalkan, dijeda, ditangguhkan, atau kedaluwarsa, pembayaran satu kali dikembalikan, atau Anda mencabut grant), bot menghapus role dan mengeluarkan pelanggan dari server. Grant berpindah ke Revoked.

​

Konfigurasi yang Diperlukan

​

Buat melalui 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"),
    },
  ),
})

​

Webhook

• entitlement_grant.created terpicu dengan status: "Pending". oauth_url mungkin sudah berisi URL otorisasi. Jika nilainya null, URL tersebut diisi setelah pelanggan memulai alur penerimaan dari Customer Portal.
• entitlement_grant.delivered terpicu setelah pelanggan bergabung ke server dan role ditetapkan.
• entitlement_grant.revoked terpicu saat role dihapus dan pelanggan dikeluarkan dari server.

​

Pemecahan Masalah