توسعه API و اتصال سیستم‌ها

اتصال API و سیستم‌های بانکی کار ویترین نیست؛ کار دقت است. درگاه پرداخت، هسته بانک، استعلام شبا یا تسویه دسته‌ای هر کدام قرارداد، ساعت قطعی و سند نمونه دارند. KGSM قبل از برآورد نمونه واقعی می‌خواهد وگرنه تاریخ تحویل شناور است.

مخاطب، ریسک و روش KGSM

مدیر فنی یا مالی که باید درگاه، هسته بانک یا سرویس تسویه را به سامانه داخلی وصل کند

اتصال بدون شناسه یکتا و تطبیق روزانه یعنی واریز یتیم، سند دو بار، و ساعت‌ها مغایرت در روز شلوغ.

KGSM وضعیت تراکنش را داخل همان سند مالی می‌گذارد و وب‌هوک و شغل تطبیق را در نسخه اول می‌نویسد.

شناسه یکتا و وضعیت واحد

هر تلاش پرداخت یک شناسه داخلی دارد که به شناسه درگاه وصل می‌شود. موفقیت درگاه و شکست پنل یعنی پشتیبانی دو روایت می‌شنود. صفحه بازگشت کاربر، وب‌هوک و استعلام معوق هر سه باید به یک وضعیت برسند. این را در پروژه‌های افتتاح حساب دیجیتال و همراه بانک صندوق تمرین کرده‌ایم. لاگ را بدون داده حساس کارت نگه می‌داریم. مهلت لینک پرداخت را صریح می‌گذاریم تا سفارش معلق نماند.

هر پرداخت شناسه داخلی یکتا داشته باشد. وب‌هوک پیاده‌سازی نشد و فقط بازگشت مرورگر سفارش را ساخت؛ قطع شدن کاربر سفارش یتیم گذاشت.

هسته بانکی و محدودیت دنیای واقعی

همه بانک‌ها REST تمیز نمی‌دهند. گاهی فایل، سوییفت داخلی یا ساعت قطعی شعبه‌ای است. کشف KGSM شامل محیط تست بانک، سقف تراکنش، و مسئول فنی طرف مقابل است. اگر طرف مقابل SLA ندارد، تاریخ ما هم شرطی است. برای صندوق و اقساط، جدول بازپرداخت باید با واریز هسته یکی شود. نقش خزانه‌دار را از برنامه‌نویس جدا می‌کنیم تا کلید API روی لپ‌تاپ شخصی نماند.

کلید تولید روی لپ‌تاپ برنامه‌نویس بود و بعد از خروج او چرخیدنش یک روز طول کشید. وب‌هوک و بازگشت کاربر به یک وضعیت برسند.

تطبیق، کارمزد، حسابرسی

تطبیق روزانه خودکار اختلاف را همان روز نشان می‌دهد نه پایان ماه. کارمزد و مالیات درگاه روی رسید است. گزارش حسابرسی می‌گوید چه کسی استعلام را تکرار کرد. پشتیبان قبل از اجرای فایل تسویه دسته ای اجباری است. اگر فروشگاه یا CRM سفارش می‌سازد، همان شناسه پرداخت در هر سه جا دیده می‌شود.

تطبیق روزانه را خودکار کنید. ساعت قطعی بانک در برآورد نبود و تسویه عصر شعبه‌ها شکست خورد.

امنیت اتصال

کلید درگاه در env سرور است نه در گیت. IP allowlist و امضای وب‌هوک را تست می‌کنیم. محیط تست و تولید را مخلوط نمی‌کنیم. دسترسی مشاهده تراکنش با دسترسی اجرای تسویه جدا است. مستند حادثه: اگر بانک قطع شد سفارش چه وضعیتی می‌گیرد. این بندها در قرارداد است چون بعد از حادثه دیر است.

کارمزد در سود لحاظ نشد و سه ماه حاشیه دروغ بود. کلید درگاه را در گیت نگذارید.

محیط تست بانک را قبل از برآورد ببینید. استعلام تکراری دو سند برای یک واریز ساخت.

لاگ خام شماره کارت داشت و حادثه را غیرقابل مدیریت کرد. کارمزد را روی رسید ذخیره کنید.

نقش خزانه را از توسعه‌دهنده جدا کنید. وب‌هوک پیاده‌سازی نشد و فقط بازگشت مرورگر سفارش را ساخت؛ قطع شدن کاربر سفارش یتیم گذاشت.

