PayStack Payment Gateway Documentation

Installation & Setup Guide

Overview

The WP Dating Paystack Addon allows your WP Dating website to accept payments via Paystack.
It supports:

  1. Membership payments
  2. Credit purchases
  3. Optional recurring subscriptions

Requirements

Before installing, make sure you have:

  1. WordPress 5.0+
  2. WP Dating (main plugin) installed and activated
  3. PHP 7.0+
  4. SSL certificate (HTTPS required)
  5. A Paystack merchant account

1. Create a Paystack Account

  1. Go to https://paystack.com
  2. Create a free account
  3. Verify your email
  4. Complete business verification

Once approved:

  1. Log into Paystack Dashboard
  2. Go to Settings → API Keys & Webhooks

Copy:

  1. Public Key pk_test_... or pk_live_...
  2. Secret Key sk_test_... or sk_live_...

⚠️ Keep your Secret Key private.

2. Install the Plugin

Option A – Upload via WordPress

  1. Go to WordPress Admin → Plugins → Add New
  2. Click Upload Plugin
  3. Upload the ZIP file
  4. Click Install
  5. Click Activate

Option B – Manual Installation (FTP)

  1. Upload the plugin folder to: /wp-content/plugins/wpdating-payment-paystack/
  1. Activate plugin in: WordPress Admin → Plugins

3. Configure Paystack in WordPress

  1. Go to: DSP Admin → Paystack
  2. Fill in: Required Fields
    1. Secret Key: Your Paystack secret key
    2. Public Ke:y Your Paystack public key
    3. Currency Symbol
      Example:
    4. NGN or ₦
    5. GHS or ₵
    6. ZAR or R
    7. Button Label
      Example:
      Pay with Paystack
    8. Enable Recurring (optional)
      Check this if you want subscription payments.
    9. Click Save Changes

4. Setup Webhook (Important)

Paystack must notify your website after payments.

Your webhook URL:

https://yourdomain.com/?wpdating-api=wc_gateway_paystack

Add it in Paystack:

  1. Paystack Dashboard → Settings → API Keys & Webhooks
  2. Click Add Webhook URL
  3. Paste your webhook URL
  4. Enable:

✅ charge.success
✅ subscription.create (if using recurring)

Save.

5. Test Payments (Recommended)

Use Paystack test keys first.

Test Card

Card Number:

4084084084084081

CVV: any 3 digits
Expiry: any future date

Test:

  1. Membership purchase
  2. Credit purchase
  3. Subscription (if enabled)

Confirm:

  1. Payment completes
  2. User receives membership or credits

Logs

Webhook log file:

/wp-content/plugins/wpdating-payment-paystack/wpdating_webhook_log_file.log

Use this to diagnose payment issues.

Common Problems

Paystack not showing

  1. WP Dating plugin must be active
  2. Check API keys
  3. Reactivate plugin

Payment successful, but the user was not updated

  1. Verify webhook URL
  2. Check webhook log
  3. Confirm HTTPS is working

Button missing

  1. Make sure plans exist in WP Dating
  2. Confirm Paystack keys are saved

Support

Before contacting support:

  1. Test with Paystack test keys
  2. Check webhook log
  3. Verify SSL
  4. Disable cache plugins temporarily

Plugin Support

Email: wpdatingplugin@gmail.com
Website: https://wpdating.com

Please include:

  1. WordPress version
  2. WP Dating version
  3. Paystack addon version
  4. PHP version
  5. Error messages

Security Notes

  1. Never share Secret Key
  2. Always use HTTPS
  3. Keep WordPress updated
  4. Use strong admin passwords
  5. Make regular backups

What This Plugin Handles

  1. One-time payments
  2. Membership upgrades
  3. Credit purchases
  4. Optional subscriptions
  5. Automatic webhook processing

Plugin Version: 1.0.1

If you’d like, next I can also provide:

✅ Short “Quick Start” version
✅ FAQ section
✅ Screenshots captions
✅ Changelog template

Close Menu