Sauki Pay WordPress Plugin Guide

What This Plugin Does

Sauki Pay helps you accept payments on your WordPress website. The plugin connects securely to the Sauki Pay API and redirects customers or donors to Sauki Pay checkout to complete payment.

Add Sauki Pay to WooCommerce checkout.
Add Sauki Pay to GiveWP donation forms.
Add a standalone Sauki Pay payment form to any page.

Requirements

WordPress 5.8 or newer.
PHP 7.4 or newer.
Sauki Pay merchant public and secret keys.
WooCommerce, only if you want WooCommerce checkout payments.
GiveWP, only if you want GiveWP donation payments.

Download The Plugin

You can download the Sauki Pay WordPress plugin from the official GitHub release page.

Open the Sauki Pay WordPress plugin release page

Download the plugin ZIP directly

Download the ZIP file before installing the plugin in WordPress.

Install The Plugin

Log in to your WordPress admin dashboard.
Go to Plugins > Add New > Upload Plugin.
Upload the Sauki Pay plugin ZIP file.
Click Install Now.
Click Activate Plugin.

Configure Sauki Pay

Open Sauki Pay from the WordPress admin menu.
Enable the plugin.
Choose test mode or live mode.
Enter your Sauki Pay public and secret keys.
Choose optional success and failure pages for standalone payment forms.
Confirm the API base URL and save your settings.

Use test mode while setting up and switch to live mode only when you are ready to accept real payments.

Callback And Webhook URLs

The settings page displays the URLs your website uses for payment confirmation. Copy the webhook URL from the settings page and add it to your Sauki Pay dashboard.

The plugin callback URL and webhook URL should stay the same unless your website domain changes. Success and failure pages are internal WordPress landing pages and do not need to be added to the Sauki Pay dashboard.

If you are testing locally, your WordPress site must be reachable from the internet. A public staging website is recommended.

WooCommerce Payments

Install and activate WooCommerce.
Open WooCommerce > Settings > Payments.
Enable Sauki Pay.
Set the checkout title and description.
Save changes.

When a customer pays through WooCommerce, the plugin creates a payment reference, sends the order details to Sauki Pay, redirects the customer to checkout, verifies the payment, and updates the order.

GiveWP Donation Payments

Install and activate GiveWP.
Open Donations > Settings > Payment Gateways.
Enable Sauki Pay in the gateway list.
Set Sauki Pay as the default gateway if you want donors to see it first.
Save changes.
Configure your Sauki Pay keys in the Sauki Pay plugin settings.

Sauki Pay appears on GiveWP donation payment screens as a secure checkout option with Sauki Pay branding. Donors are redirected to Sauki Pay checkout and returned after payment.

Payment Form Shortcode

Open Sauki Pay > Payment Form in WordPress admin to create or edit the standalone form. The page generates a shortcode for you.

[saukipay_payment_form] [saukipay_payment_form amount="5000" currency="NGN" title="Pay Registration Fee" fixed_amount="yes"] [saukipay_payment_form currency="NGN" title="Donate" preset_amounts="1000,10000,50000" allow_custom_amount="yes"]

For a polished payment journey, create dedicated success and failure pages in WordPress, then select them in Sauki Pay settings. If no pages are selected, the plugin returns customers to the original page where the form was submitted.

Payment Form Options

Option	Description
Form title	The heading shown above the form fields.
Description	Optional text shown under the form title.
Amount	Optional default amount.
Preset amounts	Quick-select payment amounts shown as branded amount boxes. Separate each amount with a comma.
Allow custom amount	Lets customers type a custom amount if the preset amount they want is not listed.
Currency	The payment currency, for example `NGN`.
Button text	The text shown on the payment button.
Footer note	Optional text shown below the payment button.
Fixed amount	Prevents customers from changing the amount.
Form width	Controls whether the form is compact, wide, or full width.

Customer Payment Flow

Customer enters their name, email, phone number, and amount.
Customer clicks the Sauki Pay button.
The customer is redirected to Sauki Pay checkout.
After payment, Sauki Pay redirects the customer back to your website.
The plugin verifies the payment and shows a success or failure message.

Webhook Confirmation

Sauki Pay can send webhook events to your website after payment. The plugin verifies webhook requests before processing them.

When a webhook is valid and handled successfully, your website returns ok.

Webhooks help keep WooCommerce orders, GiveWP donations, and shortcode payment records updated even if a customer closes the browser before returning to your website.

Transactions Dashboard

Open Sauki Pay > Transactions to view processed invoices and payments across WooCommerce, GiveWP, and standalone payment forms.

Filter by status, environment, source, currency, date range, reference, email, or phone.
Review summary cards for total, successful, pending, and failed transactions.
Use the verify action to re-check a transaction reference with Sauki Pay.

The Transactions dashboard requires the Sauki Pay backend WordPress endpoints /wp/transactions and /wp/transactions/summary.

Form Payments

Open Sauki Pay > Form Payments to view standalone payment form submissions saved on this WordPress site.

See payer name, email, phone, amount, currency, environment, status, and payment dates.
Filter by status, environment, currency, date range, reference, name, email, or phone.
Use the verify action to re-check a form payment reference with Sauki Pay.

Form Payments is stored locally in your WordPress database and is only for standalone shortcode payment form submissions.

Plugin Screenshots

These examples show the Sauki Pay settings, form builder, standalone payment form, and GiveWP checkout experience. Sensitive keys and merchant-site URLs are hidden in the documentation images.

Sauki Pay settings page with keys and callback URLs hidden — Sauki Pay settings page

Sauki Pay payment form builder with shortcode and preview — Payment form builder

Standalone Sauki Pay payment form with preset donation amounts — Standalone payment form

GiveWP donation checkout with Sauki Pay selected — GiveWP checkout with Sauki Pay

Going Live

Confirm your live public key and live secret key are saved.
Turn off test mode.
Confirm your webhook URL is saved in your Sauki Pay dashboard.
Run a small live payment to confirm everything works.

Support

If you need help with your Sauki Pay account or API keys, contact Sauki Pay support.

Credits

Official plugin author: Sauki Pay.

Developed by Ayomikun Oloyede, Co-founder / Lead backend Engineer.

GitHub · LinkedIn