نوشته های Hamidreza Mahmoodi

نحوه اتصال به درگاه بانک ملی (BMI) با استفاده از فریمورک جنگو

Hamidreza Mahmoodi — Tue, 29 Jun 2021 15:37:42 +0430

همان طور که میدانید امروزه تمامی سایت های اینترنتی برای دریافت وجه از کاربر خود از یک درگاه پرداخت اینترنتی استفاده میکنند. درگاه پرداخت اینترنتی امکان پرداخت آنلاین وجوه مشتریان وبسایت‌های فروشگاهی عرضه‌کننده کالا و خدمات را فراهم می‌کند. مشتری پس از تکمیل مراحل انتخاب محصول یا خدمت مورد نظر، در مرحله آخر وارد درگاه پرداخت اینترنتی شده و با وارد کردن اطلاعات کارت بانکی خود شامل شماره کارت، رمز دوم، تاریخ انقضا و کد اعتبارسنجی (CVV2) پرداخت خود را به آسانی انجام می‌دهد.اینجاست که اهمیت داشتن یک درگاه پرداخت خوب برای وب سایت به خوبی احساس میشود. برای داشتن یک درگاه اینترنتی میتوانید از درگاه های مختلفی در وب سایت خود نظیر درگاه های بانک ملی، بانک ملت، درگاه پرداخت IDPAY، زیبال، زرین پال و ... استفاده کنید؛ اما سوال اینجاست که چگونه میتوان چنین سیستمی را در وبسایت خود پیاده سازی کرد.امروز قرار است در این مقاله صفر تا صد نحوه اتصال به درگاه بانک ملی را با استفاده از فریمورک قدرتمند جنگو پیاده سازی کنیم. پس با ما همراه باشید. ساخت یک وب سرویس بانک ملیقبل از انجام هر کاری نیاز به ساخت یک وب سرویس در خود وبسایت بانک ملی دارید. برای این منظور میتوانید به آدرس زیر مراجه کنید.درگاه پرداخت بانک ملی ایران(BMI)نصب پکیجخب حالا برای ادامه کار لازم است پکیج زیر را نصب کنید.pip install az-iranian-bank-gatewayssettings.pyبعد از نصب پکیج بالا تنظیمات زیر را در فایل settings.py پروژه خود انجام دهید.INSTALLED_APPS = [ # .... 'azbankgateways', # ... ] AZ_IRANIAN_BANK_GATEWAYS = { 'GATEWAYS': { 'BMI': { 'MERCHANT_CODE': '', 'TERMINAL_CODE': '', 'SECRET_KEY': '', }, }, 'DEFAULT': 'BMI', 'CURRENCY': 'IRR', # اختیاری 'TRACKING_CODE_QUERY_PARAM': 'tc', # اختیاری 'TRACKING_CODE_LENGTH': 16, # اختیاری 'SETTING_VALUE_READER_CLASS': 'azbankgateways.readers.DefaultReader', # اختیاری 'BANK_PRIORITIES': [ 'BMI', # and so on ... ], # اختیاری }GATEWAYS : تنظیمات مربوط به هر بانک به صورت دیکشنری های جدا در این قسمت وجود دارد. تنظیماتی مانند کلاس اجرا کننده، کلیدهای امنیتی که توسط بانک در اختیار شما قرار می گیرد.DEFAULT: در زمانی که به سازنده فکتوری پارامتری ارسال نشود از این تنظیم به عنوان بانک پیش فرض استفاده خواهد شد و ارتباطات با این بانک برقرار می شود.CURRENCY - (IRR, IRT): واحد پولی که نرم افزار با آن کار می کند. این واحد پولی فارغ از واحد پولی درگاه خواهد بود. در صورتی که واحد پولی نرم افزار با واحد پولی درگاه بانک متفاوت باشد تبدیل ریال به تومان یا بالعکس انجام خواهد شد.TRACKING_CODE_QUERY_PARAM : پارامتری که در هنگام بازگشت از درگاه به کال بک یو آر ال تعیین شده تنظیم و ارسال می گردد. به عنوان مثال زمانی که از کاربر از درگاه بانک باز می گردد چه پرداخت موفق داشته باشد و چه نا موفق کاربر به لینکی که در هنگام استفاده از درگاه تنظیم شده است٬ ارجاع داده می شود و در انتهای آن این رشته + کد پیگیری بازگردانده می شود تا بتوان داده ها را از این طریق بازیابی کرد.TRACKING_CODE_LENGTH: طول کد پیگیری تولید شده توسط سیستم است. دقت شود که در برخی درگاه ها مانند درگاه بانک ملی ایران، طول ۲۰ کاراکتر خطای شماره سفارش ارسال نشده است را می دهد.SETTING_VALUE_READER_CLASS: با مقدار دهی به این تنظیم شما می توانید حالت یک متغیر خوان اضافه کنید که قابلیت های دیگری مثل پروایدر و پشتیبانی از یک بانک با چند اکانت و ... را به آن اضافه کنید.BANK_PRIORITIES: این آرایه اختیاری است. زمانی که وضعیت اتصال به درگاه به صورت خودکار تعیین شده باشد، ابتدا به بانک پیش فرض متصل می شود و سپس بر این اساس شروع به اتصال خواهد کرد، تا به اولین درگاه فعال برسد. در حالت پیش فرض این آرایه خالی است که بعد از اتصال به درگاه مورد نظر در صورت خطا بقیه درگاه ها امتحان نخواهند شد.urls.pyبعد از settings.py نوبت به فایل urls.py میرسد. پس، تنظیمات زیر را به فایل urls.py پروژه خود اضافه کنید.from django.contrib import admin from django.urls import path from azbankgateways.urls import az_bank_gateways_urls admin.autodiscover() urlpatterns = [ path('admin/', admin.site.urls), path('bankgateways/', az_bank_gateways_urls()), ]با اضافه کردن آدرس بالا به لیست یو آر ال ها، پرداخت ها پس از درگاه به این مسیر هدایت و اعتبار سنجی می شوند و سپس مجدد به سمت کال بکی که به ازای هر درخواست تنظیم می شود، مسیر یابی خواهد شد. migrateحالا نیاز است پروژه خود را با استفاده از دستور زیر migrate کنید.python manage.py migrateاگر از reverse proxy و https استفاده می کنید برای رفع موارد احتمالی حتما تنظیمات این [لینک](https://stackoverflow.com/questions/62047354/build-absolute-uri-with-https-behind-reverse-proxy/65934202#65934202) انجام دهید.views.pyبرای استفاده و اتصال به درگاه بانک کافی است یک `BankFactory` ایجاد کنیم و پارامترهای اجباری را تنظیم کنیم. سپس کاربر را می توانیم به درگاه بانک هدایت کنیم.در فایل view.py نیز ویو زیر را به ویوهای خود اضافه نمایید.from django.urls import reverse from azbankgateways import bankfactories, models as bank_models, default_settings as settings def go_to_gateway_view(request): # خواندن مبلغ از هر جایی که مد نظر است amount = 1000 # تنظیم شماره موبایل کاربر از هر جایی که مد نظر است user_mobile_number = '+989112221234' # اختیاری factory = bankfactories.BankFactory() bank = factory.create() # or factory.create(bank_models.BankType.BMI) or set identifier bank.set_request(request) bank.set_amount(amount) # یو آر ال بازگشت به نرم افزار برای ادامه فرآیند bank.set_client_callback_url(reverse('callback-gateway')) bank.set_mobile_number(user_mobile_number) # اختیاری # در صورت تمایل اتصال این رکورد به رکورد فاکتور یا هر چیزی که بعدا بتوانید ارتباط بین محصول یا خدمات را با این # پرداخت برقرار کنید. bank_record = bank.ready() # هدایت کاربر به درگاه بانک return bank.redirect_gateway()در صورتیکه تمایل دارید به صورت خودکار به اولین درگاه در دسترس متصل شوید. ابتدا از قسمت تنظیمات در بخش `BANK_PRIORITIES ` اولویت های بانک های مد نظر را وارید کنید. سپس به جای استفاده از متد `factory.create` از متد ‍`factory.auto_create` در این بخش استفاده کنید. به متد auto_create می توانید مبلغ مد نظر را نیز برای صحت سنجی از حداقل مبلغ نیز ارسال کنید.set_mobile_number متدی است که پارامتر شماره موبایل کاربری که قصد خرید دارد را به آن پاس میدهیم. این شماره موبایل جهت پرداخت و پیگیری آسان تر به درگاه ارسال می شودمیتوانید وجه موردنظر را از دیتابیس دریافت کرده و به amount پاس دهید و به درگاه پرداخت بفرستید:)بازگشت از بانکوضعیت رکورد بانک به شرح ذیل می باشد.WAITING: در انتظار برای انتقال کاربر به درگاه بانکREDIRECT_TO_BANK: کاربر به درگاه بانک منتقل شده است ولی هنوز از درگاه باز نگشته است.RETURN_FROM_BANK: کاربر از درگاه برگشته ولی عملیات صحت سنجی٬ یا تکمیل نشده است یا با خطا درهنگام تایید از سوی بانک مواجه شده است. در این شرایط می توان با فراخوانی مجدد در بازه زمانی کمتر از ۱۵ دقیقه که کاربر بازگشته است٬ عملیات تایید را مجدد درخواست کرد. شرح تایید مجدد در پایین تر آورده شده است.CANCEL_BY_USER: پرداخت توسط کاربر کنسل شده است.EXPIRE_GATEWAY_TOKEN: ارتباط با درگاه بانک برقرار شده ولی کاربر به درگاه هدایت نشده است.EXPIRE_VERIFY_PAYMENT: در بازه زمانی ۱۵ دقیقه پس از بازگشت٬ موفق به تایید اطلاعات پرداخت نشده ایم.COMPLETE: وضعیت پرداخت موفق است.برای این منظور ویو زیر را به ویوهای خود در views.py اضافه کنید.import logging from django.http import HttpResponse, Http404 from django.urls import reverse from azbankgateways import bankfactories, models as bank_models, default_settings as settings def callback_gateway_view(request): tracking_code = request.GET.get(settings.TRACKING_CODE_QUERY_PARAM, None) if not tracking_code: logging.debug("این لینک معتبر نیست.") raise Http404 try: bank_record = bank_models.Bank.objects.get(tracking_code=tracking_code) except bank_models.Bank.DoesNotExist: logging.debug("این لینک معتبر نیست.") raise Http404 # در این قسمت باید از طریق داده هایی که در بانک رکورد وجود دارد، رکورد متناظر یا هر اقدام مقتضی دیگر را انجام دهیم if bank_record.is_success: # پرداخت با موفقیت انجام پذیرفته است و بانک تایید کرده است. # می توانید کاربر را به صفحه نتیجه هدایت کنید یا نتیجه را نمایش دهید. return HttpResponse("پرداخت با موفقیت انجام شد.") # پرداخت موفق نبوده است. اگر پول کم شده است ظرف مدت ۴۸ ساعت پول به حساب شما بازخواهد گشت. return HttpResponse("پرداخت با شکست مواجه شده است. اگر پول کم شده است ظرف مدت ۴۸ ساعت پول به حساب شما بازخواهد گشت.")درخواست تایید مجدد از بانکimport logging from azbankgateways import bankfactories, models as bank_models, default_settings as settings factory = bankfactories.BankFactory() # غیر فعال کردن رکورد های قدیمی bank_models.Bank.objects.update_expire_records() # مشخص کردن رکوردهایی که باید تعیین وضعیت شوند for item in bank_models.Bank.objects.filter_return_from_bank(): bank = factory.create(bank_type=item.bank_type, identifier=item.bank_choose_identifier) bank.verify(item.tracking_code) bank_record = bank_models.Bank.objects.get(tracking_code=item.tracking_code) if bank_record.is_success: logging.debug("This record is verify now.", extra={'pk': bank_record.pk})آدرس پروژهاینم از اتصال درگاه بانک ملی با فریمورک جنگو؛ امیدوارم براتون مفید بوده باشه و خوشتون بیاد. موفق باشید و همیشه بدرخشید..

اعتبارسنجی کارت بانکی، شماره شبا و تبدیل شماره حساب به شماره شبا با فریمورک جنگو

Hamidreza Mahmoodi — Tue, 22 Jun 2021 22:28:36 +0430

شاید برای خیلی از توسع دهندگان وب و برنامه نویسان کسب کارهای الکترونیکی در زمینه وب اپلیکیشن های موبایل که از پرداخت آنلاین در سیستم خود استفاده می کنند، این سوال پیش بیاد که چطور متوجه شویم ،شماره کارت یا شماره شبایی که کاربران وارد می کنند معتبر است یا خیر. حتی زمانی که بخواهید از کاربران شماره شبا بگیرید، این امر ممکن است برای کاربران شما به منظور پیدا کردن شماره شبای خود سخت باشد(رفتن به بانک یا جستجو در وب سایت های بانکی و غیره). در حالی که تنها با داشتن یک شماره حساب از کاربران، میتوانید این اطلاعات را بدست آورده یا عملیات اعتبارسنجی را انجام دهید. ما در این مقاله قرار است با استفاده از وب فریمورک قدرتمند جنگو به معرفی پکیجی بپردازیم که بتوانید این مسائل را به راحتی و درچند ثانیه رفع کنید، بدون اینکه برای حل این مسائل نیاز به ارجاع به سایت های مختلف و مشکلات آن داشته باشید، که این اعتبارات را بسنجند یا شماره حساب را به شماره شبا تبدیل کنند. جلوتر با وارد کردن چند خط کد در بک اند خود خواهید توانست این مسائل را به راحتی هرچه تمام تر بررسی کنید.موارد استفاده:1.مورد استفاده در اپلیکیشن ها پرداخت انلاین برای اعتبارسنجی کارت بانکی کاربر مورد نظر.2.مورد استفاده در سایت های پرداخت انلاین برای اعتبارسنجی کارت بانکی کاربر مورد نظر.3.تبدیل شماره حساب کاربر به شماره شبا.4.مورد استفاده در سایت هایی با کاربری بین المللی برای اعتبارسنجی شماره شبا.و اما پکیجی که قرار است از آن استفاده کنیمaz-iranian-bank-introبرای شروع کار لازم است این پکیج رو با استفاده از دستور زیر نصب کنید.pip install az-iranian-bank-introنحوه استفادهاعتبار سنجی کارت های بانکیبرای اعتبار سنجی کارت های بانکی کافی است متد اعتبار سنجی را ایمپورت کنیم و شماره کارت مورد نظر را به آن پاس دهیم. در صورتی که شماره کارت مورد نظر معتبر باشد برنامه به کار خود ادامه خواهد داد و در صورتی که نا معتبر باشد exception ارسال خواهد شد.import logging from azbankintro import card_validate, CardValidationException try: card_validate('6280992042433333') logging.debug('bank card is valid') except CardValidationException: logging.debug('bank card is not valid')اعتبار سنجی IBAN یا شماره شبابرای اعتبار سنجی شماره IBAN کافی است متد اعتبار سنجی را ایمپورت کنیم و شماره IBAN مورد نظر را به آن پاس دهیم. در صورتی که شماره مورد نظر معتبر باشد برنامه به کار خود ادامه خواهد داد و در صورتی که نا معتبر باشد exception ارسال خواهد شد.import logging from azbankintro import iban_validate, IBANValidationException try: iban_validate('IR062960000000100324200001') logging.debug('IBAN is valid') except IBANValidationException: logging.debug('IBAN is not valid')تبدیل شماره حساب به شبا یا IBANدر صورتی که تمایل دارید شماره حساب بانک مورد را تبدیل به شماره شبا کنید می توانید از ساختار زیر استفاده کنید.from azbankintro import * IBAN.calculate_iban(BankEnum.MELLI_BANK, '0338404829005')در صورتی که نوع بانک مد نظر را ندارید و فقط رشته آن را دارید می توانید از کد زیر جهت دریافت بانک استفاده کنید.from azbankintro import * s = 'BMI' bank_type = BankEnum(s) IBAN.calculate_iban(bank_type, '0338404829005')در صورتی که یک instance از نوع IBAN دارید نیز می توانید عملیات اعتبار سنجی را به گونه زیر انجام دهید.from azbankintro import * s = 'BMI' bank_type = BankEnum(s) iban = IBAN.calculate_iban(bank_type, '0338404829005') iban.validate()می توانید از فرمتر نیز استفاده کنید.from azbankintro import * iban = IBAN.calculate_iban(BankEnum.MELLI_BANK, '0338404829005') print(iban.__str__()) print(iban.format('-')) print(iban.format(' ')) """ IR040170000000338404829005 IR04-0170-0000-0033-8404-8290-05 IR04 0170 0000 0033 8404 8290 05 """امیدوارم براتون مفید بوده باشه و خوشتون بیاد.