Kwugwo for WooCommerce adds Kwugwo as a payment option on your store. Kwugwo is a payment orchestration service for Nigerian businesses: you connect the payment providers you already have accounts with, and Kwugwo routes each payment to the right one. Money settles straight into your own provider account; Kwugwo never holds it.<\/p>\n\n
When a customer chooses Kwugwo at checkout, a secure Kwugwo window opens on your store where they can pay by bank transfer, USSD or with their bank app. Their bank details are entered in Kwugwo's window, never on your site.<\/p>\n\n
This plugin connects to Kwugwo, a payment orchestration service run by Kwugwo, to take payments. It cannot work without it.<\/p>\n\n
Kwugwo API<\/strong> ( Kwugwo checkout<\/strong> ( Webhooks<\/strong>: Kwugwo sends payment updates to your store's webhook URL. No data is sent from your store when receiving them.<\/p>\n\n The service is provided by Kwugwo: Terms of service<\/a>, Privacy policy<\/a>.<\/p>\n\n The plugin adds suggested text to Settings \u2192 Privacy \u2192 Policy Guide<\/strong> describing the data shared with Kwugwo. It does not track visitors and sends nothing to Kwugwo until a customer chooses Kwugwo at checkout or you configure the plugin.<\/p>\n\n Nigerian Naira (NGN) only, from \u20a6200 to \u20a650,000,000 per order. Kwugwo is hidden at checkout when your store uses another currency.<\/p><\/dd>\n Open the Kwugwo settings and look at the setup checklist. Kwugwo is only shown when it is turned on, the store currency is NGN, and both keys are saved for the selected mode.<\/p><\/dd>\n The webhook is how Kwugwo tells your store that a customer has paid. You should set it up: without it, an order only updates when the customer returns to your store or when the background check runs. Add the Webhook URL from the settings page in your Kwugwo dashboard, once for Sandbox and once for Live, and paste each signing secret into the plugin.<\/p><\/dd>\n Sending other events as well does no harm.<\/p><\/dd>\n Bank transfers and USSD can take a few minutes. Open the order and click Check payment status now<\/strong> in the Kwugwo payment box. If the payment matches the order, the order moves to Processing.<\/p><\/dd>\n A checkout is a set of payment methods and routing rules you create in your Kwugwo dashboard. Leave it on Automatic to let your routing rules choose, or pick one so that every payment from this store uses it.<\/p><\/dd>\n Some providers cannot send money back to a bank transfer or USSD payer on their own. Enter the customer's bank and 10-digit account number in the Kwugwo payment box on the order, click Update<\/strong>, then refund again.<\/p><\/dd>\n Allow requests from Kwugwo's address https:\/\/api.kwugwo.africa<\/code> for Live, https:\/\/sandbox-api.kwugwo.africa<\/code> for Sandbox). Your server sends requests using your secret key:<\/p>\n\n\n
https:\/\/checkout.kwugwo.africa<\/code>). When the customer reaches the payment page, the plugin opens Kwugwo's secure payment window in a frame. The window receives your public key, the Kwugwo payment ID and your store's web address. The customer enters their payment details there.<\/p>\n\nPrivacy<\/h3>\n\n
Source code<\/h3>\n\n
\n
assets\/js\/kwugwo-checkout.js<\/code> is the unminified browser build of the official Kwugwo checkout SDK, @kwugwo\/checkout<\/a> 0.1.3 (MIT licence). Its source is at github.com\/Kwugwo\/checkout-js<\/a>. To rebuild it, clone that repository, check out version 0.1.3, then run npm ci<\/code> and BUILD_VARIANT=dev npx tsup<\/code>; the file is dist\/kwugwo-checkout.global.js<\/code>.<\/li>\n\n
\n
\n
Which currencies are supported?<\/h3><\/dt>\n
Why is Kwugwo not showing at checkout?<\/h3><\/dt>\n
What is the webhook, and do I need it?<\/h3><\/dt>\n
Which webhook events should I choose?<\/h3><\/dt>\n
\n
ugwo.successful<\/code> (required): marks the order paid.<\/li>\nugwo.updated<\/code>: updates the order when a payment is cancelled or refunded.<\/li>\nugwo.activity.updated<\/code>: puts the order on hold if the payment provider reverses a payment.<\/li>\nugwo.activity.double_charge_detected<\/code>: warns you when a customer pays twice.<\/li>\nrefund.successful<\/code> and refund.failed<\/code>: record refund results on the order.<\/li>\n<\/ul>\n\nAn order is still \"Pending payment\" but the customer says they paid.<\/h3><\/dt>\n
What does \"Checkout (optional)\" do?<\/h3><\/dt>\n
A refund failed and asks for the customer's bank account.<\/h3><\/dt>\n
My site is behind a firewall.<\/h3><\/dt>\n
176.97.192.227<\/code> so webhooks can reach your store.<\/p><\/dd>\n\n<\/dl>\n\n\n1.0.0<\/h4>\n\n
\n