> ## 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.

# الشركاء

> قم بإطلاق وإدارة برنامج الشركاء الخاص بك أثناء معالجة المعاملات من خلال Dodo Payments.

## المقدمة

توجهك هذه الدليل خلال كيفية تتبع إحالات الشركاء، التعامل مع أحداث العمولة، وزيادة إيراداتك من خلال شراكات موثوقة مع الشركاء عبر مدفوعات دودي. نحن نقدم تكاملات مع منصات الشركاء الرائدة بما في ذلك **أفونسو** و **دب بارتنرز** لمساعدتك في إدارة وتتبع برامج الشركاء الخاصة بك بسلاسة.

## الميزات الرئيسية

<CardGroup cols={2}>
  <Card title="Automated Commission Attribution" icon="robot">
    لا جداول بيانات أو تتبع يدوي. تُنسب الإحالات وتُسجل تلقائيًا عند إتمام عملية الشراء.
  </Card>

  <Card title="Real-Time Reporting" icon="chart-line">
    يمكنك أنت وشركاؤك تتبع الأداء والعملاء المحتملين من لوحات تحكم مخصصة.
  </Card>

  <Card title="Flexible Tracking Options" icon="code">
    استخدم برامج تتبع، وحقول بيانات وصفية، وفعاليات ويب هوك لالتقاط بيانات الإحالة عبر عمليات التسجيل والمعاملات.
  </Card>

  <Card title="Fully Encrypted & Secure" icon="shield">
    تُبادل وتحفظ جميع بيانات الاعتماد الحساسة وبيانات ويب هوك بأمان باستخدام تشفير من الطراز الأول.
  </Card>

  <Card title="Quick Setup" icon="bolt">
    أطلق برنامج الشركاء الخاص بك خلال دقائق—لا حاجة لتعديلات على الكود بخلاف نسخ ولصق مقتطفات السكربت ورموز واجهة برمجة التطبيقات.
  </Card>

  <Card title="Seamless Integration" icon="plug">
    اربط تتبع الشركاء مباشرةً في مسارات الدفع باستخدام تكاملاتنا مع Affonso وDub Partners، أبرز منصات تسويق الشركاء.
  </Card>
</CardGroup>

## خيارات التكامل

تتكامل مدفوعات دودي مع منصتين رائدتين لإدارة الشركاء:

