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

# ترحيل الاشتراكات إلى مدفوعات دودي

> تعلم كيفية ترحيل المشتركين الحاليين وطرق الدفع من معالج الدفع الحالي الخاص بك إلى مدفوعات دودي.

## ما هو ترحيل الاشتراكات؟

ترحيل الاشتراكات ينقل المشتركين الحاليين لديك من معالج الدفع القديم إلى مدفوعات دودي، مما يمنحك مصدرًا موحدًا لجميع بيانات العملاء. بدون ترحيل، سيبقى العملاء الذين اكتسبتهم حتى الآن في نظامك القديم، ولن يكون مرئيًا في مدفوعات دودي سوى العملاء الجدد.

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

<Warning>
  حالياً، ندعم فقط الترحيل لـ **رموز البطاقات**. لا يمكن نقل Apple Pay أو Google Pay أو طرق الدفع المحفظية الأخرى بين معالجات الدفع بسبب قيود الترميز التي تفرضها هذه الجهات.
</Warning>

## نظرة عامة على عملية الترحيل

تتكون عملية ترحيل الاشتراكات من ثلاثة أجزاء رئيسية:

1. **نقل طريقة الدفع** — نقل آمن لبيانات البطاقة الحساسة من معالجك الحالي
2. **نقل بيانات المشتركين** — تصدير تفاصيل العملاء، خطط الاشتراك، وجداول الفواتير
3. **الاستيراد والتحقق** — توحيد طرق الدفع وبيانات المشتركين في مدفوعات دودي

<Note>
  لبدء ترحيل الاشتراكات، اتصل بـ [فريق الدعم](mailto:support@dodopayments.com). سيقومون بتوصيلك بمهندس حلول مخصص سيرشدك خلال العملية بأكملها.
</Note>

## المتطلبات

قبل بدء عملية الترحيل، تأكد من أنك تلبي المتطلبات التالية:

<AccordionGroup>
  <Accordion title="PCI DSS compliance verification">
    تلتزم Dodo Payments بمعيار PCI DSS المستوى 1. لتلبية متطلبات الامتثال، يمكننا فقط استقبال بيانات البطاقات من معالج دفع آخر يمتثل أيضاً لمعيار PCI DSS المستوى 1.

    يجب أن يوفر معالجك الحالي:

    * شهادة الامتثال الحالية (AOC) الخاصة بهم، أو إدراجهم في السجل العالمي لمقدمي الخدمات من Visa
    * تأكيد أنهم يدعمون تصدير بيانات البطاقة بشكل آمن

    اطّلع على [شهادة الامتثال (AOC)](https://pub-2a89184e4c954b599464449d23f506bb.r2.dev/dodo-payments-pci-dss-aoc.pdf) الخاصة بنا لمشاركتها مع معالج الدفع الحالي.
  </Accordion>

  <Accordion title="Dodo Payments integration">
    أتمّم تكامل Dodo Payments الخاص بك وتأكد من توجيه جميع العملاء الجدد إلى صفحة الدفع في Dodo Payments قبل بدء الترحيل. يساعد ذلك على تفادي التباينات في البيانات أثناء فترة الانتقال.
  </Accordion>

  <Accordion title="Data access authorization">
    تأكد من أن لديك التفويض اللازم لطلب تصدير البيانات من معالجك الحالي. يتطلب ذلك عادةً:

    * التحقق من مالك الحساب
    * تفويض كتابي للوصول إلى البيانات الحساسة
    * إتمام خطوات التحقق الأمنية الخاصة بمعالجك
  </Accordion>
</AccordionGroup>

## دليل الترحيل خطوة بخطوة

<Steps>
  <Step title="Request payment method export from your current processor">
    اتصل بفريق دعم معالج الدفع الحالي لديك وقدم طلباً رسمياً للحصول على تصدير كامل لرموز بطاقات عملائك.

    ستحتاج إلى:

    * تقديم تحقق من هويتك وتفويضك
    * طلب تشفير التصدير باستخدام مفتاح PGP العام الخاص بمدفوعات دودي (المقدم أدناه)
    * طلب منهم نقل الملف المشفر مباشرة إلى خادم SFTP الآمن الخاص بنا

    <Info>
      تُجرى التحويلات الآمنة مباشرة من خادم إلى خادم عبر SFTP. سيزودك مهندس الحلول الخاص بك بمعلومات اعتماد SFTP لمشاركتها مع معالجك الحالي.
    </Info>

    يستغرق هذا الإجراء في المتوسط حوالي **أسبوعين**، رغم أن المدة قد تختلف حسب سياسات معالج الدفع الحالي ووتيرة استجابته.
  </Step>

  <Step title="Prepare subscriber data export">
    أثناء تنفيذ نقل طريقة الدفع، قم بتصدير بيانات المشتركين من النظام الحالي. سيزودك مهندس الحلول الخاص بك بقالب CSV ويرشدك عبر الحقول المطلوبة.

    ### بيانات المشتركين المطلوبة

    | Field               | Description                                    |
    | ------------------- | ---------------------------------------------- |
    | `customer_id`       | معرف العميل الداخلي لديك                       |
    | `email`             | عنوان البريد الإلكتروني للعميل                 |
    | `name`              | الاسم الكامل للعميل                            |
    | `country`           | رمز البلد المكون من حرفين (ISO 3166-1 alpha-2) |
    | `currency`          | رمز العملة المكون من ثلاثة أحرف (ISO 4217)     |
    | `payment_amount`    | مبلغ الاشتراك بأصغر وحدة نقدية                 |
    | `payment_interval`  | وتيرة الفوترة (شهري، سنوي، إلخ)                |
    | `next_billing_date` | تاريخ الفوترة المجدولة التالي (ISO 8601)       |
    | `card_token`        | رمز فريد من معالجك الحالي                      |

    <Warning>
      حقل `card_token` ضروري—يُستخدم لمطابقة سجلات المشتركين مع طرق الدفع الخاصة بهم أثناء الاستيراد. تأكد من تطابقه تماماً مع الرمز في تصدير طريقة الدفع.
    </Warning>

    ### تنسيق بيانات العينة

    ```json theme={null}
    {
      "customers": [
        {
          "customer_id": "cus_abc123",
          "email": "jane.doe@example.com",
          "name": "Jane Doe",
          "country": "US",
          "currency": "USD",
          "payment_amount": 2999,
          "payment_interval": "monthly",
          "next_billing_date": "2025-01-15T00:00:00Z",
          "card_token": "tok_xyz789",
          "metadata": {
            "plan": "pro",
            "signup_source": "website"
          }
        }
      ]
    }
    ```
  </Step>

  <Step title="Validation and testing">
    قبل تاريخ الاستيراد، سيقوم فريقنا بـ:

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

    <Check>
      ستتلقى تقرير تحقق يؤكد أن كل شيء جاهز لاستيراد الإنتاج.
    </Check>
  </Step>

  <Step title="Production import">
    في التاريخ المتفق عليه للاستيراد، سيقوم فريق الهندسة لدينا بـ:

    1. استيراد بيانات طريقة الدفع إلى خزنة البطاقات المتوافقة مع PCI
    2. استيراد بيانات المشتركين الخاصة بك
    3. مطابقة المشتركين مع طرق الدفع الخاصة بهم باستخدام رموز البطاقة
    4. تفعيل جميع الاشتراكات المهاجرة

    <Info>
      وقت المعالجة النموذجي هو **2-3 أيام عمل** للترحيلات القياسية، اعتماداً على حجم المشتركين.
    </Info>
  </Step>

  <Step title="Post-migration verification">
    بعد اكتمال الاستيراد، ستتلقى:

    * تقرير شامل عن الترحيل
    * ملف CSV يربط معرفات الاشتراكات القديمة بمعرفات مدفوعات دودي الجديدة
    * الوصول إلى جميع العملاء المهاجرين في لوحة معلومات مدفوعات دودي الخاصة بك

    نوصي بـ:

    * التحقق من عينة من الاشتراكات التي تم ترحيلها عبر لوحة التحكم الخاصة بك
    * اختبار بعض تجديدات الاشتراكات في وضع الاختبار (sandbox)
    * تحديث مراجع قاعدة البيانات الداخلية بالمعرفات الجديدة
    * مراقبة متوازية خلال دورة الفوترة الأولى
  </Step>
</Steps>

## البيانات القابلة للترحيل

يمكن نقل البيانات التالية خلال ترحيل الاشتراكات:

| نوع البيانات                     | مدعوم | ملاحظات                |
| -------------------------------- | ----- | ---------------------- |
| أرقام بطاقات الائتمان/الخصم      | ✅     | مشفرة عبر PGP          |
| تواريخ انتهاء صلاحية البطاقة     | ✅     |                        |
| أسماء حاملي البطاقات             | ✅     |                        |
| عناوين الفواتير                  | ✅     |                        |
| عناوين البريد الإلكتروني للعملاء | ✅     |                        |
| بيانات التعريف الخاصة بالعملاء   | ✅     | أزواج مفتاح-قيمة مخصصة |
| تفاصيل الاشتراك                  | ✅     | خطة، مبلغ، فترة        |
| رموز Apple Pay                   | ❌     | لا يمكن نقلها          |
| رموز Google Pay                  | ❌     | لا يمكن نقلها          |
| رموز المحفظة الأخرى              | ❌     | لا يمكن نقلها          |
| تاريخ الدفع                      | ❌     | تصدير من معالجك الحالي |

<Note>
  لا يمكن ترحيل سجل العمليات وسجل المعاملات. نوصي بتصدير هذه البيانات من معالجك الحالي للاحتفاظ بها كأرشيف قبل إكمال الانتقال.
</Note>

## تشفير PGP

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

شارك هذا المفتاح مع معالج الدفع الحالي الخاص بك لتشفير تصدير بيانات البطاقة:

<Accordion title="Dodo Payments PGP Public Key">
  ```
  -----BEGIN PGP PUBLIC KEY BLOCK-----

  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
  1OSDhXaPYtJnVApUzaCrC5PJCXU=
  =nHcw
  -----END PGP PUBLIC KEY BLOCK-----

  ```
</Accordion>

## توقعات الجدول الزمني

| المرحلة                 | المدة             |
| ----------------------- | ----------------- |
| الإعداد والتخطيط الأولي | 1-2 أيام          |
| نقل طريقة الدفع         | \~2 أسابيع        |
| تحضير بيانات المشتركين  | 3-5 أيام (متوازي) |
| التحقق والاختبار        | 2-3 أيام          |
| استيراد الإنتاج         | 2-3 أيام عمل      |
| التحقق بعد الترحيل      | 1-2 أيام          |

<Tip>
  يستغرق الترحيل الكامل عادةً **3-4 أسابيع** من البداية حتى النهاية. بدء إعداد بيانات المشتركين أثناء تنفيذ نقل طريقة الدفع يساعد في تقليل الجدول الزمني الكلي.
</Tip>

## ابدأ الآن

هل أنت مستعد لترحيل اشتراكاتك إلى مدفوعات دودي؟ اتصل بفريقنا لبدء العملية:

<CardGroup cols={2}>
  <Card title="Contact Support" icon="envelope" href="mailto:support@dodopayments.com">
    تواصل معنا لبدء الترحيل والتواصل مع مهندس حلول.
  </Card>

  <Card title="API Documentation" icon="code" href="/api-reference/introduction">
    استكشف واجهة برمجة التطبيقات الخاصة بنا لفهم كيفية عمل الاشتراكات في Dodo Payments.
  </Card>
</CardGroup>