کلید تولید روی لپ‌تاپ برنامه‌نویس بود و بعد از خروج او چرخیدنش یک روز طول کشید. قبل از فایل تسویه دسته ای پشتیبان بگیرید.

چک‌لیست اجرا

هر پرداخت شناسه داخلی یکتا داشته باشد.
وب‌هوک و بازگشت کاربر به یک وضعیت برسند.
تطبیق روزانه را خودکار کنید.
کلید درگاه را در گیت نگذارید.
محیط تست بانک را قبل از برآورد ببینید.
کارمزد را روی رسید ذخیره کنید.
نقش خزانه را از توسعه‌دهنده جدا کنید.
قبل از فایل تسویه دسته ای پشتیبان بگیرید.

سناریوی واقعی 1

وب‌هوک پیاده‌سازی نشد و فقط بازگشت مرورگر سفارش را ساخت؛ قطع شدن کاربر سفارش یتیم گذاشت.

هر پرداخت شناسه داخلی یکتا داشته باشد.

سناریوی واقعی 2

کلید تولید روی لپ‌تاپ برنامه‌نویس بود و بعد از خروج او چرخیدنش یک روز طول کشید.

وب‌هوک و بازگشت کاربر به یک وضعیت برسند.

سناریوی واقعی 3

ساعت قطعی بانک در برآورد نبود و تسویه عصر شعبه‌ها شکست خورد.

تطبیق روزانه را خودکار کنید.

سناریوی واقعی 4

کارمزد در سود لحاظ نشد و سه ماه حاشیه دروغ بود.

کلید درگاه را در گیت نگذارید.

سناریوی واقعی 5

استعلام تکراری دو سند برای یک واریز ساخت.

محیط تست بانک را قبل از برآورد ببینید.

سناریوی واقعی 6

لاگ خام شماره کارت داشت و حادثه را غیرقابل مدیریت کرد.

کارمزد را روی رسید ذخیره کنید.

برآورد حدودی سرمایه‌گذاری

اتصال یک درگاه مشخص معمولاً کمتر از ساخت کل سامانه است اما هسته بانکی و تسویه دسته‌ای جدا و گران‌تر برآورد می‌شود. دسترسی تست طرف مقابل اگر دیر برسد تاریخ ما هم جابه‌جا می‌شود.

سوالات متداول

فقط زرین‌پال می‌زنید؟

درگاه‌های رایج ایرانی و APIهایی که سند و محیط تست بدهند. هسته هر بانک جدا کشف می‌شود.

چقدر طول می‌کشد؟

یک درگاه مشخص اغلب دو تا شش هفته بعد از دسترسی تست. هسته بانکی به SLA طرف مقابل بستگی دارد.

PCI و داده کارت چه می‌شود؟

ما داده کارت خام نگه نمی‌داریم؛ توکن درگاه کافی است. محدوده در قرارداد امنیتی است.

به سامانه حسابداری هم وصل می‌شود؟

وضعیت پرداخت روی همان سند مالی می‌نشیند یا خروجی به نرم‌افزار حسابداری می‌رود.

صفحات مرتبط KGSM

وقتی این نکته به تیم زنده می‌رسد باید قانون اجرایی باشد نه اسلاید: هر پرداخت شناسه داخلی یکتا داشته باشد. برایش مالک و تاریخ بازبینی بگذارید تا در اولین هفته شلوغ فراموش نشود.

وقتی این نکته به تیم زنده می‌رسد باید قانون اجرایی باشد نه اسلاید: وب‌هوک و بازگشت کاربر به یک وضعیت برسند. برایش مالک و تاریخ بازبینی بگذارید تا در اولین هفته شلوغ فراموش نشود.

وقتی این نکته به تیم زنده می‌رسد باید قانون اجرایی باشد نه اسلاید: تطبیق روزانه را خودکار کنید. برایش مالک و تاریخ بازبینی بگذارید تا در اولین هفته شلوغ فراموش نشود.

وقتی این نکته به تیم زنده می‌رسد باید قانون اجرایی باشد نه اسلاید: کلید درگاه را در گیت نگذارید. برایش مالک و تاریخ بازبینی بگذارید تا در اولین هفته شلوغ فراموش نشود.

وقتی این نکته به تیم زنده می‌رسد باید قانون اجرایی باشد نه اسلاید: محیط تست بانک را قبل از برآورد ببینید. برایش مالک و تاریخ بازبینی بگذارید تا در اولین هفته شلوغ فراموش نشود.

