A FIB payment gateway for your WooCommerce development needs, with built-in support for subscriptions and the block-based checkout.

The Gateway

First Iraqi Bank

<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>
<h3>Permalink Configuration</h3>
<p>The WordPress permalink should be set as Post name: for example:- http://localhost/wordpress/sample-post/</p>
<p>You can change this setting in your WordPress Admin Panel <span aria-hidden="true" class="wp-exclude-emoji">→</span> Settings <span aria-hidden="true" class="wp-exclude-emoji">→</span> Permalinks.</p>
<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>
<h3>Third-Party Services</h3>
<p>This plugin relies on the First Iraqi Bank’s payment service for processing transactions. The following external endpoints are used:</p>
<ul>
<li><strong>Create Payment</strong>: <code>https://fib.stage.fib.iq/protected/v1/payments</code></li>
<li><strong>Cancel Payment</strong>: <code>https://fib.stage.fib.iq/protected/v1/payments/4d6f7625-60f7-48e3-82e3-b4592a4eb993/cancel</code></li>
<li><strong>Check Payment Status</strong>: <code>https://fib.stage.fib.iq/protected/v1/payments/{paymentid}/status</code></li>
</ul>
<h3>Third-Party Service Information</h3>
<ul>
<li><strong>Service Provider</strong>: <a href="https://fib.iq/" rel="nofollow ugc">First Iraqi Bank</a> </li>
<li><strong>Service Terms of Use</strong>: <a href="https://fib.iq/integrations/web-payments/" rel="nofollow ugc">Terms of Use</a></li>
<li><strong>Service Privacy Policy</strong>: <a href="https://fib.iq/privacy-and-security/" rel="nofollow ugc">Privacy Policy</a></li>
</ul>
<p>The plugin sends payment data to the First Iraqi Bank’s API endpoints for the purposes of creating payments, checking payment statuses, and canceling payments.</p>
<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>
<h3>Features</h3>
<ul>
<li>Integrates FIB payment gateway with WooCommerce.</li>
<li>Provides a custom page to display a QR code for payment.</li>
<li>A custom button to regenerate the QR Code.</li>
<li>Personal, Business, and Cooporate direct button payment for mobile devices.</li>
<li>Automatically checks payment status and updates order status upon payment completion.</li>
<li>Supports WooCommerce Blocks for a seamless checkout experience.</li>
</ul>
<h3>Requirements</h3>
<ul>
<li>WooCommerce plugin installed and activated.</li>
<li>A valid FIB account and API credentials.</li>
</ul>
<h3>Set Up & Installation</h3>
<ol>
<li>
<p>Download the Plugin:</p>
<ul>
<li>Download the plugin from the GitHub repository as a ZIP file.</li>
</ul>
</li>
<li>
<p>Install WooCommerce:</p>
<ul>
<li>Ensure the WooCommerce plugin is installed and activated in your WordPress admin panel.</li>
</ul>
</li>
<li>
<p>Install the Plugin:</p>
<ul>
<li>In your WordPress dashboard, go to Plugins > Add New > Upload Plugin.</li>
<li>Upload the downloaded ZIP file and click ‘Install Now’.</li>
<li>Alternatively, you can install the plugin directly through the WordPress plugins screen.</li>
</ul>
</li>
<li>
<p>Activate the Plugin:</p>
<ul>
<li>After installation, activate the plugin through the ‘Plugins’ screen in WordPress.</li>
</ul>
</li>
<li>
<p>Enable the Payment Gateway:</p>
<ul>
<li>Once activated, you must enable the payment gateway in WooCommerce <span aria-hidden="true" class="wp-exclude-emoji">→</span> Settings <span aria-hidden="true" class="wp-exclude-emoji">→</span> Payments.</li>
<li>Finish setup by checking Enable FIB payments gateway checkbox.</li>
<li>You can also change the title and description of the gateway to control how it appears during checkout.</li>
</ul>
</li>
<li>
<p>Configure the Plugin:</p>
<ul>
<li>In the sidebar, go to FIB Payment Gateway and enter your FIB credentials:
<ul>
<li>FIB Base URL: The base URL for the FIB payment API.</li>
<li>Client ID: Your FIB payment API key.</li>
<li>Client Secret: Your FIB payment API secret.</li>
</ul>
</li>
</ul>
</li>
</ol>
<h3>Usage</h3>
<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>
<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>
<h3>Configuration</h3>
<ul>
<li>API Settings: Configure your FIB API settings including the Base URL, Client ID, and Client Secret.</li>
<li>QR Code Settings: Customize the appearance and functionality of the QR code displayed to users.</li>
</ul>
<h3>Customization</h3>
<p>The plugin provides several hooks and filters allowing developers to extend its functionality and integrate custom features as needed.</p>
<h3>Troubleshooting</h3>
<ul>
<li>
<p>Common Issues:</p>
<ul>
<li>Ensure that your FIB credentials are correct and the API endpoint is reachable.</li>
<li>Verify that the WooCommerce plugin is properly configured and active.</li>
<li>Check for conflicts with other plugins that might interfere with the payment gateway.</li>
<li>Make sure to put a proper wordpress permalink.</li>
</ul>
</li>
<li>
<p>Debugging:</p>
<ul>
<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>
<li>Check the debug.log file in the wp-content directory for any errors or warnings.</li>
</ul>
</li>
</ul>
<h3>License</h3>
<p>This plugin is licensed under the GNU General Public License v2.0 or later.</p>
<h3>Author</h3>
<p>Gateway ICT Solutions</p>
<h3>Source Code</h3>
<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>
<h3>Support</h3>
<p>For support, please visit the plugin’s GitHub repository issues section.</p>


Alternatives to FIB Payments Gateway

Top alternatives