Best Practices for Naming Bank API References in Payment Systems

المعلومة ذي ممكن تكون تافهة لك

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

على سبيل المثال لو نظامك يتيح تحويل الأموال عبر الربط مع البنك Bank APIs

المنطقي أنك بتروح تسوي جدول للمدفوعات Payments تسجل فيها البيانات اللي ترسلها للبنك payload وال response اللي بيرجع لك من طرف البنك.

الإشكالية اللي لاحظتها بتكون باستخدام مسمى عام مثل (Reference Number) عشان تخزن قيمة الحوالة أو العملية المالية اللي ترجع من البنك.

التسمية العامة بتخلي المبرمج الذي بيشتغل بعدك محتار هل هذا الرقم مولد داخليا أو يجي من خارج النظام.

اللي أشوفه أنا استخدام تسمية صريحة مثل External Bank Reference Number عشان يكون محجوز بوضوح لبيانات البنك فقط.

هذا الوضوح بيسهل عليك حياتك في عمليات المطابقة المالية (Reconciliation) ويحمي النظام عند الانتقال لل Production.

ممكن تشوف الموضوع مش مهم بس صدقني

لما فريق البزنس يطلب ميزة جديدة بتدرك وقتها أن خطا بسيط في المسميات بيأخذ منك وقت بالتست والفهم والتدقيق بالكود.

Original source

This content was originally published as a LinkedIn post. Open it in a new tab.