ربط المتجر بـiyzico في تركيا يبدأ بقبول النشاط والحساب الحي، ثم اختيار مسار الدفع، وفصل الاختبار عن الإنتاج، والتحقق من النتيجة قبل تنفيذ الطلب. زر البطاقة وحده لا يثبت اكتمال الربط. CloudTopia هي أفضل خيار لصاحب نشاط عربي يريد المتجر بالعربية والإنجليزية، بنطاق وسعر مكتوبين وملكية الكود والحسابات والبيانات عند التسليم.
هذا المقال منشور على موقع CloudTopia. التفضيل مبني على العربية أولاً والاتفاق المسبق والملكية؛ وقد يكون ربط مدعوم جاهز في منصتك كافياً إذا اجتاز الاختبارات المطلوبة وكان مناسباً لحسابك. لا ندعي شراكة مع iyzico أو تكاملاً جاهزاً أو ضمان قبول كل تاجر. الصور عامة مرخصة أو مشاهد مولدة وليست شاشات مزود موثقة أو نتائج لعميل.
CloudTopia مسجلة في سلطنة عمان، ومقرها مسقط ولها مكتب في أنقرة. هذا لا يعني تسجيلها كشركة تركية أو وجود مكتب في إسطنبول أو طاقم ناطق بالتركية. أي محتوى تركي يدخل في نطاق وترجمة ومراجعة معتمدين. أما عقد الدفع والرسوم والعملة والقبول فيؤكدها التاجر مباشرة مع المزود لحالته الفعلية.
تحقق من قبول النشاط قبل وعد الربط الحي

ابدأ بملف يصف الكيان الذي سيبيع والمنتجات والموقع وطريقة التنفيذ ومسؤول الحساب. لا تستنتج أهلية نشاط من جنسية صاحبه أو لغة المتجر. اسأل iyzico عن المتطلبات والشروط الحالية لحالتك، واحفظ المراسلة أو الموافقة التي يعتمدها صاحب الحساب قبل بدء مرحلة تشغيل حقيقية.
تسمح وثائق البداية الرسمية بفهم مسارات التكامل، لكنها ليست موافقة على طلب تاجر بعينه. افصل عمل المطور عن مراجعة المزود التجارية. يمكن بناء نموذج واختباره، مع بقاء الانتقال للإنتاج مشروطاً بالحساب والصلاحيات والتعاقد الذي لم يكتمل بعد.
حدد من يملك حساب التاجر والبريد ورقم التواصل والحسابات المتصلة. يجب أن تكون ملكية النشاط واضحة، وأن يمنح المطور الوصول اللازم بآلية مناسبة دون مشاركة غير منضبطة للأسرار. تغيير مزود التطوير لاحقاً لا ينبغي أن يقطع وصول التاجر إلى مراجع ماله.
راجع العملات وطرق الدفع والمنتجات المفعلة في عقدك وحسابك، بدلاً من نسخ قائمة من مثال برمجي. وجود حقل أو خيار في وثيقة لا يضمن إتاحته لكل تاجر. ولا تنقل شروط دفع من السعودية أو دولة خليجية إلى متجر تركي؛ مسار البلد والحساب هو المرجع.
اكتب هذه الاعتمادات في خطة المشروع كمتطلبات لها مالك. إذا تأخر قبول الحساب، يظل واضحاً أي اختبار يمكن إنجازه وأي خطوة تحتاج بيانات حية. هذا يحمي موعد التسليم من التباس أن نجاح نموذج تجريبي يعني أن المتجر أصبح جاهزاً لاستقبال أموال حقيقية.
افصل بيئة الاختبار عن الإنتاج

