{"id":408764,"date":"2024-09-25T08:00:00","date_gmt":"2024-09-25T08:00:00","guid":{"rendered":"https:\/\/www.weixiaoduo.com\/plugins\/fib-payments-gateway\/"},"modified":"2025-03-18T17:02:00","modified_gmt":"2025-03-18T17:02:00","slug":"fib-payments-gateway","status":"publish","type":"post","link":"https:\/\/www.weixiaoduo.com\/plugins\/fib-payments-gateway\/","title":{"rendered":"FIB Payments Gateway"},"content":{"rendered":"<p>This WordPress plugin adds the FIB Payments gateway to WooCommerce, allowing users to make payments using the First Iraqi Bank\u2019s payment system.<\/p>\n<h3>Permalink Configuration<\/h3>\n<p>The WordPress permalink should be set as Post name: for example:- http:\/\/localhost\/wordpress\/sample-post\/<\/p>\n<p>You can change this setting in your WordPress Admin Panel <span aria-hidden=\"true\" class=\"wp-exclude-emoji\">\u2192<\/span> Settings <span aria-hidden=\"true\" class=\"wp-exclude-emoji\">\u2192<\/span> Permalinks.<\/p>\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<h3>Third-Party Services<\/h3>\n<p>This plugin relies on the First Iraqi Bank\u2019s payment service for processing transactions. The following external endpoints are used:<\/p>\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<h3>Third-Party Service Information<\/h3>\n<ul>\n<li><strong>Service Provider<\/strong>: <a href=\"https:\/\/fib.iq\/\" rel=\"nofollow ugc\">First Iraqi Bank<\/a> <\/li>\n<li><strong>Service Terms of Use<\/strong>: <a href=\"https:\/\/fib.iq\/integrations\/web-payments\/\" rel=\"nofollow ugc\">Terms of Use<\/a><\/li>\n<li><strong>Service Privacy Policy<\/strong>: <a href=\"https:\/\/fib.iq\/privacy-and-security\/\" rel=\"nofollow ugc\">Privacy Policy<\/a><\/li>\n<\/ul>\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<p>Please review the service provider\u2019s terms and privacy policy to understand how your data is handled and ensure you are compliant with their requirements.<\/p>\n<h3>Features<\/h3>\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<h3>Requirements<\/h3>\n<ul>\n<li>WooCommerce plugin installed and activated.<\/li>\n<li>A valid FIB account and API credentials.<\/li>\n<\/ul>\n<h3>Set Up & Installation<\/h3>\n<ol>\n<li>\n<p>Download the Plugin:<\/p>\n<ul>\n<li>Download the plugin from the GitHub repository as a ZIP file.<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Install WooCommerce:<\/p>\n<ul>\n<li>Ensure the WooCommerce plugin is installed and activated in your WordPress admin panel.<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Install the Plugin:<\/p>\n<ul>\n<li>In your WordPress dashboard, go to Plugins > Add New > Upload Plugin.<\/li>\n<li>Upload the downloaded ZIP file and click \u2018Install Now\u2019.<\/li>\n<li>Alternatively, you can install the plugin directly through the WordPress plugins screen.<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Activate the Plugin:<\/p>\n<ul>\n<li>After installation, activate the plugin through the \u2018Plugins\u2019 screen in WordPress.<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Enable the Payment Gateway:<\/p>\n<ul>\n<li>Once activated, you must enable the payment gateway in WooCommerce <span aria-hidden=\"true\" class=\"wp-exclude-emoji\">\u2192<\/span> Settings <span aria-hidden=\"true\" class=\"wp-exclude-emoji\">\u2192<\/span> 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>\n<\/li>\n<li>\n<p>Configure the Plugin:<\/p>\n<ul>\n<li>In the sidebar, go to FIB Payment Gateway and enter your FIB credentials:\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>\n<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<h3>Usage<\/h3>\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 > Settings > Payments<\/code>.<\/p>\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<h3>Configuration<\/h3>\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<h3>Customization<\/h3>\n<p>The plugin provides several hooks and filters allowing developers to extend its functionality and integrate custom features as needed.<\/p>\n<h3>Troubleshooting<\/h3>\n<ul>\n<li>\n<p>Common Issues:<\/p>\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>\n<\/li>\n<li>\n<p>Debugging:<\/p>\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>\n<\/li>\n<\/ul>\n<h3>License<\/h3>\n<p>This plugin is licensed under the GNU General Public License v2.0 or later.<\/p>\n<h3>Author<\/h3>\n<p>Gateway ICT Solutions<\/p>\n<h3>Source Code<\/h3>\n<p>The source code for this plugin is available at <a href=\"https:\/\/github.com\/First-Iraqi-Bank\/fib-wordpress-payment-sdk\" rel=\"nofollow ugc\">GitHub Repository<\/a><\/p>\n<h3>Support<\/h3>\n<p>For support, please visit the plugin\u2019s GitHub repository issues section.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>A FIB payment gateway for your WooCommerce development needs, with built-in support for subscriptions and the block-based checkout.<\/p>\n","protected":false},"author":65,"featured_media":408801,"comment_status":"open","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"slim_seo":{"title":"FIB Payments Gateway - \u8587\u6653\u6735\u63d2\u4ef6\u76ee\u5f55","description":"A FIB payment gateway for your WooCommerce development needs, with built-in support for subscriptions and the block-based checkout."},"footnotes":""},"categories":[1],"tags":[57388,171,1054,42],"class_list":["post-408764","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-uncategorized","tag-fib","tag-gateway","tag-payments","tag-woocommerce"],"_links":{"self":[{"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/posts\/408764","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/users\/65"}],"replies":[{"embeddable":true,"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/comments?post=408764"}],"version-history":[{"count":0,"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/posts\/408764\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/media\/408801"}],"wp:attachment":[{"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/media?parent=408764"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/categories?post=408764"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.weixiaoduo.com\/plugins\/wp-json\/wp\/v2\/tags?post=408764"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}