أفضل الممارسات

قائمة موجزة لتكامل آمن وموثوق.

• احفظ سرّك على الخادم. لا تشحنه أبدًا في متصفّح أو تطبيق جوّال أو مستودع عامّ.
• استعمل HTTPS دائمًا. كل طلب وروابط العودة/الإلغاء لديك.
• خزّن الـaccess token. أعد استعماله حتى expire_time، ثمّ جدّده — لا تجلب جديدًا لكل طلب.
• تحقّق على الخادم. أكّد حالة الدفع (custom + المبلغ) قبل التنفيذ — التحويل وحده ليس دليلًا.
• كن آمنًا ضدّ التكرار (idempotent). استعمل مرجع custom فريدًا لكل طلب حتى لا تُحصِّل الإعادة مرّتين.
• ابدأ في sandbox. كامِل واختبر على base URL الخاصّ بـsandbox، ثمّ بدّل للإنتاج.
• عالِج كل خطأ. تفرّع حسب type وmessage.code؛ واعرض رسائل ودّية.