1. Documentation /
  2. Paystack


Paystack allows your store in Nigeria, Ghana or South Africa to accept secure payments from multiple local and global payment channels.


↑ Back to top


↑ Back to top
  • Go to WordPress Admin > Plugins > Add New from the left-hand menu
  • In the search box type Paystack WooCommerce Payment Gateway
  • Click on Install now when you see Paystack WooCommerce Payment Gateway to install the plugin
  • After installation, activate the plugin.

Paystack Setup and Configuration

↑ Back to top
  • Go to WooCommerce > Settings and click on the Payments tab
  • You’ll see Paystack listed along with your other payment methods. Click Set Up
Woocommerce settings page. Select Payments tab.   On the next screen, configure the plugin. There is a selection of options on the screen. Read what each one does below.
Configuration Page of Paystack WooCommerce
Paystack WooCommerce Configuration page
  1. Enable/Disable Check this checkbox to Enable Paystack on your store’s checkout
  2. Title This will represent Paystack on your list of Payment options during checkout. It guides users to know which option to select to pay with Paystack. Title is set to “Debit/Credit Cards” by default, but you can change it to suit your needs.
  3. Description This controls the message that appears under the payment fields on the checkout page. Use this space to give more details to customers about what Paystack is and what payment methods they can use with it.
  4. Test Mode Check this to enable test mode. When selected, the fields in step six will say “Test” instead of “Live.” Test mode enables you to test payments before going live. The orders process with test payment methods, no money is involved so there is no risk. You can uncheck this when your store is ready to accept real payments.
  5. Payment Option Select how Paystack Checkout displays to your customers. A popup displays Paystack Checkout on the same page, while Redirect will redirect your customer to make payment.
  6. API keys  The next two text boxes are for your Paystack API keys, which you can get from your Paystack Dashboard. If you enabled Test Mode in step four, then you’ll need to use your test API keys here. Otherwise, you can enter your live keys.
  7. Additional Settings While not necessary for the plugin to function, there are some extra configuration options you have here. You can do things like add custom metadata to your transactions (the data will show up on your Paystack dashboard) or use Paystack’s Split Payment feature. The tooltips next to the options provide more information on what they do.
  8. Click on Save Changes to update the settings. To account for poor network connections, which can sometimes affect order status updates after a transaction, we strongly recommend that you set a Webhook URL on your Paystack dashboard. This way, whenever a transaction is complete on your store, we’ll send a notification to the Webhook URL, which will update the order and mark it as paid. You can set this up by using the URL in red at the top of the Settings page. Just copy the URL and save it as your webhook URL on your Paystack dashboard under Settings > API Keys & Webhooks tab.
Setting for the Webhook URL on Paystack Dashboard

Paystack on WooCommerce Checkout

↑ Back to top
Once the settings above are complete, Paystack should show in the list of payment options on your checkout page. Paystack appearance on Woocommerce checkout If you do not find Paystack on the Payment method options, please go through the settings again and ensure that:
  • You’ve checked the “Enable/Disable” checkbox
  • You’ve entered the your API Keys in the appropriate field
  • You’ve clicked on Save Changes during setup.