اتصال به بانک‌های ایرانی در اودوو

درگاه اتصال به بانک امکان پرداخت انلاین و مغایرت گیری خودکار را فراهم می‌کند.

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

Basics

transaction

هر پرداخت شامل دو دسته اطلاعات می شود: اطلاعات داخلی اودوو، اطلاعات بانک.

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

مثلا یک پرداخت ممکن است مربوط به یک فاکتور فروش باشد. 

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

Notification

تمام اطلاعاتی که بین درگاه و اودوو رد و بدل می‌شود با یک ساختار داده به نام notification شناخته می‌شود.

Provider

واسط برنامه نویسی API را برای پرداخت انلاین فراهم می‌کند.

به صورت پیش فرض درگاه‌های زیر در اودوو وجود دارد:

1. adyen
2. alipay
3. aps
4. asiapay
5. authorize
6. buckaroo
7. custom
8. demo
9. flutterwave
10. mercado_pago
11. mollie
12. ogone
13. paypal
14. payulatam
15. payumoney
16. razorpay
17. sips
18. stripe
19. xendi

مفاهیم بانکی

1. Configuration: تنظیم‌های عمومی درگاه
   
2. 1. name
   2. code
   3. state: desable, enable, test
   4. allow_tokenization
   5. capture_manually: انتقال پول منتظر ارسال محصول باشد
   6. allow_express_checkout: 
   7. redirect_form_view_id: یک صفحه فرم طراحی می‌شود در خود اودوو که اطلاعات پرداخت را از مشتری بگیرید.
      
   8. inline_form_view_id: یک فرم (معادل نمونه قبلی) در خود اودوو باز می‌کند. در همان صفحه. اطلاعات پرداخت مشتری را می‌گیرد.
   9. token_inline_form_view_id: یک فرم برای انتخاب توکن پرداخت. این فرم زمانی کاربرد دارد که توکنایز کردن برای این درگاه فعال باشد.
   10. express_checkout_form_view_id:
3. Availability: کنترل دسترسی به درگاه
   
4. 1. available_country_ids: لیست کشورهای مجاز
   2. available_currency_ids: لیست مجاز ارزها
   3. maximum_amount
5. Message: تمام پیام هایی را تعیین می‌کند که در حالت‌های متفاوت باید به مشتری نمایش داده شود.
   
6. 1. pending_msg: پیامی که حالت انتظار را نشان می‌دهد
   2. done_msg
   3. cancel_msg
7. Feature
8. 1. support_tokenization: امکان ذخیره کردن اطلاعات کارت و استفاده در پرداخت‌های بعدی
      
   2. support_manual_capture: تایید و تکمیل پرداخت توسط بانک بعد از ارسال محصول توسط فروشنده
      
   3. support_express_checkout: استفاده از گوگل و اپل در پرداخت بدون وارد کردن اطلاعات مشتری
      
   4. support_refund: امکان برگشت پول و کنسل شدن فروش

چطور پیاده سازی کنیم

فرآیند پرداخت بانک به صورت زیر است

پس هر پیاده سازی درگاه باید حداقل دو متد پیاده سازی کند: 

• ساختن یک تراکنش جدید
• تایید یک تراکنش

در قسمت JS هم باید معادل این کارها را انجام دهد.

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