دەرەڕێی پارەدانی (FIB)

وەسف

ئەم پێوەکراوەی وۆردپرێس دەرەڕێی پارەدانی (FIB) زیاد دەکات بۆ (WooCommerce)، کە ڕێگە بە بەکارهێنەران دەدات پارەدان ئەنجام بدەن، بە بەکارهێنانی سیستەمی پارەدانی بانکی یەکەمی ئێراق (First Iraqi Bank).

شێوەپێدانی بەستەری هەمیشەیی

دەبێت بەستەری هەمیشەیی وۆردپرێس وەک ناوی بابەت (Post name) دابنرێت: بۆ نموونە:- http://localhost/wordpress/sample-post/

دەتوانیت ئەم ڕێکخستنە بگۆڕیت لە بەڕێوەبەرایەتیی وۆردپرێس ڕێکخستنەکان بەستەرە هەمیشەییەکان.

تکایە ئاگاداربە کە نابێت بەستەری هەمیشەیی بەم شێوەیە دابنرێت (your_wordpress_url/index.php/post)، ئەگەرنا ڕووبەڕووی کێشەی (پەڕە نەدۆزرایەوە) دەبیتەوە.

ڕاژەکانی لایەنی سێیەم

ئەم پێوەکراوە پشت دەبەستێت بە ڕاژەی پارەدانی بانکی یەکەمی ئێراق (First Iraqi Bank) بۆ چارەسەرکردنی گواستنەوەکان. ئەم خاڵە کۆتاییە دەرەکییانەی خوارەوە بەکاردەهێنرێن:

  • دروستکردنی پارەدان: https://fib.stage.fib.iq/protected/v1/payments
  • هەڵوەشاندنەوەی پارەدان: https://fib.stage.fib.iq/protected/v1/payments/4d6f7625-60f7-48e3-82e3-b4592a4eb993/cancel
  • پشکنینی دۆخی پارەدان: https://fib.stage.fib.iq/protected/v1/payments/{paymentid}/status

زانیاری ڕاژەی لایەنی سێیەم

پێوەکراوەکە دراوەی پارەدان دەنێرێت بۆ خاڵەکانی کۆتایی (API)ی بانکی یەکەمی ئێراق (First Iraqi Bank) بە مەبەستی دروستکردنی پارەدانەکان، پشکنینی دۆخەکانی پارەدان، و هەڵوەشاندنەوەی پارەدانەکان.

تکایە پێداچوونەوە بە مەرجەکان و سیاسەتی تایبەتێتی دابینکەری ڕاژەدا بکە، بۆ تێگەیشتن لەوەی چۆن مامەڵە لەگەڵ دراوەکەت دەکرێت و دڵنیابوونەوە لەوەی کە پابەندیت بە داواکارییەکانیان.

تایبەتمەندییەکان

  • دەرەڕێی پارەدانی (FIB) تێکەڵ بە (WooCommerce) دەکات.
  • پەڕەیەکی دەستکرد دابین دەکات بۆ پیشاندانی کۆدی (QR) بۆ پارەدان.
  • دوگمەیەکی دەستکرد بۆ بەدیهێنانەوەی کۆدی (QR).
  • پارەدانی دوگمەی ڕاستەوخۆی کەسی، بازرگانی و کۆمپانیاکان بۆ ئامێرەکانی مۆبایل.
  • بە شێوەیەکی خۆکار دۆخی پارەدان دەپشکنێت و دۆخی داواکاری بەڕۆژ دەکاتەوە لە کاتی تەواوکردنی پارەدان.
  • پاڵپشتی بڵۆکەکانی (WooCommerce) دەکات بۆ ئەزموونێکی پارەدانی بێ کێشە.

پێداویستییەکان

  • پێوەکراوی (WooCommerce) دامەزرێنراو و چالاک کراو.
  • هەژمارێکی (FIB)ی دروست و باوەڕنامەکانی (API).

