التكاملات

اربط متجرك.
أصدر مفتاحًا. واختبره أولًا.

كل ما في هذه الصفحة يمكنك التحقق منه بنفسك: كتالوج الاتصالات كما تعلنه المنصة، والنطاقات التي يمكن أن يحملها المفتاح، والكائنات التي تعيدها لك بيئة الاختبار، والصيغ التي تكتبها واجهة التقارير.

كيف يُقرأ المفتاح

البيئة جزء من بيانات الاعتماد نفسها، لا إعداد بجوارها.

sk_live_· · · · · · · ·
pk / skقابل للنشر أو سرّي.
live / testالبيئة التي يُنفَّذ عليها الطلب.

يُرفض طلب بيئة الاختبار المُرسل بمفتاح حيّ بدل أن يُنفَّذ بصمت.

الكتالوج8 اتصالات
البيئاتحيّة واختبارية
بيئة الاختبار5 أنواع من الكائنات
التصديرCSV, XLSX, PDF
الكتالوج

ما الذي يتصل، وكيف.

ثمانية إدخالات، لكل منها طريقة التفويض التي يستخدمها. يُحفظ الاتصال لكل بيئة على حدة، فاتصال الاختبار والاتصال الحيّ بالمنصة نفسها سجلّان منفصلان ببيانات اعتماد منفصلة.

التكاملالفئةطريقة الاتصال
Shopifyالتجارة الإلكترونيةتفويض OAuth
WooCommerceالتجارة الإلكترونيةبيانات اعتماد API
Magento 2التجارة الإلكترونيةبيانات اعتماد API
Wixالتجارة الإلكترونيةتضمين
Squarespaceالتجارة الإلكترونيةتضمين
Zapierالأتمتةاشتراك Webhook
Makeالأتمتةاشتراك Webhook
Headless / CustomمخصّصAPI مباشرة
الوصول

المفتاح مجموعة نطاقات، لا كلمة مرور.

ما يحق للمفتاح فعله يُحدَّد عند إصداره، ويُفحص مع كل طلب.

قواعد تُطبَّق على كل طلب
البيئةتُقرأ من بادئة المفتاح، لا من إعداد مخزّن — فلا يمكن تحويل مفتاح اختبار إلى مفتاح حيّ.
عند التخزينلا يُخزَّن إلا تجزئة SHA-256. يُعرض النص الصريح مرة واحدة فقط، عند الإنشاء.
النطاقيحمل كل مفتاح مجموعة نطاقات صريحة. غياب النطاق يعني 403، لا نتيجة جزئية.
الشبكةقائمة سماح اختيارية لعناوين IP. يُرفض أي طلب من خارجها قبل تنفيذ أي شيء آخر.
الصلاحيةتُفحص الحالة وتاريخ الانتهاء مع كل طلب؛ ويتوقف المفتاح الملغى عن العمل فورًا.
المعدّلنافذة طلبات لكل مفتاح تحدّ من معدّل الاستدعاء المرتفع على نحو غير طبيعي.
النطاقات التي يمكن أن يحملها المفتاح
payments:readعرض روابط الدفع واسترجاعها.
payments:writeإنشاء روابط الدفع وإلغاؤها.
payouts:readعرض سجل المدفوعات الصادرة واسترجاعه.
payouts:writeطلب مدفوعات صادرة جديدة.
refunds:readعرض المبالغ المستردّة واسترجاعها.
refunds:writeإنشاء عمليات استرداد.
webhooks:manageتسجيل نقطة استقبال Webhook وتحديثها وحذفها.
analytics:readبيانات لوحة التحكم وتصدير المعاملات.
keys:readعرض مفاتيحك — دون أسرارها أبدًا.
keys:manageتدوير مفاتيحك وإلغاؤها.
بيئة الاختبار

اطلب الكائن قبل أن تبني عليه.

تعيد بيئة الاختبار كائنًا محدّدًا مسبقًا من النوع الذي تسمّيه، ويُسجَّل على جلستك لترى ما طلبته ومتى.

transactionمعاملة مكتملة بالمبلغ والعملة اللذين تحدّدهما.
webhookغلاف حدث من النوع الذي تسمّيه، مع كتلة بياناته.
settlementدفعة مُسوّاة بالإجمالي والصافي، ليظهر الفرق بينهما.
payoutدفعة صادرة مكتملة بالمبلغ والعملة اللذين تحدّدهما.
fraud_eventقرار مُقيَّم بدرجة، مع الأسباب التي أدّت إليه.
التصدير

إخراج البيانات مسار قائم بذاته.

تكتب التقارير ملفات CSV وXLSX وPDF، عند الطلب أو وفق جدول. هذه واجهة تصدير ونسمّيها كذلك — تنقل ملفًا، ولا تحافظ على اتصال بنظام في الطرف الآخر.

CSVمُهرَّب وفق المعيار، فيبقى الحقل الذي يحتوي فاصلة أو علامة اقتباس سليمًا ذهابًا وإيابًا.
XLSXمصنّف حقيقي لا ملف CSV بامتداد مختلف، لفرق المالية التي تفتحه في جدول بيانات.
PDFللتقارير التي تُحفظ أو تُرفق بدل أن يُعاد استيرادها.
مجدولالتقرير نفسه في تشغيل متكرر، بدل أن يتذكّر أحدهم استخراجه.

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

وجهات أخرى

الخطوة التالية، بحسب ما تعمل عليه.