krownpay

<p>KrownPay offers a secure payment gateway solution for seamless transactions on your WooCommerce store.</p>
<h3>Download the Plugin</h3>
<p>Obtain the KrownPay WooCommerce Plugin from the official source or marketplace where it is available.</p>
<h3>Upload the Plugin to WordPress</h3>
<ol>
<li>Navigate to the WordPress admin dashboard.</li>
<li>Go to <code>Plugins > Add New</code>.</li>
<li>Click on the <code>Upload Plugin</code> button.</li>
<li>Choose the downloaded KrownPay WooCommerce Plugin ZIP file and click <code>Install Now</code>.</li>
</ol>
<h3>Install the Plugin</h3>
<p>Once uploaded, click <code>Activate Plugin</code> to activate the KrownPay WooCommerce Plugin.</p>
<h3>Activation</h3>
<h3>Activate the Plugin</h3>
<ol>
<li>After installing, navigate to <code>Plugins > Installed Plugins</code>.</li>
<li>Locate the KrownPay WooCommerce Plugin and click <code>Activate</code>.</li>
</ol>
<h3>Configuration</h3>
<h3>Adding WooCommerce Credentials</h3>
<ol>
<li>Access WooCommerce Settings: Navigate to <code>WooCommerce > Settings</code> in the WordPress admin dashboard.</li>
<li>Generate your WooCommerce consumer key and secret key.</li>
<li>Locate the KrownPay Section: In the WooCommerce settings, find the <code>Payments</code> tab.</li>
<li>Click on <code>KrownPay</code> to access the settings for the KrownPay Gateway for WooCommerce Plugin.</li>
<li>Enter WooCommerce Credentials: Enter your WooCommerce store credentials, including API keys and any required authentication details.</li>
<li>Save the changes.</li>
</ol>
<h3>Creating a Store on KrownPay</h3>
<ol>
<li>Visit <a href="https://stg.app.krownpay.com/" rel="nofollow ugc">KrownPay</a>: Go to the link and sign up for an account.</li>
<li>Create a New Store: After logging in, navigate to the <code>Stores</code> section.</li>
<li>Click on <code>Create Store</code> and fill in the required information about your store (e.g., name, URL).</li>
<li>Take note of the Merchant ID, Secret Key and Gateway URL. as they are all be auto generated.</li>
</ol>
<h3>Adding KrownPay Cridentials on plugin</h3>
<ol>
<li>Access KrownPay Plugin Settings: In the WordPress admin dashboard, go to <code>WooCommerce > Settings > Payments</code>.</li>
<li>Click on <code>KrownPay</code> to open the settings.</li>
<li>Enter the Merchant ID, Secrete key and Gateway URL gotten from the krownpay dashboard</li>
<li>Save the changes.</li>
</ol>
<h3>Using KrownPay for Checkout</h3>
<ol>
<li>Enable KrownPay Payment Method: Ensure that the KrownPay payment method is enabled in the WooCommerce payment settings.</li>
<li>Add Items to Cart: Customers can browse your WooCommerce store and add items to their cart as usual.</li>
<li>Proceed to Checkout: When ready, customers can proceed to checkout. On the checkout page, they will see the option to pay with KrownPay.</li>
<li>Select KrownPay: Customers select KrownPay as their payment method and click <code>Place Order</code>.</li>
</ol>
<h3>Payment Flow</h3>
<ol>
<li>Generate Payment Link: Upon selecting KrownPay and placing the order, a payment link is generated.</li>
<li>Redirect to Payment Page: The customer is redirected to the KrownPay payment page via the generated link.</li>
<li>Complete Payment: The customer completes the payment using their chosen cryptocurrency on the KrownPay payment page.</li>
<li>Redirect to Success Page: After successful payment, the customer is redirected back to the WooCommerce site’s success page.</li>
</ol>
<h3>Troubleshooting</h3>
<ul>
<li><strong>Payment Issues</strong>: If customers encounter issues during payment, ensure the Gateway URL is correctly configured and your KrownPay store settings are accurate.</li>
<li><strong>Plugin Conflicts</strong>: Deactivate other plugins to check for conflicts that may interfere with KrownPay functionality.</li>
<li><strong>Logs</strong>: Enable logging in the KrownPay settings for detailed troubleshooting information.</li>
</ul>
<h3>FAQs</h3>
<ul>
<li>
<p><strong>What cryptocurrencies does KrownPay support?</strong><br />
KrownPay supports a wide range of cryptocurrencies. Please refer to the KrownPay website for the most up-to-date list of supported currencies.</p>
</li>
<li>
<p><strong>How do I update the plugin?</strong><br />
Update the plugin via the WordPress admin dashboard under <code>Plugins > Installed Plugins</code>. Click on <code>Update Now</code> if a new version is available.</p>
</li>
<li>
<p><strong>Can I issue refunds via KrownPay?</strong><br />
Refunds must be processed manually through KrownPay and WooCommerce. Refer to both platforms’ documentation for detailed instructions on issuing refunds.</p>
</li>
</ul>
<h3>Support</h3>
<p>For additional support, contact KrownPay support through their support portal or refer to the documentation provided on their website. For WooCommerce-related issues, consult the WooCommerce support forums or documentation.</p>
<h3>License</h3>
<p>This plugin is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.</p>
<p>This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.</p>
<p>You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.</p>
<h3>Technical Flow</h3>
<p>The KrownPay Gateway for WooCommerce plugin integrates securely with KrownPay’s payment platform, enabling merchants to generate custom payment links for each order placed in their store. During configuration, each merchant is provided with a unique gateway URL, which plays a key role in establishing a secure connection between their store and the KrownPay payment gateway.</p>
<p>In the krownpay.php file, the merchant’s gateway URL ($gateway) is carefully sanitized using sanitize_text_field() to prevent injection attacks and ensure data integrity. This sanitized URL is then used to build the endpoint (/gtw/v1/woocommerce/orders), where the plugin initiates a secure POST request via wp_remote_post(). The request, which includes properly structured headers and a validated request body, communicates with the KrownPay API to create an order and generate a unique payment link for the customer.</p>
<p>All data exchanged between the store and KrownPay is transmitted over HTTPS, ensuring that sensitive information, including order details, is encrypted during transit. This encrypted communication prevents unauthorized interception and guarantees that the transaction data remains confidential.</p>
<p>Once the payment link is generated, the customer is redirected to a custom checkout page where they can complete their transaction using any of their connected wallets. Upon successful payment, the customer is automatically redirected back to the  store, and the order status is updated in real-time within the merchant’s backend, ensuring accurate tracking of all transactions.</p>
<p>KrownPay prioritizes security and privacy. We do not store or have access to any private keys—neither from the customer nor the merchant. At no point during the integration process will we request these keys, maintaining the highest standard of data protection throughout the transaction lifecycle.</p>
<h3>Privacy Policy</h3>
<p>https://www.krownpay.com/privacy</p>
<h3>Terms and Conditions</h3>
<p>https://stg.app.krownpay.com/terms</p>


KrownPay Gateway for WooCommerce

KrownPay offers a secure payment gateway solution for seamless transactions on your WooCommerce store.

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>


FIB Payments Gateway

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

KrownPay Gateway for WooCommerce vs FIB Payments Gateway