Description
“Pagamento por Referência” (payment by reference) on Multicaixa (Angolan ATM network), or Home Banking services, is one of the most popular and secure ways to pay for services and (online) purchases in Angola.
This plugin will allow you to generate a payment Reference the customer can then use to pay for his WooCommerce order in Kwanzas, through an ATM or Home Banking service.
This plugin works with the ProxyPay gateway, and a contract with an Angolan bank and TimeBoxed (the company behind ProxyPay) is required. Technical support is provided by Webdados.
Features:
- Generates a Multicaixa Reference for simple payment on the Angolan ATM network or Home Banking service;
- 24 hours reference validity;
- Compatible with High-Performance Order Storage for WooCommerce
- Compatible with WooCommerce Blocks checkout
- WPML tested and compatible (for multilingual shops);
- Polylang tested;
PRO add-on features:
- Automatically changes the order status to “Processing” (or “Completed” if the order only contains virtual downloadable products) and notifies both the customer and the store owner, if the Webhook upon payment is activated;
- Automatic Webhook call can be activated upon request to ProxyPay, via the plugin settings screen;
- Configuration of reference validity in hours, days, weeks or months;
- Shop owner can set minimum and maximum order totals for this payment gateway to be available;
- Payment method can be deactivated if the client doesn’t have an Angolan address;
- Ability to reduce stock when the order is created or paid;
- Automatically update the payment reference, and notify the client, if the order total is changed on a backend order modification;
- Allows searching orders (in the admin area) by Multicaixa Reference;
- Automatic cancellation of orders with expired references;
- Integration with ProxyPay’s own SMS system;
- ProxyPay Sandbox support;
- Other planned PRO features:
- Integration for 3rd party SMS notification plugins:
- WooCommerce – APG SMS Notifications;
- Twilio SMS Notifications;
- YITH WooCommerce SMS Notification;
- Other providers can be added upon request (under quotation);
- WooCommerce Subscriptions integration;
- WooCommerce Deposits integration;
- Integration for 3rd party SMS notification plugins:
Know more or get the plugin PRO add-on now.
Other (premium) plugins
Already know our other WooCommerce (premium) plugins?
- Advanced Coupon Restrictions for WooCommerce – Create coupons for any Product Taxonomy, User details, and Order destination.
- Simple Custom Fields for WooCommerce Blocks Checkout – Add custom fields to the new WooCommerce Block-based Checkout
- Simple WooCommerce Order Approval – The hassle-free solution for WooCommerce order approval before payment
- Shop as Client for WooCommerce – Quickly create orders on behalf of your customers
- Taxonomy/Term and Role based Discounts for WooCommerce – Easily create bulk discount rules for products based on any taxonomy terms (built-in or custom)
Installation
- Use the included automatic install feature on your WordPress admin panel and search for “Multicaixa WooCommerce”.
- Go to WooCoomerce > Settings > Payments > Pagamento por Referência no Multicaixa and fill in the details provided by ProxyPay and your bank in order to use this payment method. A contract with TimeBoxed (the company behind ProxyPay) and a bank is mandatory.
- Start receiving payments 🙂
FAQ
-
Can I start receiving payments right away? Show me the money!
-
Nop! You have to sign a contract with ProxyPay and an Angolan bank in order to activate this service. Go to https://proxypay.co.ao/ for more information. They can help you out with all the subscription process with them and the bank.
-
[WPML] My website is multilingual. Will I be able to use this plugin?
-
Yes. This plugin is WPML compatible. You will need the WPML and WPML String Translation Plugins (alongside WooCommerce Multilingual, which is mandatory for any WooCommerce + WPML install).
-
[WPML] How can I translate the payment method title and description the client sees in the checkout page to secondary languages?
-
Go to WPML > String Translation > Search and translate the
multicaixa_proxypay_gateway_title
andmulticaixa_proxypay_gateway_description
, strings in thewoocommerce
domain. Don’t forget to check the “Translation is complete” checkbox and click “Save”. You should also translate the “Extra instructions” strings by searching themulticaixa_proxypay_extra_instructions
string on thewoo_multicaixa
. -
[SMS] How to include the Multicaixa payment instructions in the SMS sent by “WooCommerce – APG SMS Notifications”, “Twilio SMS Notifications” or “YITH WooCommerce SMS Notification”?
-
You’ll need the plugin PRO add-on.
-
[SMS] How to trigger the ProxyPay SMS system?
-
You’ll need the plugin PRO add-on.
-
[Advanced] The order is set “On Hold”, can I make it “Pending” by default?
-
I don’t know why on earth you would want to do this, but… yes, you can. Just return
false
to themulticaixa_proxypay_set_on_hold
filter.
Be advised that no “new order” email, with payment instructions, will be sent to the client unless you use some plugin or custom code to force it. -
[Advanced] Can I prevent the plugin from adding the payment instructions and/or the payment received message to emails?
-
You can use the
multicaixa_proxypay_email_instructions_pending_send
filter: return false and the payment instructions won’t be included in the “new order” email – we do not recommend you to do it, though.
You can use themulticaixa_proxypay_email_instructions_payment_received_send
filter: return false and the payment received message won’t be included in the “processing” email. -
[Advanced] How can I use the plugin with the ProxyPay sandbox, for tests?
-
You should return true to the
multicaixa_proxypay_test_mode
filter, or use the plugin PRO add-on to activate the test mode with a simple checkbox. -
Can I contribute with a translation?
-
Sure. Go to GlotPress and help us out.
-
I need technical support. Who should I contact, ProxyPay or PT Woo Plugins (by Webdados)?
-
Development and (premium) support is provided by PT Woo Plugins (by Webdados).
We do not provide free support for this free plugin, but you can submit bug reports here at WordPress.org
You’ll get included support if you buy the plugin PRO add-on.
For premium support or custom developments, you should contact Webdados. Charges may (and most certainly will) apply. -
Where do I report security vulnerabilities found in this plugin?
-
You can report any security bugs found in the source code of this plugin through the Patchstack Vulnerability Disclosure Program. The Patchstack team will assist you with verification, CVE assignment and take care of notifying the developers of this plugin.
Avis
Contributeurs/contributrices & développeurs/développeuses
« Payment Multicaixa (ProxyPay gateway) for WooCommerce » est un logiciel libre. Les personnes suivantes ont contribué à cette extension.
Contributeurs“Payment Multicaixa (ProxyPay gateway) for WooCommerce” a été traduit dans 2 locales. Remerciez l’équipe de traduction pour ses contributions.
Traduisez « Payment Multicaixa (ProxyPay gateway) for WooCommerce » dans votre langue.
Le développement vous intéresse ?
Parcourir le code, consulter le SVN dépôt, ou s’inscrire au journal de développement par RSS.
Journal
3.0 – 2024-11-13
- [FIX] Load text domain at the right time to avoid PHP notices on WordPress 6.7 and above
- [FIX] Deprecated: Creation of dynamic property in PHP 8.3
- [DEV] Updater improvements (PRO add-on)
- [DEV] Requires WooCommerce 7.0
- [DEV] Tested with WordPress 6.7 and WooCommerce 9.4.1
2.2 – 2023-12-12
- Declare WooCommerce block-based Cart and Checkout compatibility
- Requires WordPress 5.4
- Tested with WordPress 6.5-alpha-57159 and WooCommerce 8.4.0-rc.1
2.1 – 2023-08-28
- Fix internals needed to search orders with expired references
- Tested with WordPress 6.4-alpha-56479 and WooCommerce 8.0.2
2.0 – 2023-07-24
- High-Performance Order Storage for WooCommerce compatibility (in beta)
- WooCommerce Blocks checkout compatibility (in beta)
- Fix license key change on the PRO add-on
- Some code refactoring
- Tested with WordPress 6.3-beta4-56226 and WooCommerce 8.0.0-beta.1
1.3.0 – 2022-06-29
- New brand: PT Woo Plugins 🥳
- Requires WordPress 5.0, WooCommerce 3.0 and PHP 7.0
- Tested with WordPress 6.1-alpha-53556 and WooCommerce 6.7.0-beta.2
1.2.1 – 2021-03-12
- Tested with WordPress 5.8-alpha-50516 and WooCommerce 5.1.0
1.2.0
- New
multicaixa_create_ref_min
andmulticaixa_create_ref_max
filters to allow narrowing the references interval and make sure different platforms using the same entity do not create duplicate references - Tested with WordPress 5.7-alpha-49798 and WooCommerce 4.8
1.1.0
- Tested with WordPress 5.6-beta3-49562 and WooCommerce 4.7.1-beta.1
1.0.9
- Better debugging
- Tested with WordPress 5.5-alpha-47574 and WooCommerce 4.1.0-beta.2
1.0.8
- Small visual tweaks on the settings page
- Allow PRO add-on to add extra content to the settings page
- Fix SVG banner on the payment instructions
- Tested with WordPress 5.3.1-alpha-46798 and WooCommerce 3.9.0-beta.1
1.0.7
- Tested with WordPress 5.2.4-alpha-46074 and WooCommerce 3.8.0-beta.1
1.0.6
- Tested with WordPress 5.2.3-alpha-45552 and WooCommerce 3.7.0-beta.1
- WordPress 4.9 minimum requirement
- PHP 5.6 minimum requirement
1.0.5
- readme.txt tweaks
- Tested with WordPress 5.2.3-alpha and WooCommerce 3.6.5
1.0.4
- Fix minimum and maximum payment values
- Tested with WordPress 5.1.1 and WooCommerce 3.6.0 (RC 2)
1.0.3.1
- Fix version number
1.0.3
- Fix SVG icon
- Tested with WordPress 5.1 and WooCommerce 3.5.6
1.0.2
- Tested with WordPress 5.0.2 and WooCommerce 3.5.2
1.0.1
- readme.txt improvements
- Small fixes
1.0
- Initial release.