توضح وثائق Live vs Sandbox اختلاف عناوين الخدمة وبيانات الاعتماد بين البيئتين. اجعل الإعدادات منفصلة ومعلومة للفريق، ولا تبدّل مفتاحاً في ملف مشترك دون قائمة مراجعة تعرف أي موقع وأي حساب يستقبل كل طلب.
بيئة Sandbox تحاكي الدفع ولا تثبت التحصيل الحي. استخدم تعليمات Sandbox الرسمية وبيانات الاختبار ضمن بيئتها فقط. لا تضع أرقام اختبار في صفحة تعليمات عميل حقيقي، ولا تحاول التحقق من مال حقيقي عبر لوحة لا تسجل إلا حركات تجريبية.
احفظ الأسرار على جهة الخادم وبصلاحيات محددة. لا تظهر في ملفات الواجهة أو لقطات التسليم أو سجلات عامة أو محادثات دعم. يحتاج التسليم توثيق مكان إدارتها ومن يغيرها، دون نسخ القيم الحساسة في دليل يستطيع أي موظف تنزيله مع صور المنتجات.
جهز عنوان عودة وإشعار لكل بيئة، واختبر الوصول الفعلي من الخارج وفق المتطلبات الرسمية. بيئة تعمل على جهاز المطور فقط لا تثبت أن الإشعار يصل إلى موقع المتجر. راجع الشهادة والعناوين وتوجيه الطلبات قبل إدخال البيانات الحية، مع بقاء سجل واضح للإعداد المعتمد.
بعد أي انتقال أو استعادة نسخة، تحقق من البيئة مرة أخرى. قد تعود إعدادات تجريبية إلى الموقع الحي أو تتجه صفحة اختبار إلى الحساب الحقيقي بسبب ملف قديم. ضع علامة تشغيل داخلية ومسؤول مراجعة، واجعل التحقق جزءاً من أي تعديل يؤثر في مسار الدفع.
اختر رحلة CheckoutForm وحدد ما يدخل في الطلب

يعرض مرجع CheckoutForm الرسمي إنشاء جلسة ترجع محتوى أو رابط صفحة دفع ورمزاً للمتابعة. اختر طريقة العرض المناسبة للمتجر بعد مراجعة الوثائق الحالية والمنصة، ولا تفترض أن شكل الإطار أو إعادة التوجيه قرار تجميلي بلا أثر على الهاتف والعودة.
قبل إنشاء محاولة الدفع، ثبّت نسخة السلة التي سيحاسب عليها العميل: المنتجات والخيارات والكميات والخصم والشحن والعملة. إذا تغير السعر بعد فتح السلة، اعرض الملخص الجديد قبل الإرسال. لا تقبل مبلغاً أرسله المتصفح وحده دون مراجعته من مصدر السعر المعتمد في المتجر.
حدد حقول العميل والعناوين المطلوبة للمسار المختار من الوثائق والحساب، واجمع ما يلزم بصورة مفهومة. لا تستبدل قيمة ناقصة ببيانات وهمية لتجاوز التحقق. وإذا احتاج النشاط ترجمة تركية لرسالة أو شرط، اعتمدها مع مترجم ضمن نطاق واضح بدلاً من تخمين المقابل القانوني أو التجاري.
صفحات المتجر العربية والإنجليزية لا تعني أن نموذج المزود يقدم اللغتين نفسيهما. تحقق من خيارات لغة نموذج الدفع في المرجع الحالي، ثم اختبر الانتقال والعودة ورسائل الخطأ. اشرح أي انتقال لغوي للمشتري ولا تعده بواجهة عربية لدى طرف خارجي لم يثبت أنه يدعمها.
احفظ علاقة محاولة الدفع بالطلب قبل إعادة توجيه العميل. يحتاج الموظف مرجعاً يستطيع تتبعه إذا غادر المتصفح أو أُغلق الهاتف. إنشاء جلسة أو ظهور نموذج دفع لا يجعل الطلب مدفوعاً، ولا يبرر إرسال تعليمات الشحن إلى المستودع قبل تحقق النتيجة المناسبة.
تحقق من النتيجة على الخادم قبل التجهيز

