內容簡介
**總結:**
這個 WordPress 外掛將 FIB 付款網關新增至 WooCommerce，讓用戶可以使用第一伊拉克銀行的支付系統進行付款。
**問題與答案:**
1. 這個外掛的功能有哪些？
- 整合 FIB 付款網關與 WooCommerce。
- 提供一個自訂頁面來展示付款的 QR 碼。
- 提供一個自訂按鈕來重新生成 QR 碼。
- 自動檢查付款狀態並在付款完成後更新訂單狀態。
- 支援 WooCommerce Blocks，提供無縫結賬體驗。
2. 安裝這個外掛有哪些要求？
- WordPress 版本需為 4.2 或更高。
- 需安裝並啟用 WooCommerce 外掛。
- 伺服器需要啟用 PHP 會話支援。
- 需要有效的 FIB 帳戶和 API 憑證。
3. 如何設置和安裝這個外掛？
- 從 GitHub 存儲庫下載外掛的 ZIP 檔案。
- 確保 WooCommerce 外掛已在 WordPress 管理面板中安裝和啟用。
- 在 WordPress 儀表板中，前往「外掛」>「新增外掛」>「上傳外掛」，上傳 ZIP 檔案並點擊「立即安裝」。
- 安裝後，在 WordPress 的「外掛」畫面啟用這個外掛。
- 在側邊欄中，使用 FIB 付款網關進入外掛設定，輸入你的 FIB 憑證。
4. 如何使用這個外掛？
- 安裝和啟用後，在 WooCommerce 中可選擇將 FIB 付款網關作為一種支付方式。
- 使用 [custom_payment_qr_code] 這個短碼可在文章或頁面中顯示付款的 QR 碼，讓用戶掃描支付。
5. 這個外掛提供哪些自定義功能？
- 可在 API 設置中配置 FIB API（包括 Base URL、Client ID 和 Client Secret）。
- 可在 QR 碼設置中自訂 QR 碼的外觀和功能。
6. 如何進行除錯和疑難排解？
- 請確保 FIB 憑證正確並且 API 端點可到達。
- 驗證 WooCommerce 外掛已正確配置並啟用。
- 檢查是否有其他外掛與支付網關發生衝突。
以上內容提供了關於 FIB 付款網關 WooCommerce 外掛的重要資訊和操作指引。
外掛標籤
開發者團隊
原文外掛簡介
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
Download the Plugin:
Download the plugin from the GitHub repository as a ZIP file.
Install WooCommerce:
Ensure the WooCommerce plugin is installed and activated in your WordPress admin panel.
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.
Activate the Plugin:
After installation, activate the plugin through the ‘Plugins’ screen in WordPress.
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.
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.