Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/edutecka/edpay-woocommerce-plugin/archive/refs/heads/main.zipEDPay for WooCommerce
The official EDPay WooCommerce integration is an early preview/beta. It has not been established as production-ready. Install it on a test store, use Sandbox first, and validate the complete payment and webhook flow before considering a live deployment.
The current implementation creates a payment request from the store server, redirects the customer to a payment URL returned by EDPay, and updates the WooCommerce order after validating a webhook. It is a gateway-agnostic integration; payment routing and supported methods depend on EDPay and the merchant account.
Requirements
- WordPress 6.0 or later
- WooCommerce 8.0 or later
- PHP 8.1 or later with the
curl,json, andhashextensions - An EDPay merchant account with Sandbox credentials and a webhook secret
The plugin declares WooCommerce compatibility through version 9.2 and declares HPOS compatibility in its code. These declarations are not a substitute for testing against your store's exact WordPress and WooCommerce versions.
Install the preview
From the WordPress installation directory, clone the repository into the plugins directory:
git clone https://github.com/edutecka/edpay-woocommerce-plugin.git wp-content/plugins/edpay-woocommerce-plugin
Then open WordPress Admin → Plugins and activate EDPay Multi-Gateway Checkout. This repository currently provides a source checkout; do not assume that a packaged or signed release is available.
Configure Sandbox
- In WordPress Admin, open WooCommerce → Settings → Payments → EDPay Multi-Gateway Checkout.
- Enable the payment method and select Sandbox.
- Enter the Sandbox public key (
pk_test_...), private key (sk_test_...), and webhook secret (whsec_...). Keep the private key and webhook secret on the server. - Save the settings and place test orders.
The current code selects https://sandbox-api.edpay.co.mz for Sandbox and https://api.edpay.co.mz for Production. These API URLs are fixed in the plugin; confirm that they are correct for your EDPay account before testing.
Current checkout behavior and limitations
For a WooCommerce order, the plugin sends amount_minor, currency, a WC-{order ID} reference, return and cancel URLs, customer details, and order metadata to POST /v1/payments. It authenticates with X-EDPay-Public-Key and X-EDPay-Private-Key. The plugin redirects to the response's payment_url or checkout_url field.
This preview does not currently expose a payment-method selector or send a method field, and it does not send an Idempotency-Key. Confirm the required request fields and payment routing with EDPay before relying on this integration. Do not treat the customer's return to the store as proof of payment.
Configure and test the webhook
In the EDPay dashboard, register this callback URL, replacing the hostname with your store's HTTPS hostname:
https://store.example/?wc-api=edpay_webhook
Configure the webhook secret in the WooCommerce payment settings and subscribe to the payment lifecycle events your store needs. The plugin validates X-EDPay-Signature with HMAC-SHA256, then handles payment.succeeded, payment.failed, and payment.canceled events using the order ID in data.metadata.order_id.
Before considering a live deployment, test successful, failed, and canceled payments, repeated webhook deliveries, invalid signatures, and missing or malformed webhook data in Sandbox. Confirm that duplicate deliveries do not cause unacceptable behavior for your store.
Security
- Never expose
sk_test_...,sk_live_..., orwhsec_...in browser code, public repositories, logs, or support screenshots. - Keep the API private key and webhook secret on the server.
- Use HTTPS for the store and webhook endpoint.
- Verify payment state from validated webhooks, not from a customer redirect or return URL.
Documentation
License
The plugin header declares GPL-3.0-or-later.
Other official SDK repositories
Other official e-commerce plugin repositories
These repositories are official integration previews. Check each repository's status and test it in a sandbox before using it with a live store.