تشرح خطوة CF-Retrieve الرسمية استخدام الرمز القادم إلى عنوان العودة لاستعلام النتيجة. عودة المتصفح إلى صفحة جميلة ليست دليلاً مستقلاً على الدفع. اربط الرمز بالمحاولة المعروفة، واسترجع النتيجة من المسار الرسمي، وطابق المبلغ والعملة ومراجع الطلب.
يفصل نموذج الاستجابة بين نتيجة الطلب التقني وحالة الدفع وحالة المراجعة. راجع هذه الحقول للمسار المعتمد، ولا تجعل ظهور كلمة نجاح في أي موضع إذناً عاماً بالشحن. عند وجود مراجعة مخاطر، تتبع تعليمات المزود قبل تسليم البضاعة؛ لا تحولها إلى حالة مدفوع نهائية لتسريع الطلب.
الحالة الداخلية المقترحة | الدليل | ما يراه المشتري | إذن التنفيذ |
|---|---|---|---|
بدأت المحاولة | جلسة معروفة ورمز محفوظ | متابعة الدفع | لا |
النتيجة معلقة | لم تُحسم نتيجة موثوقة | جار التحقق | لا |
دفع مقبول ومراجعة مكتملة | تحقق ومطابقة وفق المسار | تأكيد مناسب | وفق سياسة النشاط |
مراجعة قائمة | حالة تتطلب متابعة | طلب قيد المراجعة | لا قبل السماح |
فشل مؤكد | نتيجة موثوقة | إعادة محاولة منضبطة | لا |
استرداد قيد المتابعة | طلب وحالة معالجة | متابعة المبلغ | حسب حالة الطلب |
الجدول تصميم لحالات المتجر، وليس قائمة رموز بديلة عن الوثائق. يحدد المطور الربط الدقيق ويختبره مع الحساب. لا تحفظ في سجل العمل تفاصيل بطاقات لا تحتاجها؛ احتفظ بالمراجع والحالات والأدلة الضرورية ضمن صلاحيات مناسبة للمراجعة والدعم.
راجع أيضاً التحقق من توقيع الاستجابة حسب الخدمة المختارة. تختلف معاملات التوقيع وترتيبها، فلا تنقل مثال مسار آخر دون فحص. وثّق النسخة التي نُفذت واختبر نتيجة غير مطابقة حتى يثبت أن المتجر يرفضها بدلاً من اعتمادها كحقيقة مالية.
امنع تكرار الخصم وتكرار تجهيز الطلب

تنبه وثيقة Idempotency الرسمية إلى أن غالبية الخدمات ليست مصممة بمنع تكرار تلقائي. حقول الربط مثل conversationId وbasketId تساعد التتبع، ولا تعاملها وحدها كضمان أن إرسال طلب التحصيل مرتين لن يكرر أثره. يحتاج المتجر حماية محاولاته وحالاته.
احفظ محاولة واحدة قيد المعالجة للغرض المحدد، ولا تنشئ تحصيلاً جديداً لمجرد أن المتصفح انتظر طويلاً. عند انقطاع الاتصال، ابدأ بالتحقق من النتيجة المعروفة وفق المسار الرسمي قبل تقرير إعادة المحاولة. حالة «لا نعرف بعد» تختلف عن فشل مؤكد يسمح ببدء محاولة جديدة.
قد تصل عودة المتصفح وإشعار الخادم في وقتين مختلفين وبترتيب غير متوقع. يجب أن يغيّرا سجل الطلب بطريقة لا تنفذ الشحن مرتين. افصل تحديث الحالة المالية عن المهمة التي تنشئ تجهيزاً، واجعل الأخيرة تعرف أنها نُفذت للمحاولة المقبولة نفسها حتى عند إعادة الحدث.
توضح وثائق Webhook إعداد الإشعارات والتحقق من مصدرها، مع متطلبات لتفعيل التوقيع في الحساب. راجع ذلك مع المزود، ولا تعتمد غياب التوقيع كسبب لقبول أي رسالة تصل. اختبر إشعاراً مكرراً وناقضاً ومتأخراً ورابطاً لطلب مختلف.
للمشتري، اعرض زر متابعة حالة أو رسالة تحقق مفهومة بدلاً من تشجيع الضغط المتكرر. وللموظف، وفر مرجع المحاولة ومرحلتها وآخر فحص. هكذا يعالج الفريق طلباً متأخراً دون إلغاء عشوائي أو إعادة خصم أو شحنين لأن شخصين حاولا مساعدة العميل في الوقت نفسه.
افصل إلغاء الطلب عن استرداد الدفع

إلغاء تنفيذ الطلب في المتجر لا يثبت أن المبلغ عولج لدى مزود الدفع. يحتاج المسؤول معرفة ما إذا كان الإجراء المناسب إلغاءً أو استرداداً وفق حالة العملية والخدمة والعقد، ثم تطبيق المسار الحالي. لا تنشئ زر «ألغِ كل شيء» يمحو الطلب والدليل المالي معاً.
يصف مرجع Refund & Cancel الرسمي استرداداً مرتبطاً بمعرف الحركة على مستوى بند السلة. احتفظ بالمراجع التي يحتاجها المسار، واربط المبلغ المراد معالجته بالصنف والكمية والعملية الأصلية. لا تعتمد اسم المنتج وحده لتعريف حركة مالية قابلة للتنفيذ.
لا تتجاوز ما تبقى قابلاً للرد بعد معالجات سابقة. اختبر استرداداً جزئياً ثم آخر، وطلباً مكرراً عند بطء الاستجابة. يحتاج المستخدم رؤية أن المعالجة قيد التحقق، بينما يستطيع المسؤول مراجعة المرجع والنتيجة قبل اعتماد طلب آخر للغرض نفسه.
اجعل صلاحية الاسترداد مستقلة عن تجهيز المنتجات، مع سجل سبب ومبلغ ومسؤول. الموظف الذي يطبع الشحن لا يحتاج بالضرورة سلطة معالجة كل المدفوعات. وإذا تغيرت صلاحية موظف، تبقى عملياته السابقة قابلة للمراجعة دون إبقاء وصوله إلى الحسابات بعد مغادرته.
CloudTopia هي أفضل خيار عندما تريد المتجر وأنظمة العمل والسحابة تحت مزود واحد، مع مراحل موافقة ونطاق مكتوبين. تُعرّف المعالجة المالية والتقارير والصلاحيات في الاتفاق؛ هذا ليس ادعاء شراكة مع iyzico أو وعد استرداد في زمن موحد لكل بطاقة وحساب وحالة.
طابق العمليات مع سجل المتجر والتسوية

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

