Ultraner Payments for WooCommerce, accept mobile money across Africa.
# Ultraner Payments for WooCommerce
A WordPress/WooCommerce payment gateway that accepts mobile money across Africa via Ultraner. Live in Tanzania and Rwanda, expanding across the continent.
- Docs:
ultraner.com
- OpenAPI:
ultraner.com
- For AI:
ultraner.com
## How a WordPress payment plugin works
A WordPress payment plugin is a normal WordPress plugin that registers a **WooCommerce payment gateway**:
1. A main plugin file with the WordPress plugin header (`Plugin Name`, `Version`, ...).
2. On `plugins_loaded`, define a class that extends `WC_Payment_Gateway`.
3. `init_form_fields()` defines the admin settings (API key, base URL, title).
4. `payment_fields()` renders the checkout inputs (here: phone + network).
5. `process_payment($order_id)` calls the Ultraner API (`POST /v1/payments/express/mno`) using `wp_remote_post`, then sets the order status.
6. Register the class via the `woocommerce_payment_gateways` filter.
That is exactly what `ultraner-payments.php` does, in a single self-contained file (no Composer needed, it uses WordPress's built-in `wp_remote_post`).
## Install
1. Copy the `ultraner-wordpress` folder into `wp-content/plugins/ultraner-payments`.
2. In WordPress admin: **Plugins -> Activate "Ultraner Payments for WooCommerce"**.
3. Go to **WooCommerce -> Settings -> Payments -> Ultraner**, enable it, and paste your API key (`sk_live_...`).
(Or zip the folder and upload it via **Plugins -> Add New -> Upload Plugin**.)
## Flow
On checkout the customer enters their mobile number and picks a network. The plugin charges the wallet through Ultraner; the customer approves the USSD push on their phone. The order is set to **on-hold** until confirmed, confirm/complete it from a webhook or the Ultraner dashboard.
## License
MIT