جێگیرکردن و دامەزراندن

  1. داگرتنی پێوەکراوەکە:

    • پێوەکراوەکە لە کۆگای (GitHub) وەک پەڕگەی (ZIP) دابگرە.
  2. دامەزراندنی (WooCommerce):

    • دڵنیابەرەوە کە پێوەکراوی (WooCommerce) دامەزرێنراوە و چالاک کراوە لە بەڕێوەبەرایەتیی وۆردپرێسـەکەت.
  3. دامەزراندنی پێوەکراوەکە:

    • لە داشبۆردی وۆردپرێسـەکەت، بچۆ بۆ پێوەکراوەکان > زیادکردنی پێوەکراو > پێوەکراو بار بکە.
    • پەڕگەی (ZIP)ی دابەزێنراو باربکە و کرتە لە ‘دامەزراندنی پێوەکراو’ بکە.
    • یان بە جێگرەوە، دەتوانیت پێوەکراوەکە ڕاستەوخۆ دابمەزرێنیت لە ڕێگەی شاشەی پێوەکراوەکانی وۆردپرێس.
  4. چالاککردنی پێوەکراوەکە:

    • دوای دامەزراندن، پێوەکراوەکە چالاک بکە لە ڕێگەی شاشەی ‘پێوەکراوەکان’ لە وۆردپرێس.
  5. چالاککردنی دەرەڕێی پارەدانەکە:

    • کاتێک چالاک کرا، دەبێت دەرەڕێی پارەدان چالاک بکەیت لە (WooCommerce) ڕێکخستنەکان شێوازی پارەدان.
    • جێگیرکردن تەواو بکە بە دیاریکردنی چوارگۆشەی پیاچوونەوەی چالاککردنی دەرەڕێی پارەدانی (FIB).
    • هەروەها دەتوانیت ناونیشان و وەسفی دەرەڕێکە بگۆڕیت بۆ کۆنترۆڵکردنی چۆنێتی دەرکەوتنی لە کاتی پارەدان.
  6. شێوەپێدانی پێوەکراوەکە:

    • In the sidebar, go to FIB Payment Gateway and enter your FIB credentials:
      • (URL)ی بنچینەی (FIB): (URL)ی بنچینەیە بۆ (API)ی پارەدانی (FIB).
      • (Client ID): کلیلی (API)ی پارەدانی (FIB)ـەکەت.
      • (Client Secret): نهێنیی (API)ی پارەدانی (FIB)ـەکەت.

بەکارهێنان

دوای دامەزراندن و چالاککردن، دەرەڕێی پارەدانی (FIB) وەک شێوازێکی پارەدان لە (WooCommerce) بەردەست دەبێت. دەتوانیت چالاکی بکەیت لە WooCommerce > ڕێکخستنەکان > شێوازی پارەدان.

لە کاتی چالاککردنی پێوەکراوەکەدا، پێوەکراوەکە بە شێوەیەکی خۆکار پەڕەیەکی دەستکردی نوێ دروست دەکات، ئەم پەڕە دەستکردە بە شێوەی جووڵەدار کۆدی (QR) بەدی دەهێنێت، بەپێی وردەکارییەکانی داواکاری و ڕێگە بە بەکارهێنەران دەدات کۆدەکە بپشکنن و پارەدان ئەنجام بدەن، دوای تەواوکردنی پرۆسەی پارەدان.

شێوەپێدان

  • ڕێکخستنەکانی (API): شێوەپێدان بۆ ڕێکخستنەکانی (API)ی (FIB) بکە بە (URL)ی بنچینە، (Client ID)، و (Client Secret)ـەوە.
  • ڕێکخستنەکانی کۆدی (QR): کڕیارخوازکردنی ڕواڵەت و توانای کرداریی ئەو کۆدی (QR)ـەی بۆ بەکارهێنەران پیشان دەدرێت.

کڕیارخوازکردن

پێوەکراوەکە چەندین قولاپ و پاڵاوتە دابین دەکات، کە ڕێگە بە گەشەپێدەران دەدات توانا کردارییەکانی فراوان بکەن و تایبەتمەندییە دەستکردەکان تێکەڵ بکەن بەپێی پێویست.