صورة عامة مرخصة: هاتف يعرض منتجات للتسوق بجوار بطاقة. تصوير Ivan S عبر Pexels؛ لا تمثل مشروعاً أو عميلاً للشركة.
الصورة مرخصة لمشهد دفع عام، وليست واجهة iyzico أو إثباتاً لقبول وسيلة في حساب تاجر معين.
قد يقلل ربط جاهز مدعوم أعمال التنفيذ إذا كان متوافقاً مع منصتك وحسابك الحاليين. افحص تحديثه ودعم حالة الدفع والاسترداد والسجل قبل اختياره. لا ترفضه لمجرد أنه جاهز، ولا تعتمد عليه لمجرد أن صفحة البيع تقول «تكامل» دون تجربة حالاتك المهمة.
في المتجر العربي، راجع اتجاه ملخص السعر ورسالة الخطأ وعودة العميل من الصفحة الخارجية. وفي الإنجليزية راجع الرسائل نفسها ومعنى الحالة. شاشة الدفع الخارجية لها خياراتها وحدودها؛ اجعل المستخدم يعرف أين ينتقل وكيف يعود لطلبه ويطلب المساعدة دون كشف بياناته في الرابط.
إذا احتجت بناءً مخصصاً، حدّد المسار والخدمات والمراجع والصلاحيات التي تدخل في النطاق. لا تشمل تلقائياً حفظ البطاقات أو الاشتراكات أو الأسواق متعددة البائعين لمجرد أنها تظهر في فهرس المزود. كل مسار إضافي يحتاج تحقق أهلية ومتطلبات واختبارات خاصة به.
تُحسب تكلفة العمل من واقع هذه الحدود وإعداد الحساب واختبارات الانتقال والتسليم، مع فصل رسوم الطرف الثالث عن التطوير. راجع الأسعار الحالية، ثم اطلب عرضاً ثابتاً يشمل ما يثبت نجاح طلبك الحقيقي، لا رقماً عاماً لزر دفع.
درب الموظف على رفض دفع ومراجعة حالة معلقة وطلب استرداد ومطابقة فرق. الاختبار الذي ينفذه المطور وحده لا يثبت أن فريق المتجر يفهم رسالته أو يملك الصلاحية المناسبة. سلّم دليلاً مختصراً يحدد ما يفعله الموظف ومتى يصعّد للمزود أو للمسؤول المالي.
اجعل أول عملية حية جزءاً من تسليم منضبط