وقتی این نکته به تیم زنده می‌رسد باید قانون اجرایی باشد نه اسلاید: کارمزد را روی رسید ذخیره کنید. برایش مالک و تاریخ بازبینی بگذارید تا در اولین هفته شلوغ فراموش نشود.

وقتی این نکته به تیم زنده می‌رسد باید قانون اجرایی باشد نه اسلاید: نقش خزانه را از توسعه‌دهنده جدا کنید. برایش مالک و تاریخ بازبینی بگذارید تا در اولین هفته شلوغ فراموش نشود.

وقتی این نکته به تیم زنده می‌رسد باید قانون اجرایی باشد نه اسلاید: قبل از فایل تسویه دسته ای پشتیبان بگیرید. برایش مالک و تاریخ بازبینی بگذارید تا در اولین هفته شلوغ فراموش نشود.

وقتی این نکته به تیم زنده می‌رسد باید قانون اجرایی باشد نه اسلاید: وب‌هوک پیاده‌سازی نشد و فقط بازگشت مرورگر سفارش را ساخت؛ قطع شدن کاربر سفارش یتیم گذاشت. برایش مالک و تاریخ بازبینی بگذارید تا در اولین هفته شلوغ فراموش نشود.

وقتی این نکته به تیم زنده می‌رسد باید قانون اجرایی باشد نه اسلاید: کلید تولید روی لپ‌تاپ برنامه‌نویس بود و بعد از خروج او چرخیدنش یک روز طول کشید. برایش مالک و تاریخ بازبینی بگذارید تا در اولین هفته شلوغ فراموش نشود.

وقتی این نکته به تیم زنده می‌رسد باید قانون اجرایی باشد نه اسلاید: ساعت قطعی بانک در برآورد نبود و تسویه عصر شعبه‌ها شکست خورد. برایش مالک و تاریخ بازبینی بگذارید تا در اولین هفته شلوغ فراموش نشود.

وقتی این نکته به تیم زنده می‌رسد باید قانون اجرایی باشد نه اسلاید: کارمزد در سود لحاظ نشد و سه ماه حاشیه دروغ بود. برایش مالک و تاریخ بازبینی بگذارید تا در اولین هفته شلوغ فراموش نشود.

وقتی این نکته به تیم زنده می‌رسد باید قانون اجرایی باشد نه اسلاید: استعلام تکراری دو سند برای یک واریز ساخت. برایش مالک و تاریخ بازبینی بگذارید تا در اولین هفته شلوغ فراموش نشود.

وقتی این نکته به تیم زنده می‌رسد باید قانون اجرایی باشد نه اسلاید: لاگ خام شماره کارت داشت و حادثه را غیرقابل مدیریت کرد. برایش مالک و تاریخ بازبینی بگذارید تا در اولین هفته شلوغ فراموش نشود.

وقتی این نکته به تیم زنده می‌رسد باید قانون اجرایی باشد نه اسلاید: اتصال بدون شناسه یکتا و تطبیق روزانه یعنی واریز یتیم، سند دو بار، و ساعت‌ها مغایرت در روز شلوغ. برایش مالک و تاریخ بازبینی بگذارید تا در اولین هفته شلوغ فراموش نشود.

وقتی این نکته به تیم زنده می‌رسد باید قانون اجرایی باشد نه اسلاید: KGSM وضعیت تراکنش را داخل همان سند مالی می‌گذارد و وب‌هوک و شغل تطبیق را در نسخه اول می‌نویسد. برایش مالک و تاریخ بازبینی بگذارید تا در اولین هفته شلوغ فراموش نشود.

وقتی این نکته به تیم زنده می‌رسد باید قانون اجرایی باشد نه اسلاید: مدیر فنی یا مالی که باید درگاه، هسته بانک یا سرویس تسویه را به سامانه داخلی وصل کند برایش مالک و تاریخ بازبینی بگذارید تا در اولین هفته شلوغ فراموش نشود.

وقتی این نکته به تیم زنده می‌رسد باید قانون اجرایی باشد نه اسلاید: اتصال یک درگاه مشخص معمولاً کمتر از ساخت کل سامانه است اما هسته بانکی و تسویه دسته‌ای جدا و گران‌تر برآورد می‌شود. دسترسی تست طرف مقابل اگر دیر برسد تاریخ ما هم جابه‌جا می‌شود. برایش مالک و تاریخ بازبینی بگذارید تا در اولین هفته شلوغ فراموش نشود.