FIB Payments Gateway

This WordPress plugin adds the FIB Payments gateway to WooCommerce, allowing users to make payments using the First Iraqi Bank’s payment system.

Permalink Configuration

The WordPress permalink should be set as Post name: for example:- http://localhost/wordpress/sample-post/

You can change this setting in your WordPress Admin Panel → Settings → Permalinks.

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.

Third-Party Services

This plugin relies on the First Iraqi Bank’s payment service for processing transactions. The following external endpoints are used:

• Create Payment: https://fib.stage.fib.iq/protected/v1/payments
• Cancel Payment: https://fib.stage.fib.iq/protected/v1/payments/4d6f7625-60f7-48e3-82e3-b4592a4eb993/cancel
• Check Payment Status: https://fib.stage.fib.iq/protected/v1/payments/{paymentid}/status

Third-Party Service Information

• Service Provider: First Iraqi Bank
• Service Terms of Use: Terms of Use
• Service Privacy Policy: Privacy Policy

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.

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.

Features

• Integrates FIB payment gateway with WooCommerce.
• Provides a custom page to display a QR code for payment.
• A custom button to regenerate the QR Code.
• Personal, Business, and Cooporate direct button payment for mobile devices.
• Automatically checks payment status and updates order status upon payment completion.
• Supports WooCommerce Blocks for a seamless checkout experience.

Requirements

• WooCommerce plugin installed and activated.
• A valid FIB account and API credentials.

Set Up & Installation

1. Download the Plugin:

   • Download the plugin from the GitHub repository as a ZIP file.

2. Install WooCommerce:

   • Ensure the WooCommerce plugin is installed and activated in your WordPress admin panel.

3. Install the Plugin:

   • In your WordPress dashboard, go to Plugins > Add New > Upload Plugin.
   • Upload the downloaded ZIP file and click ‘Install Now’.
   • Alternatively, you can install the plugin directly through the WordPress plugins screen.

4. Activate the Plugin:

   • After installation, activate the plugin through the ‘Plugins’ screen in WordPress.

5. Enable the Payment Gateway:

   • Once activated, you must enable the payment gateway in WooCommerce → Settings → Payments.
   • Finish setup by checking Enable FIB payments gateway checkbox.
   • You can also change the title and description of the gateway to control how it appears during checkout.

6. Configure the Plugin:

   • In the sidebar, go to FIB Payment Gateway and enter your FIB credentials:
     • FIB Base URL: The base URL for the FIB payment API.
     • Client ID: Your FIB payment API key.
     • Client Secret: Your FIB payment API secret.

Usage

After installation and activation, the FIB Payments gateway will be available as a payment method in WooCommerce. You can enable it from WooCommerce > Settings > Payments.

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.

Configuration

• API Settings: Configure your FIB API settings including the Base URL, Client ID, and Client Secret.
• QR Code Settings: Customize the appearance and functionality of the QR code displayed to users.

Customization

The plugin provides several hooks and filters allowing developers to extend its functionality and integrate custom features as needed.

Troubleshooting

• Common Issues:

  • Ensure that your FIB credentials are correct and the API endpoint is reachable.
  • Verify that the WooCommerce plugin is properly configured and active.
  • Check for conflicts with other plugins that might interfere with the payment gateway.
  • Make sure to put a proper wordpress permalink.

• Debugging:

  • Enable debugging in WordPress by adding define('WP_DEBUG', true); and define('WP_DEBUG_LOG', true); to your wp-config.php file.
  • Check the debug.log file in the wp-content directory for any errors or warnings.

License

This plugin is licensed under the GNU General Public License v2.0 or later.

Author

Gateway ICT Solutions

Source Code

The source code for this plugin is available at GitHub Repository

Support

For support, please visit the plugin’s GitHub repository issues section.