{"id":203471,"date":"2024-09-25T08:57:31","date_gmt":"2024-09-25T08:57:31","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/fib-payments-gateway\/"},"modified":"2025-12-02T11:29:16","modified_gmt":"2025-12-02T11:29:16","slug":"fib-payments-gateway","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/fib-payments-gateway\/","author":23136635,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"2.3.2","stable_tag":"trunk","tested":"9.5","requires":"","requires_php":"7.2","requires_plugins":null,"header_name":"FIB Payments Gateway","header_author":"Gateway ICT Solutions","header_description":"Adds the FIB Payments gateway to your WooCommerce website.","assets_banners_color":"","last_updated":"2025-12-02 11:29:16","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/github.com\/First-Iraqi-Bank","header_author_uri":"https:\/\/www.the-gw.com\/","rating":0,"author_block_rating":0,"active_installs":40,"downloads":2362,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","faq","changelog"],"tags":{"1.1.0":{"tag":"1.1.0","author":"thegateway","date":"2024-09-25 09:00:59"},"1.2.1":{"tag":"1.2.1","author":"thegateway","date":"2024-09-25 10:22:26"},"1.2.2":{"tag":"1.2.2","author":"thegateway","date":"2024-09-25 13:48:36"},"1.3.0":{"tag":"1.3.0","author":"thegateway","date":"2024-11-25 12:28:19"},"v1.3.1":{"tag":"v1.3.1","author":"thegateway","date":"2024-11-28 12:43:00"},"v1.3.2":{"tag":"v1.3.2","author":"thegateway","date":"2024-12-04 11:36:24"},"v1.3.3":{"tag":"v1.3.3","author":"thegateway","date":"2025-01-08 11:12:19"},"v1.3.4":{"tag":"v1.3.4","author":"thegateway","date":"2025-02-09 09:53:08"},"v1.3.5":{"tag":"v1.3.5","author":"thegateway","date":"2025-02-09 11:01:29"},"v2.0.0":{"tag":"v2.0.0","author":"thegateway","date":"2025-02-12 11:02:08"},"v2.1.0":{"tag":"v2.1.0","author":"thegateway","date":"2025-02-23 08:21:48"},"v2.2.0":{"tag":"v2.2.0","author":"thegateway","date":"2025-03-09 11:19:35"},"v2.3.0":{"tag":"v2.3.0","author":"thegateway","date":"2025-03-18 09:02:10"},"v2.3.1":{"tag":"v2.3.1","author":"thegateway","date":"2025-11-16 12:58:32"},"v2.3.2":{"tag":"v2.3.2","author":"thegateway","date":"2025-12-02 11:29:16"}},"upgrade_notice":{"2.0.0":"<ul>\n<li>Important: The plugin structure has been updated and rebuilt. Ensure you clear your browser cache to load the latest version.<\/li>\n<\/ul>","1.2.0":"<ul>\n<li>Important: The JavaScript file structure was updated. Ensure you clear your browser cache to load the latest version.<\/li>\n<\/ul>","1.1.0":"<ul>\n<li>Initial release.<\/li>\n<\/ul>"},"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3157610,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.1.0","1.2.1","1.2.2","1.3.0","v1.3.1","v1.3.2","v1.3.3","v1.3.4","v1.3.5","v2.0.0","v2.1.0","v2.2.0","v2.3.0","v2.3.1","v2.3.2"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[232093,1890,1887,286],"plugin_category":[45],"plugin_contributors":[235184],"plugin_business_model":[],"class_list":["post-203471","plugin","type-plugin","status-publish","hentry","plugin_tags-fib","plugin_tags-gateway","plugin_tags-payments","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-thegateway","plugin_committers-thegateway"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/fib-payments-gateway\/assets\/icon-256x256.png?rev=3157610","icon_2x":"https:\/\/ps.w.org\/fib-payments-gateway\/assets\/icon-256x256.png?rev=3157610","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>This WordPress plugin adds the FIB Payments gateway to WooCommerce, allowing users to make payments using the First Iraqi Bank's payment system.<\/p>\n\n<h3>Permalink Configuration<\/h3>\n\n<p>The WordPress permalink should be set as Post name: for example:- http:\/\/localhost\/wordpress\/sample-post\/<\/p>\n\n<p>You can change this setting in your WordPress Admin Panel \u2192 Settings \u2192 Permalinks.<\/p>\n\n<p>Please note that the permalink should not be set as following (your_wordpress_url\/index.php\/post), otherwise you will face page not found issue.<\/p>\n\n<h3>Third-Party Services<\/h3>\n\n<p>This plugin relies on the First Iraqi Bank's payment service for processing transactions. The following external endpoints are used:<\/p>\n\n<ul>\n<li><strong>Create Payment<\/strong>: <code>https:\/\/fib.stage.fib.iq\/protected\/v1\/payments<\/code><\/li>\n<li><strong>Cancel Payment<\/strong>: <code>https:\/\/fib.stage.fib.iq\/protected\/v1\/payments\/4d6f7625-60f7-48e3-82e3-b4592a4eb993\/cancel<\/code><\/li>\n<li><strong>Check Payment Status<\/strong>: <code>https:\/\/fib.stage.fib.iq\/protected\/v1\/payments\/{paymentid}\/status<\/code><\/li>\n<\/ul>\n\n<h3>Third-Party Service Information<\/h3>\n\n<ul>\n<li><strong>Service Provider<\/strong>: <a href=\"https:\/\/fib.iq\/\">First Iraqi Bank<\/a> <\/li>\n<li><strong>Service Terms of Use<\/strong>: <a href=\"https:\/\/fib.iq\/integrations\/web-payments\/\">Terms of Use<\/a><\/li>\n<li><strong>Service Privacy Policy<\/strong>: <a href=\"https:\/\/fib.iq\/privacy-and-security\/\">Privacy Policy<\/a><\/li>\n<\/ul>\n\n<p>The plugin sends payment data to the First Iraqi Bank\u2019s API endpoints for the purposes of creating payments, checking payment statuses, and canceling payments.<\/p>\n\n<p>Please review the service provider's terms and privacy policy to understand how your data is handled and ensure you are compliant with their requirements.<\/p>\n\n<h3>Features<\/h3>\n\n<ul>\n<li>Integrates FIB payment gateway with WooCommerce.<\/li>\n<li>Provides a custom page to display a QR code for payment.<\/li>\n<li>A custom button to regenerate the QR Code.<\/li>\n<li>Personal, Business, and Cooporate direct button payment for mobile devices.<\/li>\n<li>Automatically checks payment status and updates order status upon payment completion.<\/li>\n<li>Supports WooCommerce Blocks for a seamless checkout experience.<\/li>\n<\/ul>\n\n<h3>Requirements<\/h3>\n\n<ul>\n<li>WooCommerce plugin installed and activated.<\/li>\n<li>A valid FIB account and API credentials.<\/li>\n<\/ul>\n\n<h3>Set Up &amp; Installation<\/h3>\n\n<ol>\n<li><p>Download the Plugin:<\/p>\n\n<ul>\n<li>Download the plugin from the GitHub repository as a ZIP file.<\/li>\n<\/ul><\/li>\n<li><p>Install WooCommerce:<\/p>\n\n<ul>\n<li>Ensure the WooCommerce plugin is installed and activated in your WordPress admin panel.<\/li>\n<\/ul><\/li>\n<li><p>Install the Plugin:<\/p>\n\n<ul>\n<li>In your WordPress dashboard, go to Plugins &gt; Add New &gt; Upload Plugin.<\/li>\n<li>Upload the downloaded ZIP file and click 'Install Now'.<\/li>\n<li>Alternatively, you can install the plugin directly through the WordPress plugins screen.<\/li>\n<\/ul><\/li>\n<li><p>Activate the Plugin:<\/p>\n\n<ul>\n<li>After installation, activate the plugin through the 'Plugins' screen in WordPress.<\/li>\n<\/ul><\/li>\n<li><p>Enable the Payment Gateway:<\/p>\n\n<ul>\n<li>Once activated, you must enable the payment gateway in WooCommerce \u2192 Settings \u2192 Payments.<\/li>\n<li>Finish setup by checking Enable FIB payments gateway checkbox.<\/li>\n<li>You can also change the title and description of the gateway to control how it appears during checkout.<\/li>\n<\/ul><\/li>\n<li><p>Configure the Plugin:<\/p>\n\n<ul>\n<li>In the sidebar, go to FIB Payment Gateway and enter your FIB credentials:\n\n<ul>\n<li>FIB Base URL: The base URL for the FIB payment API.<\/li>\n<li>Client ID: Your FIB payment API key.<\/li>\n<li>Client Secret: Your FIB payment API secret.<\/li>\n<\/ul><\/li>\n<\/ul><\/li>\n<\/ol>\n\n<h3>Usage<\/h3>\n\n<p>After installation and activation, the FIB Payments gateway will be available as a payment method in WooCommerce. You can enable it from <code>WooCommerce &gt; Settings &gt; Payments<\/code>.<\/p>\n\n<p>Upon plugin activation the plugin will automatically creates a new custom page, This custom page dynamically generates a QR code based on the order details and allows users to scan and make payments after checking out.<\/p>\n\n<h3>Configuration<\/h3>\n\n<ul>\n<li>API Settings: Configure your FIB API settings including the Base URL, Client ID, and Client Secret.<\/li>\n<li>QR Code Settings: Customize the appearance and functionality of the QR code displayed to users.<\/li>\n<\/ul>\n\n<h3>Customization<\/h3>\n\n<p>The plugin provides several hooks and filters allowing developers to extend its functionality and integrate custom features as needed.<\/p>\n\n<h3>Troubleshooting<\/h3>\n\n<ul>\n<li><p>Common Issues:<\/p>\n\n<ul>\n<li>Ensure that your FIB credentials are correct and the API endpoint is reachable.<\/li>\n<li>Verify that the WooCommerce plugin is properly configured and active.<\/li>\n<li>Check for conflicts with other plugins that might interfere with the payment gateway.<\/li>\n<li>Make sure to put a proper wordpress permalink.<\/li>\n<\/ul><\/li>\n<li><p>Debugging:<\/p>\n\n<ul>\n<li>Enable debugging in WordPress by adding <code>define('WP_DEBUG', true);<\/code> and <code>define('WP_DEBUG_LOG', true);<\/code> to your wp-config.php file.<\/li>\n<li>Check the debug.log file in the wp-content directory for any errors or warnings.<\/li>\n<\/ul><\/li>\n<\/ul>\n\n<h3>License<\/h3>\n\n<p>This plugin is licensed under the GNU General Public License v2.0 or later.<\/p>\n\n<h3>Author<\/h3>\n\n<p>Gateway ICT Solutions<\/p>\n\n<h3>Source Code<\/h3>\n\n<p>The source code for this plugin is available at <a href=\"https:\/\/github.com\/First-Iraqi-Bank\/fib-wordpress-payment-sdk\">GitHub Repository<\/a><\/p>\n\n<h3>Support<\/h3>\n\n<p>For support, please visit the plugin's GitHub repository issues section.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id='how%20do%20i%20get%20fib%20api%20credentials%3F'><h3>How do I get FIB API credentials?<\/h3><\/dt>\n<dd><ul>\n<li>You can obtain FIB API credentials by contacting First Iraqi Bank support team at support@fib-payment.com.<\/li>\n<\/ul><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<p><strong>2.3.2<\/strong>\n* Bug Fixes, and improvments.<\/p>\n\n<p><strong>2.3.1<\/strong>\n* Bug Fixes, and improvments.<\/p>\n\n<p><strong>2.3.0<\/strong>\n* Bug Fixes, and improvments.<\/p>\n\n<p><strong>2.2.0<\/strong>\n* Added redirect uri upon payment creation.<\/p>\n\n<p><strong>2.1.0<\/strong>\n* Allow all users to regenerate QR codes.\n* Allow all users to check payment status.<\/p>\n\n<p><strong>2.0.0<\/strong>\n* Major updates, bug fixes, and improvments.<\/p>\n\n<p><strong>1.3.5<\/strong>\n* Bug Fixes, and improvments.<\/p>\n\n<p><strong>1.3.3<\/strong>\n* Bug Fixes, and improvments.<\/p>\n\n<p><strong>1.3.3<\/strong>\n* Bug Fixes, and improvments.<\/p>\n\n<p><strong>1.3.2<\/strong>\n* Bug Fixes, and improvments.<\/p>\n\n<p><strong>1.3.1<\/strong>\n* Fixes, and improvments.<\/p>\n\n<p><strong>1.3.0<\/strong>\n* Added three app link buttons so user can directly open the relevent app without the need to scan the QR code.\n* Added readable code, to enter the code manually.\n* Improved QR code generation for better user experience.<\/p>\n\n<p><strong>1.2.2<\/strong>\n* Added new payment error handling.\n* Improved nonce security for API requests.\n* Fixed potential XSS vulnerabilities.\n* Enhanced logging for API responses.\n* Updated documentation with clearer instructions.<\/p>\n\n<p><strong>1.2.1<\/strong>\n* Fixed bugs related to payment status checks.\n* Improved error handling and logging.\n* Enhanced security measures for API credentials.\n* Updated documentation for clarity and accuracy.\n* Minor performance optimizations.<\/p>\n\n<p><strong>1.2.0<\/strong>\n* Added new payment status check via AJAX.\n* Refactored JavaScript to use localized variables.\n* Updated function names and classes as per the team request.\n* SANITIZE , VALIDATE, and ESCAPE data.\n* updated the documentation.\n* Added source map.\n* Added more security concerns.\n* Fixed redirect issue.<\/p>\n\n<p><strong>1.1.0<\/strong>\n* Initial release.<\/p>","raw_excerpt":"A FIB payment gateway for your WooCommerce development needs, with built-in support for subscriptions and the block-based checkout.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/203471","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=203471"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/thegateway"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=203471"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=203471"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=203471"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=203471"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=203471"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=203471"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}