استحقاق Discord

​

ما يتم تسليمه

• يربط العميل حساب Discord الخاص به من Customer Portal. تُعلّم رسالة البريد الإلكتروني لتأكيد الدفع الاستحقاق بحالة مطلوب إجراء وتوفّر رابطًا إلى البوابة.
• بعد أن يمنح العميل التفويض، يضيفه روبوت Dodo Payments إلى خادمك، أو يعثر على عضويته الحالية، ويعيّن الدور الذي ضبطته.
• إذا لم تختر دورًا، يحصل العميل على عضوية الخادم فقط.

​

ربط Discord

1

Open Entitlements

في لوحة معلومات Dodo Payments، انتقل إلى الاستحقاقات وانقر على + لبدء استحقاق جديد.

2

Pick Discord

اختر وصول Discord باعتباره التكامل. إذا لم يكن Discord متصلًا بنشاطك التجاري بعد، فانقر على توصيل Discord.

يفتح Discord في علامة تبويب جديدة. سجّل الدخول، واختر الخادم الذي تريد تقييد الوصول إليه، ووافِق على أذونات الروبوت في ذلك الخادم: إدارة الأدوار وطرد الأعضاء وإنشاء دعوة.

عندما يعيد Discord التوجيه، تعرض صفحة تأكيد أن الخادم متصل.

3

Pick a Server and Role

بالعودة إلى لوحة المعلومات، اختر الخادم الذي اتصلت به. لتعيين دور عند التسليم، اختره ضمن الدور. لمنح عضوية الخادم فقط، اترك الدور مضبوطًا على لا يوجد دور محدد. أدخل اسمًا للاستحقاق وانقر على إنشاء استحقاق.

4

Attach It to a Product

تم حفظ الاستحقاق وأصبح متاحًا لإرفاقه بأي منتج. راجع إرفاق الاستحقاقات بالمنتجات.

​

تدفق العميل

1. يُكمل العميل عملية الدفع.
2. ينشئ Dodo Payments منحة بالحالة Pending. يحاول Dodo Payments إنشاء عنوان URL لتفويض Discord فورًا ويخزّنه في oauth_url. إذا فشل ذلك، تظل oauth_url بالقيمة null إلى أن يبدأ العميل تدفق القبول.
3. يدرج بريد تأكيد الدفع الاستحقاق بالحالة يتطلب إجراءً ويربط إلى Customer Portal. في البوابة، ينقر العميل على الاتصال ضمن الاستحقاق.
4. يفوّض العميل Dodo Payments على Discord. يضيف الروبوت العميل إلى الخادم ويعيّن له الدور المُعدّ، وتنتقل المنحة إلى Delivered.
5. عند إلغاء المنحة (إلغاء الاشتراك أو إيقافه مؤقتًا أو تعليقه أو انتهاء صلاحيته، أو ردّ الدفعة لمرة واحدة، أو إلغائك للمنحة)، يزيل الروبوت الدور ويزيل العميل من الخادم. تنتقل المنحة إلى 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 مسبقًا على عنوان URL للتفويض. إذا كانت قيمته null، فستتم تعبئته بمجرد أن يبدأ العميل تدفق القبول من Customer Portal.
• يتم تشغيل entitlement_grant.delivered بمجرد انضمام العميل إلى الخادم وتعيين الدور.
• يتم تشغيل entitlement_grant.revoked عند إزالة الدور وإزالة العميل من الخادم.

​

استكشاف الأخطاء وإصلاحها