WordPress and WooCommerce
Take mobile money and USDC in a WooCommerce store with the SeevPlus for WooCommerce plugin.
SeevPlus for WooCommerce adds SeevPlus as a payment method at your store's checkout. Shoppers pay with MTN MoMo, Telecel Cash or AirtelTigo Money on a SeevPlus page and come back to your store. When your organization has a USDC wallet, they can pay with USDC too. Money settles to your SeevPlus account on your payout schedule.
The plugin is free and listed on WordPress.org as SeevPlus for WooCommerce.
What you need
| Requirement | Why |
|---|---|
| A verified SeevPlus organization | Live payments need an approved organization. Sandbox works before approval. |
| WooCommerce on WordPress 6.2 or newer, PHP 7.4 or newer | The plugin's minimum versions. |
| Store currency set to Ghana cedi (GHS) | SeevPlus only appears at checkout when the store currency is GHS. |
| A Checkout API key for each environment | One production key and one sandbox key. See API Keys. |
The plugin works with both the block checkout and the classic checkout.
Set it up
- In WordPress, go to Plugins, Add New, search for "SeevPlus for WooCommerce", then install and activate it.
- In the SeevPlus dashboard, open Developers, choose Checkout API and generate a production key and a sandbox key.
- In WordPress, go to WooCommerce, Settings, Payments, SeevPlus. Paste the live key under Live API key and the sandbox key under Sandbox API key.
- Copy the webhook link shown on that settings page.
- In the SeevPlus dashboard, open Developers, Webhooks and add that link with the
payment.succeededandpayment.failedevents. Do this once for production and once for sandbox. - Paste each signing secret back into the plugin, under Live webhook signing secret and Sandbox webhook signing secret.
The signing secret is shown only once, when you create the webhook. If you lose it, delete the webhook and add it again.
Test before you go live
- Turn on Test mode in the plugin settings.
- While logged in as a store manager, place an order and choose SeevPlus.
- On the sandbox checkout page, approve the payment. The order moves to Processing.
- Place a second order and decline it. The order is marked Failed and you are sent back to pay again.
- Turn Test mode off.
While test mode is on, only logged-in store managers see SeevPlus at checkout. Shoppers cannot place test orders, because the sandbox page has buttons that approve a payment without any money moving.
How an order gets paid
- The shopper chooses SeevPlus and places the order.
- The plugin creates a checkout session for the order total and sends the shopper to the SeevPlus payment page.
- The shopper pays and comes back to your store.
- The plugin asks SeevPlus for the payment's status. It never trusts the return link alone.
- The order is marked paid only when SeevPlus confirms the payment and the amount and currency match the order.
Orders still finish if the shopper closes the tab before coming back. The webhook tells the plugin about the payment straight away, and a background check looks at unpaid orders every five minutes.
The plugin sends SeevPlus the order total, the order number, and the shopper's name, email, phone and billing address. Shipping, coupons and tax are already in the total WooCommerce works out.
Order statuses
| What happened | Order status | Order note |
|---|---|---|
| Payment confirmed and the amount matches | Processing, or Completed for orders WooCommerce completes on payment | The SeevPlus reference |
| Payment failed or was cancelled | Failed | The reason SeevPlus gave. The shopper can pay again from the order. |
| Payment confirmed but the amount or currency did not match | On hold | Check the payment in your SeevPlus dashboard before you ship |
| A sandbox payment was approved after test mode was turned off | On hold | No money moved, so the order was not marked paid |
| A second payment arrived for an order that was already paid | Unchanged | Refund the shopper from your SeevPlus dashboard |
Fix common problems
| Problem | What to check |
|---|---|
| SeevPlus does not show at checkout | The store currency is GHS, a key is saved for the mode you are in, and in test mode you are logged in as a store manager. |
| A shopper paid but the order is still pending | The webhook is set up for that environment with both events. WordPress runs scheduled jobs when someone visits the site, so the five-minute check can be late on a quiet site. |
| Shoppers see "This store has not finished setting up SeevPlus" | SeevPlus refused the API key. Check that it is a Checkout API key for the right environment and has no extra spaces. |
| Shoppers see "This store cannot take SeevPlus payments right now" | Your organization cannot take live payments yet, usually because verification is not finished. |
Webhook deliveries fail with 401 | The signing secret in the plugin does not match the webhook. Paste it again, or recreate the webhook. |
To see what the plugin sent and received, turn on Debug log in the plugin settings. Logs appear under WooCommerce, Status, Logs as "seevplus". Keys are never logged.