Seev PlusDocs
Docs
SDKs & Integrations

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

RequirementWhy
A verified SeevPlus organizationLive payments need an approved organization. Sandbox works before approval.
WooCommerce on WordPress 6.2 or newer, PHP 7.4 or newerThe 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 environmentOne production key and one sandbox key. See API Keys.

The plugin works with both the block checkout and the classic checkout.

Set it up

  1. In WordPress, go to Plugins, Add New, search for "SeevPlus for WooCommerce", then install and activate it.
  2. In the SeevPlus dashboard, open Developers, choose Checkout API and generate a production key and a sandbox key.
  3. In WordPress, go to WooCommerce, Settings, Payments, SeevPlus. Paste the live key under Live API key and the sandbox key under Sandbox API key.
  4. Copy the webhook link shown on that settings page.
  5. In the SeevPlus dashboard, open Developers, Webhooks and add that link with the payment.succeeded and payment.failed events. Do this once for production and once for sandbox.
  6. 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

  1. Turn on Test mode in the plugin settings.
  2. While logged in as a store manager, place an order and choose SeevPlus.
  3. On the sandbox checkout page, approve the payment. The order moves to Processing.
  4. Place a second order and decline it. The order is marked Failed and you are sent back to pay again.
  5. 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

  1. The shopper chooses SeevPlus and places the order.
  2. The plugin creates a checkout session for the order total and sends the shopper to the SeevPlus payment page.
  3. The shopper pays and comes back to your store.
  4. The plugin asks SeevPlus for the payment's status. It never trusts the return link alone.
  5. 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 happenedOrder statusOrder note
Payment confirmed and the amount matchesProcessing, or Completed for orders WooCommerce completes on paymentThe SeevPlus reference
Payment failed or was cancelledFailedThe reason SeevPlus gave. The shopper can pay again from the order.
Payment confirmed but the amount or currency did not matchOn holdCheck the payment in your SeevPlus dashboard before you ship
A sandbox payment was approved after test mode was turned offOn holdNo money moved, so the order was not marked paid
A second payment arrived for an order that was already paidUnchangedRefund the shopper from your SeevPlus dashboard

Fix common problems

ProblemWhat to check
SeevPlus does not show at checkoutThe 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 pendingThe 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 401The 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.

On this page