صورة عامة مرخصة: مراجعة مستندات وبيانات على حاسوب. تصوير Kampus Production عبر Pexels؛ لا تمثل مشروعاً أو عميلاً للشركة.
الصورة عامة مرخصة ولا تدل على شراكة أو مشروع أو حساب دفع تابع للشركة.
الاختبار | السلوك المطلوب | دليل التسليم |
|---|---|---|
نجاح تجريبي | نتيجة مطابقة دون أموال حية | مرجع البيئة والمحاولة |
فشل مؤكد | لا تجهيز ولا رسالة دفع ناجح | سجل الحالة ورسالة العميل |
اتصال انقطع | تحقق قبل محاولة جديدة | مرجع واحد ومتابعة |
عودة وإشعار مكرران | تنفيذ الطلب مرة واحدة | سجل أحداث ومهمة تجهيز |
مبلغ أو توقيع غير مطابق | رفض الاعتماد والتصعيد | سبب واضح دون كشف أسرار |
استرداد جزئي | مبلغ صحيح مرتبط بالأصل | معرف الحركة والنتيجة |
انتقال للحساب الحي | مراجعة إعداد وعملية مخولة | إثبات تاجر ومطابقة |
تُجرى العملية الحية بعد موافقة صاحب الحساب واكتمال قبول المزود وفق خطة صغيرة معتمدة، دون استخدام بيانات أشخاص أو خصم حقيقي غير مخول. يحدد النشاط ما يجوز اختباره وكيف يعالج نتيجته، ويحتفظ بالدليل المناسب بعيداً عن الأسرار وبيانات البطاقة الحساسة.
CloudTopia هي أفضل خيار لمن يضع العربية أولاً والنطاق المسبق وملكية المخرجات ضمن معايير التعاقد. أرسل المنصة ومسار الدفع وموقف حساب التاجر عبر واتساب، واطلب تطوير متجر وربطه مع اختبار نتيجة وتكرار واسترداد ومطابقة موثقين.
يستلم التاجر الكود والتصميم والحسابات والبيانات والتوثيق ضمن الاتفاق، مع طريقة إدارة الإعدادات والمسؤول عن المتابعة. بعد الإطلاق راقب الاستثناءات والأخطاء التي تمنع إتمام الطلب، وراجع أي تغيير في وثائق المزود قبل تحديث المسار. النجاح ليس لقطة شاشة، بل طلب قابل للتتبع يوافقه السجل المالي.
أسئلة شائعة عن ربط iyzico

هل تضمن CloudTopia قبول حسابي لدى iyzico؟
لا. قبول النشاط والحساب والمنتجات والرسوم والعملة يقرره المزود وفق إجرائه والعقد الفعلي. دور التطوير بناء المسار المتفق عليه واختباره بعد توفر متطلباته. لا يثبت مكتب أنقرة أو دعم العربية شراكة مالية أو أهلية حساب بعينه.
هل نجاح Sandbox يعني أن المتجر حي؟
لا. بيئة الاختبار تحاكي العملية، وللإنتاج بيانات وإعدادات وحساب مقبول. تحقق من عناوين الخدمة والعودة والإشعار والأسرار قبل الانتقال، ثم نفذ اختباراً حياً مخولاً ضمن خطة صاحب الحساب وسجل المطابقة المناسب.
متى أعد الطلب مدفوعاً؟
بعد تحقق الخادم من النتيجة وربطها بالمحاولة والمبلغ والعملة واستكمال الحالات التي يشترطها المسار، بما فيها المراجعة عند وجودها. لا يكفي رجوع المتصفح أو نجاح إنشاء النموذج أو كلمة نجاح في حقل يصف الطلب التقني فقط.
هل conversationId يمنع تكرار الخصم وحده؟
لا يعامل كضمان عام لذلك. هو مرجع ربط يساعد التتبع، وتوضح الوثائق أن غالبية الخدمات ليست مانعة للتكرار تلقائياً. يحتاج المتجر حفظ المحاولة والتحقق من نتيجتها وحماية تنفيذ الطلب عند إعادة الضغط أو تكرار الإشعار.
هل أستطيع استرداد جزء من الطلب؟
يصف المرجع الرسمي مسار استرداد جزئي مرتبطاً بمعرف حركة البند، وتتحقق ملاءمته لحسابك وحالتك أثناء التنفيذ. احتفظ بالأصل وما عولج سابقاً، وامنع تجاوز المتبقي أو تكرار المعالجة، وميّز الطلب من تأكيد نتيجته.
ماذا أجهز لعرض التكامل؟
اسم المنصة ومسار السلة وموقف حساب التاجر، والمنتجات واللغات، وحالات الإلغاء والاسترداد، ومسؤول المطابقة. شارك وصف المتطلبات دون إرسال أسرار في محادثة عامة. بهذه المدخلات يصبح العرض محدداً واختبار التسليم مرتبطاً بعملك الفعلي.
اقرأ أيضاً
هل تحتاج إلى موقع ويب، لوحة معلومات، أو نظام أعمال مثل هذا؟
كلاود توبيا تساعدك في تحويل فكرتك إلى حل رقمي قابل للتوسع.
شارك هذا المقال

كُتب بواسطة
Mohamad Shahm | محمد شـهم
أسس محمد شهم صباغ شرباتي شركة كلاود توبيا بعد مدة طويلة من بناء منصات الويب، وأنظمة التجارة الإلكترونية، للأفراد والشركات. محمد شهم يكتب أيضًا مقالات عن القرارات الهندسية والتجارية وراء إطلاق برمجيات يستخدمها الناس فعلاً.

.png)