* **[أفونسو](https://affonso.io)**: منصة شاملة لإدارة الشركاء مع تتبع عمولات آلي، تقارير في الوقت الحقيقي، ولوحات معلومات مخصصة للشركاء.
* **[دب بارتنرز](https://dub.co)**: استخدم إدارة الروابط من دب وتتبع التحويلات لتفعيل برنامج الشركاء الخاص بك مع تحليلات تفصيلية للتخصيص.

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

## تكامل أفونسو

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

<Frame>
  <iframe className="w-full aspect-video rounded-md" src="https://www.youtube.com/embed/8tw8o9yOjsA" title="Affiliate Integration | Dodo Payments" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
</Frame>

<Steps>
  <Step title="Connect with Dodo Payments">
    للبدء، اربط حساب Dodo Payments الخاص بك عن طريق إضافة مفتاح واجهة برمجة التطبيقات.

    ### كيفية الحصول على مفتاح API الخاص بك من مدفوعات دودي

    * قم بتسجيل الدخول إلى **لوحة معلومات مدفوعات دودي**
    * انتقل إلى قسم **المطور** في القائمة اليسرى
    * انقر على **مفاتيح API**
    * اختر **إضافة مفتاح API**
    * أعطه اسمًا (مثل "تكامل أفونسو")
    * انقر على **إنشاء** و **انسخ** مفتاح API الخاص بك

    ### أضف مفتاح API الخاص بك إلى أفونسو

    * افتح **لوحة معلومات أفونسو عبر** [affonso.io](https://affonso.io/)
    * انتقل إلى **تفاصيل البرنامج > الاتصال**
    * انقر على بطاقة **تكامل مدفوعات دودي**
    * ألصق مفتاح API الخاص بك من مدفوعات دودي
    * انقر على **الاتصال**

    <Callout type="info">
      سيتم تشفير مفتاح واجهة برمجة التطبيقات الخاص بك بأمان بواسطة Affonso.
    </Callout>
  </Step>

  <Step title="Add Webhook to Dodo Payments">
    بمجرد الاتصال، ستحصل على عنوان ويب هوك فريد من Affonso. يمكّنك هذا من تتبع المدفوعات وإطلاق عمولات الشركاء.

    ### إضافة عنوان URL لـ Webhook في مدفوعات دودي

    * في لوحة معلومات مدفوعات دودي الخاصة بك، انتقل إلى **المطور → Webhooks**
    * انقر على **إضافة Webhook**
    * ألصق **عنوان URL لـ Webhook أفونسو** (من إعدادات برنامجك)
    * احفظ الـ Webhook

    ### إضافة سر Webhook في أفونسو

    * بعد حفظ الـ Webhook في مدفوعات دودي، **انسخ مفتاح التوقيع** المقدم
    * ألصقه مرة أخرى في أفونسو تحت **إعدادات Webhook مدفوعات دودي**

    <Callout type="info">
      هذا يتيح لـAffonso التحقق بأمان من الفعاليات الواردة من Dodo Payments.
    </Callout>
  </Step>

  <Step title="Add the Tracking Script">
    ضع بكسل Affonso على موقعك لبدء تتبع زيارات الشركاء والتحويلات.

    ```html theme={null}
    <!-- Place in <head> tag -->
    <script async defer
    src="https://affonso.io/js/pixel.min.js"
    data-affonso="YOUR_PUBLIC_PROGRAM_ID"
    data-cookie_duration="YOUR_COOKIE_DURATION">
    </script>
    ```

    هذا البرنامج النصي:

    * يتتبع زيارات الشركاء
    * ينشئ ملف تعريف ارتباط بمعرّف الإحالة (`affonso_referral`)
    * يتيح تتبع التسجيلات والمدفوعات

    <Callout type="info">
      ضع هذا على جميع النطاقات التي يزور فيها المستخدمون أو يتم التحويل فيها (مثل موقع التسويق، التطبيق).
    </Callout>
  </Step>

  <Step title="Track User Signups">
    للحصول على رؤية لقمع المبيعات وتحسين أداء الشركاء، تتبع تسجيلات المستخدمين كعملاء محتملين.

    ```js theme={null}
    // After successful registration
    window.Affonso.signup(userEmail);
    ```

    هذا سيسجل إحالة جديدة كـ **عميل محتمل** إذا جاء المستخدم عبر رابط الشريك

    * سيتم عرضها في لوحة المعلومات الخاصة بك وإحصائيات الشريك

    <Callout type="info">
      أفضل ممارسة: قم بإطلاق هذا بعد التسجيل الناجح أو التفعيل المزدوج (DOI).
    </Callout>
  </Step>

  <Step title="Pass Referral Data to Dodo Payments">
    لاحتساب العمولات بشكل صحيح، مرّر معرّف الإحالة من Affonso إلى Dodo Payments خلال الدفع.

    ### تكامل المدفوعات

    ```js theme={null}
    import DodoPayments from 'dodopayments';

    const referralId = window.affonso_referral;

    const client = new DodoPayments({
      bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
    });

    async function main() {
      const payment = await client.payments.create({
        payment_link: true,
        billing: { city: 'city', country: 'AF', state: 'state', street: 'street', zipcode: 0 },
        customer: { email: 'email@email.com', name: 'name' },
        product_cart: [{ product_id: 'product_id', quantity: 0 }],
        metadata: {
          affonso_referral: referralId,
        },
      });

      console.log(payment.payment_id);
    }

    main();
    ```

    ### تكامل الاشتراك

    ```js theme={null}
    import DodoPayments from 'dodopayments';

    const referralId = window.affonso_referral;

    const client = new DodoPayments({
      bearerToken: process.env['DODO_PAYMENTS_API_KEY'],
    });

    async function main() {
      const subscription = await client.subscriptions.create({
        billing: { city: 'city', country: 'IN', state: 'state', street: 'street', zipcode: 89789 },
        customer: { customer_id: 'customer_id' },
        product_id: 'product_id',
        payment_link: true,
        return_url: 'https://example.com/success',
        quantity: 1,
        metadata: {
          affonso_referral: referralId,
        },
      });

      console.log(subscription.subscription_id);
    }

    main();
    ```

    ### روابط الدفع

    ```js theme={null}
    // Original Dodo Payments Link
    const originalLink = 'https://checkout.dodopayments.com/buy/<YOUR_PRODUCT_ID>';

    // Append referral ID as reference_id
    const linkWithReferral = `${originalLink}?metadata_affonso_referral=${window.affonso_referral}`;
    ```

    <Callout type="info">
      لمزيد من التفاصيل، راجع [وثائق واجهة برمجة تطبيقات Dodo Payments](https://docs.dodopayments.com/api-reference/introduction)
    </Callout>
  </Step>

  <Step title="Testing Your Integration">
    قبل الإطلاق للجمهور، اختبر إعدادك باستخدام روابط شركاء فعلية ومعاملات تجريبية.

    **قائمة التحقق من الاختبار:**

    * ✅ أنشئ شريكاً وولّد رابط تتبع
    * ✅ زر موقعك عبر رابط الشريك
    * ✅ تأكد من تحميل سكربت Affonso وتعيين ملف تعريف الارتباط `affonso_referral`
    * ✅ أكمل تسجيلاً (اختياري)
    * ✅ أكمل دفعة عبر Dodo Payments
    * ✅ أكد التتبع والانتساب في لوحة تحكم Affonso الخاصة بك
  </Step>
</Steps>

## تكامل دب بارتنرز

يمكنك أيضًا استخدام [دب بارتنرز](https://dub.co) لتتبع إحالات الشركاء والتحويلات. تتيح لك ميزة تتبع التحويلات من دب تخصيص المبيعات إلى روابط الشركاء الخاصة بك، مما يوفر تحليلات تفصيلية حول أي الشركاء يحققون أكبر إيرادات.

<Info>
  للحصول على تعليمات إعداد مفصلة، اطلع على [دليل تكامل Dub](/integrations/dub) الذي يشرح كيفية تتبع أحداث تحويل المبيعات ونسب الإيرادات إلى روابط شركائك.
</Info>

### إعداد سريع مع دب بارتنرز

1. **فعّل تتبع التحويلات** في لوحة تحكم Dub الخاصة بالروابط التابعة
2. **التقط معرف نقرة Dub** (ملف تعريف الارتباط `dub_id`) عند إنشاء جلسات الدفع
3. **خزن معرف النقر** في البيانات الوصفية للدفعة إلى جانب معلومات العميل
4. **قم بتكوين تكامل ويب هوك** لإرسال بيانات المبيعات إلى Dub عند نجاح الدفعات

يتتبع التكامل تلقائيًا:

* المدفوعات لمرة واحدة
* تفعيل الاشتراكات
* المدفوعات المتكررة للاشتراكات

<Card title="Learn More" icon="book" href="/integrations/dub">
  اطلع على دليل التكامل الكامل مع أمثلة الشيفرات وقوالب التحويل لـDub.
</Card>

## تحتاج إلى مساعدة؟

إذا واجهت أي مشاكل أو كنت بحاجة إلى دعم أثناء التكامل:

<CardGroup cols={2}>
  <Card title="Affonso Support" icon="headset">
    * تحدث معنا عبر **الدردشة المباشرة** على [affonso.io](https://affonso.io/)
    * أرسل لنا بريداً إلكترونياً على **[support@affonso.io](mailto:support@affonso.io)**
  </Card>

  <Card title="Dub Support" icon="headset">
    * زر [وثائق Dub](https://dub.co/docs) للحصول على دلائل تتبع التحويلات
    * تواصل مع دعم Dub عبر [لوحة التحكم](https://app.dub.co)
  </Card>

  <Card title="Dodo Payments Support" icon="headset">
    للاستفسارات الخاصة بواجهة برمجة تطبيقات Dodo Payments، راجع docs.dodopayments.com أو تواصل مع فريق الدعم لدينا.
  </Card>

  <Card title="Integration Guides" icon="book">
    * [تكامل Affonso](#affonso-integration) (أعلاه)
    * [تكامل Dub Partners](/integrations/dub)
  </Card>
</CardGroup>