Title: WiPay Payment Gateway Author: Sergio Maziano Published: October 9, 2026 Last modified: October 9, 2026 --- Search plugins ![](https://ps.w.org/wipay-payment-gateway/assets/banner-772x250.png?rev=3736740) ![](https://ps.w.org/wipay-payment-gateway/assets/icon.svg?rev=3736740) # WiPay Payment Gateway By [Sergio Maziano](https://profiles.wordpress.org/sergiomaziano/) [Download](https://downloads.wordpress.org/plugin/wipay-payment-gateway.2.0.1.zip) * [Details](https://wordpress.org/plugins/wipay-payment-gateway/#description) * [Reviews](https://wordpress.org/plugins/wipay-payment-gateway/#reviews) * [Installation](https://wordpress.org/plugins/wipay-payment-gateway/#installation) * [Development](https://wordpress.org/plugins/wipay-payment-gateway/#developers) [Support](https://wordpress.org/support/plugin/wipay-payment-gateway/) ## Description WiPay Payment Gateway lets WooCommerce stores in Angola and the DRC accept local digital payments through a single integration. Customers pick their preferred payment method on the secure WiPay hosted payment page, and your store is notified the moment the payment completes. #### Payment methods * **Angola:** Multicaixa Express, Referências Multicaixa, é-Kwanza, PayPay, Unitel Money, Afrimoney * **DRC:** Illicocash (Rawbank) #### Features * **Simple setup** – paste your WiPay Client ID and Client Secret. The plugin creates and renews the OAuth2 access tokens automatically. * **Secure callbacks** – every payment notification is verified with an HMAC-SHA- 256 signature before the order is updated. * **Checkout your way** – the payment page opens in a modal inside the checkout, or in a popup page. * **Classic and Blocks checkout** – works with the shortcode checkout and the WooCommerce Cart & Checkout blocks. * **HPOS compatible** – supports WooCommerce High-Performance Order Storage. * **Sandbox ready** – use your sandbox credentials to test, and your production credentials to go live. No code changes. * **Order insights** – the WiPay transaction ID and status are shown on the order screen and in the orders list. * **Debug logging** – optional logs under WooCommerce > Status > Logs. #### Requirements * WooCommerce 7.0 or higher * PHP 7.4 or higher * An SSL certificate (HTTPS) * A WiPay merchant account – sign up at [wipay.ao](https://wipay.ao/) ### External services This plugin connects to the WiPay payment service, operated by WiPay (Angola), to create payments and receive their results. It is required for the plugin to work. * **Access tokens** – when you save the settings and when a payment is made, your Client ID and Client Secret are sent to `https://api.wipay.ao/v1/credentials/ token` to obtain short-lived access tokens. * **Payment creation** – when a customer places an order with WiPay, the order total, currency, order ID, the customer’s billing phone number (or email if no phone is set), and your store’s return and callback URLs are sent to `https:// api.wipay.ao/v1/hosts/payments`. * **Hosted payment page** – the customer is then shown the WiPay payment page (` https://hosted.wipay.ao`), where they choose a payment method and confirm the payment. WiPay processes the payment with the selected provider. * **Payment notification** – WiPay sends the payment result to your store’s callback URL (`/wp-json/wipay/v1/callback`). No data is sent to WiPay until the gateway is configured with credentials. WiPay [Terms of Service](https://wiza.ao/terms-and-conditions.html) and [Privacy Policy](https://wiza.ao/privacy-policy.html). ## Screenshots [⌊WiPay as a payment option on the checkout page.⌉⌊WiPay as a payment option on the checkout page.⌉[ WiPay as a payment option on the checkout page. [⌊The WiPay hosted payment page with the available payment methods.⌉⌊The WiPay hosted payment page with the available payment methods.⌉[ The WiPay hosted payment page with the available payment methods. [⌊Confirming the payment with the customer's phone number.⌉⌊Confirming the payment with the customer's phone number.⌉[ Confirming the payment with the customer’s phone number. [⌊Payment accepted.⌉⌊Payment accepted.⌉[ Payment accepted. ## Installation 1. Install the plugin from **Plugins > Add New**, or upload the `wipay-payment-gateway` folder to `/wp-content/plugins/`. 2. Activate the plugin. WooCommerce must be active. 3. Go to **WooCommerce > Settings > Payments > WiPay**. 4. Enter the **Client ID** and **Client Secret** from your [WiPay merchant portal](https://portal.wipay.ao/). 5. Enable the gateway and save. The settings page confirms that the credentials work. You don’t need to configure a callback URL in WiPay: the plugin sends it with every payment. ## FAQ ### What is WiPay? WiPay is a payment platform that lets businesses in Angola and the DRC accept local digital payments, such as Multicaixa Express and mobile money, through a single API. ### Where do I get my Client ID and Client Secret? In the [WiPay merchant portal](https://portal.wipay.ao/). The Client ID starts with` wp_` and the Client Secret with `WPS_`. ### Do I need to create or renew tokens myself? No. The plugin exchanges your Client ID and Client Secret for OAuth2 access tokens and renews them before they expire. This covers the payment token (1 hour) and the signature token used to verify callbacks (24 hours). ### How do I test payments? Enter your **sandbox** Client ID and Client Secret. In the sandbox, the customer phone number decides the outcome. 900000000 simulates an accepted payment, 900002004 a timeout and 900003000 a rejection by the customer. Switch to your production credentials to go live. ### Which currencies are supported? AOA (Angolan Kwanza), CDF (Congolese Franc) and USD. ### Does it work with the Blocks checkout? Yes. It supports both the classic (shortcode) checkout and the WooCommerce Cart & Checkout blocks. ### Is it compatible with HPOS? Yes. It is fully compatible with WooCommerce High-Performance Order Storage. ### How do refunds work? Refunds are processed in the WiPay merchant portal. When you refund an order in WooCommerce, the plugin adds a note to the order as a reminder. ### I used the “Wiza Payment Gateway” plugin. What changes? WiPay replaces Wiza. After installing WiPay Payment Gateway your title, description and display settings are copied over, but you must enter the new Client ID and Client Secret. The old API key and signature token are no longer used. Payments started with the old plugin are still confirmed. Once the new gateway is configured, deactivate and delete the old Wiza plugin. ### What does it cost? WiPay has no subscription fee and charges a small fee per transaction. See [wipay.ao](https://wipay.ao/) for pricing. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “WiPay Payment Gateway” is open source software. The following people have contributed to this plugin. Contributors * [ Sergio Maziano ](https://profiles.wordpress.org/sergiomaziano/) [Translate “WiPay Payment Gateway” into your language.](https://translate.wordpress.org/projects/wp-plugins/wipay-payment-gateway) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/wipay-payment-gateway/), check out the [SVN repository](https://plugins.svn.wordpress.org/wipay-payment-gateway/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/wipay-payment-gateway/) by [RSS](https://plugins.trac.wordpress.org/log/wipay-payment-gateway/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 2.0.1 * **NEW**: The order screen shows the payment method the customer used (e.g. Multicaixa Express, PayPay, Unitel Money). The thank-you page, My Account and order emails show it too, for example “Digital payment – Multicaixa Express”. * **FIX**: Removed development and translation draft files that were included in the 2.0.0 package. #### 2.0.0 * **NEW**: Rebranded from Wiza to WiPay. * **NEW**: OAuth2 authentication. The plugin now only needs your Client ID and Client Secret. Payment and signature access tokens are created, cached and renewed automatically. * **NEW**: Credentials are checked when the settings are saved, and the diagnostics panel shows the connection status. * **NEW**: Callback reasons are shown as readable messages in order notes. * **NEW**: WiPay status column on the HPOS orders screen. * **NEW**: Settings, history and pending callbacks are migrated from the Wiza plugin. * **FIX**: Paying again for the same order no longer fails with “reference already exists”. Each attempt now gets its own WiPay reference (123, 123-1, 123-2…), and the plugin automatically retries with the next reference if WiPay reports a duplicate. * **IMPROVED**: Rejected or duplicate callbacks no longer change orders that are already paid. * **IMPROVED**: Payments accepted with an amount that differs from the order total are put on hold for review. * **IMPROVED**: A clear message is shown when WiPay rate-limits payment requests. * **IMPROVED**: The plugin is now in English and fully translatable through translate. wordpress.org. * **REMOVED**: The “Test mode” option. Sandbox and production are selected by the credentials you use. * **REMOVED**: The unused “Reference prefix” option. #### 1.1.0 * **NEW**: Compatibility with WordPress 6.9 and WooCommerce 10.4. * **NEW**: HPOS (High-Performance Order Storage) support. * **NEW**: WooCommerce Blocks checkout support. * **NEW**: REST API callback endpoint. * **NEW**: Debug logging. * **IMPROVED**: Signature verification and error handling. #### 1.0 * Initial release. ## Meta * Version **2.0.1** * Last updated **3 days ago** * Active installations **Fewer than 10** * WordPress version ** 6.2 or higher ** * Tested up to **7.1.3** * PHP version ** 7.4 or higher ** * Tags * [angola](https://wordpress.org/plugins/tags/angola/)[mobile money](https://wordpress.org/plugins/tags/mobile-money/) [multicaixa](https://wordpress.org/plugins/tags/multicaixa/)[payment gateway](https://wordpress.org/plugins/tags/payment-gateway/) [woocommerce](https://wordpress.org/plugins/tags/woocommerce/) * [Advanced View](https://wordpress.org/plugins/wipay-payment-gateway/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/wipay-payment-gateway/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/wipay-payment-gateway/reviews/) ## Contributors * [ Sergio Maziano ](https://profiles.wordpress.org/sergiomaziano/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/wipay-payment-gateway/)