چارەسەرکردنی کێشەکان

  • کێشە باوەکان:

    • دڵنیابەرەوە کە باوەڕنامەکانی (FIB)ـەکەت ڕاستن و خاڵی کۆتایی (API) توانای دەستپێگەیشتنی هەیە.
    • دڵنیابەرەوە کە پێوەکراوی (WooCommerce) بەدروستی شێوەپێدانی بۆ کراوە و چالاکە.
    • پشکنین بکە بۆ پێکدادان لەگەڵ پێوەکراوەکانی تر کە ڕەنگە دەستوەردان لە دەرەڕێی پارەدانەکەدا بکەن.
    • دڵنیابەرەوە لە دانانی بەستەرێکی هەمیشەیی وۆردپرێسی گونجاو.
  • هەڵەدۆزین:

    • هەڵەدۆزین لە وۆردپرێس چالاک بکە بە زیادکردنی define('WP_DEBUG', true); و define('WP_DEBUG_LOG', true); بۆ پەڕگەی wp-config.php ـەکەت.
    • پشکنین بۆ پەڕگەی debug.log بکە لەناو پێڕستی wp-content بۆ هەر هەڵە یان ئاگادارکردنەوەیەک.

مۆڵه‌ت

ئەم پێوەکراوە مۆڵەتی پێدراوە لەژێر مۆڵەتی گشتیی گنو (GNU General Public License v2.0) یان نوێتر.

نووسەر

Gateway ICT Solutions

کۆدی سەرچاوە

کۆدی سەرچاوەی ئەم پێوەکراوە بەردەستە لە کۆگای GitHub

پاڵپشتی

بۆ پاڵپشتی، تکایە سەردانی بەشی کێشەکانی کۆگای (GitHub)ی پێوەکراوەکە بکە.

پهد

چۆن باوەڕنامەکانی (API)ی (FIB) بەدەست بهێنم؟

  • دەتوانیت باوەڕنامەکانی (API)ی (FIB) بەدەست بهێنیت لە ڕێگەی پەیوەندیکردن بە تیمی پاڵپشتیی بانکی یەکەمی ئێراق (First Iraqi Bank) لە support@fib-payment.com.

پێداچوونەوەکان

هیچ پێداچوونەوەیەک نەنووسراوە بۆ ئەم پێوەکراوە.

بەشداربووان و گەشەپێدەران

“دەرەڕێی پارەدانی (FIB)” نەرمەواڵەیەکی سەرچاوە کراوەیە. ئەم کەسانەی خوارەوە بەشدارییان تێدا کردووە.

بەشداربووان

“دەرەڕێی پارەدانی (FIB)” وەرگێڕدراوە بۆ 1 زمان. سوپاسی وەرگێڕەکان دەکەین بۆ بەشداریکردنیان.

“دەرەڕێی پارەدانی (FIB)” وەربگێڕە بۆ زمانەکەی خۆت.

دەتەوێت بەشداربیت لە گەشەپێدان؟

گەڕان لە کۆدەکەدا بکە، سەیری تەمارگەی (SVN) بکە، یان بەشداربە لە ڕووداوتۆماری گەشەپێدان لە ڕێگەی (RSS).

ڕووداوتۆمارگەریی گۆڕین

2.3.2
* Bug Fixes, and improvments.

2.3.1
* Bug Fixes, and improvments.

2.3.0
* Bug Fixes, and improvments.

2.2.0
* Added redirect uri upon payment creation.

2.1.0
* Allow all users to regenerate QR codes.
* Allow all users to check payment status.

2.0.0
* Major updates, bug fixes, and improvments.

1.3.5
* Bug Fixes, and improvments.

1.3.3
* Bug Fixes, and improvments.

1.3.3
* Bug Fixes, and improvments.

1.3.2
* Bug Fixes, and improvments.

1.3.1
* Fixes, and improvments.

1.3.0
* Added three app link buttons so user can directly open the relevent app without the need to scan the QR code.
* Added readable code, to enter the code manually.
* Improved QR code generation for better user experience.

1.2.2
* Added new payment error handling.
* Improved nonce security for API requests.
* Fixed potential XSS vulnerabilities.
* Enhanced logging for API responses.
* Updated documentation with clearer instructions.

1.2.1
* Fixed bugs related to payment status checks.
* Improved error handling and logging.
* Enhanced security measures for API credentials.
* Updated documentation for clarity and accuracy.
* Minor performance optimizations.

1.2.0
* Added new payment status check via AJAX.
* Refactored JavaScript to use localized variables.
* Updated function names and classes as per the team request.
* SANITIZE , VALIDATE, and ESCAPE data.
* updated the documentation.
* Added source map.
* Added more security concerns.
* Fixed redirect issue.

1.1.0
* Initial release.