Skip to main content

Notch Pay WordPress Plugin

The Notch Pay WordPress plugin allows you to accept payments on your WordPress site without any coding. It integrates seamlessly with popular plugins like WooCommerce, Easy Digital Downloads, and more.

Installation

1

Download the Plugin

Download the Notch Pay WordPress plugin from the WordPress Plugin Directory or directly from your WordPress admin dashboard.
2

Install the Plugin

  1. Log in to your WordPress admin dashboard
  2. Go to Plugins > Add New
  3. Click Upload Plugin and select the downloaded zip file
  4. Click Install Now
  5. After installation, click Activate Plugin
3

Configure the Plugin

  1. Go to Settings > Notch Pay
  2. Enter your API keys (found in your Notch Pay Business dashboard)
  3. Configure other settings according to your preferences

Basic Configuration

Notch Pay WordPress Plugin Settings

General Settings

Payment Forms

The plugin provides shortcodes to create payment forms on any page or post:

Basic Payment Form

[notchpay_payment_form amount="5000" currency="XAF" button_text="Pay Now"]
This will create a simple payment form with name and email fields.

Advanced Payment Form

[notchpay_payment_form 
  amount="5000" 
  currency="XAF" 
  button_text="Pay Now" 
  title="Payment for Premium Content" 
  description="Access to premium articles for one month" 
  show_phone="yes" 
  redirect="https://example.com/thank-you"
]

Payment Form Parameters

Payment Buttons

For a simpler integration, you can use payment buttons:
[notchpay_button amount="5000" currency="XAF" email="customer@example.com" name="John Doe" button_text="Pay Now"]
This creates a button that directly initiates a payment when clicked, without showing a form.

Payment Button Parameters

Create shareable payment links that can be sent via email, social media, or any other channel:
[notchpay_link amount="5000" currency="XAF" title="Donation" description="Support our cause"]
This will display a link that, when clicked, takes the user to a payment page.

Gutenberg Blocks

The plugin also provides Gutenberg blocks for a more visual editing experience:

Payment Form Block

Add a payment form to your page using the visual editor

Payment Button Block

Add a payment button to your page

Payment Link Block

Add a payment link to your page

Recent Payments Block

Display a list of recent payments

WooCommerce Integration

The plugin integrates with WooCommerce to provide Notch Pay as a payment gateway:
1

Enable the Gateway

  1. Go to WooCommerce > Settings > Payments
  2. Find “Notch Pay” in the list of payment gateways
  3. Click Set up or toggle the switch to enable it
2

Configure the Gateway

  1. Enter the title and description to display at checkout
  2. Select which payment methods to enable
  3. Configure other settings as needed
  4. Click Save changes

WooCommerce Settings

Notch Pay WooCommerce Settings

Easy Digital Downloads Integration

The plugin also integrates with Easy Digital Downloads:
1

Enable the Gateway

  1. Go to Downloads > Settings > Payment Gateways
  2. Check the “Notch Pay” checkbox
  3. Click Save Changes
2

Configure the Gateway

  1. Go to the “Notch Pay” tab
  2. Configure the gateway settings
  3. Click Save Changes

Membership Plugins Integration

The plugin integrates with popular membership plugins:
  1. Go to Memberships > Settings > Payment Gateways
  2. Select “Notch Pay” as the payment gateway
  3. Configure the gateway settings
  4. Click Save Settings

MemberPress

  1. Go to MemberPress > Settings > Payments
  2. Click Add Payment Method
  3. Select “Notch Pay” from the dropdown
  4. Configure the gateway settings
  5. Click Update Options

Webhooks

The plugin automatically sets up a webhook endpoint to receive notifications from Notch Pay:
https://your-site.com/wp-json/notchpay/v1/webhook
Make sure to add this URL to your webhook endpoints in the Notch Pay dashboard.

Payment Records

The plugin keeps records of all payments made through it:
  1. Go to Notch Pay > Payments in your WordPress admin
  2. View a list of all payments with their status, amount, and customer information
  3. Click on a payment to view its details
Notch Pay Payment Records

Customization

Custom CSS

You can customize the appearance of payment forms and buttons by adding custom CSS to your theme:
/* Customize payment form */
.notchpay-form {
    background-color: #f9f9f9;
    padding: 20px;
    border-radius: 8px;
}

/* Customize payment button */
.notchpay-button {
    background-color: #4F46E5;
    color: white;
    padding: 12px 24px;
    border-radius: 4px;
    border: none;
    font-weight: bold;
}

.notchpay-button:hover {
    background-color: #4338CA;
}

Hooks and Filters

The plugin provides hooks and filters for developers to extend its functionality:
// Modify payment parameters before creating a payment
add_filter('notchpay_payment_params', function($params, $form_data) {
    // Add custom metadata
    $params['metadata']['custom_field'] = 'custom_value';
    
    return $params;
}, 10, 2);

// Do something after a successful payment
add_action('notchpay_payment_complete', function($payment, $order = null) {
    // Send a custom email
    wp_mail(
        $payment['customer']['email'],
        'Thank you for your payment',
        'Your payment of ' . $payment['amount'] . ' ' . $payment['currency'] . ' has been received.'
    );
}, 10, 2);

Troubleshooting

If the payment form is not displaying correctly:
  1. Check that the shortcode is correctly formatted
  2. Ensure that the plugin is activated
  3. Check for JavaScript errors in your browser console
  4. Try disabling other plugins to check for conflicts
If payments are not being processed:
  1. Verify that your API keys are correct
  2. Check that you’re using the right keys for test/live mode
  3. Check the Notch Pay dashboard for any failed payments
  4. Ensure your server can make outgoing HTTP requests
If webhooks are not being received:
  1. Verify that the webhook URL is correctly added in the Notch Pay dashboard
  2. Check that your webhook secret is correct
  3. Ensure your server is accessible from the internet
  4. Check your server logs for any errors
If the WooCommerce integration is not working:
  1. Make sure WooCommerce is up to date
  2. Verify that the Notch Pay gateway is enabled in WooCommerce settings
  3. Check that your currency is supported by Notch Pay
  4. Try placing a test order to see if there are any error messages

Frequently Asked Questions

Yes, you can enable test mode in the plugin settings. In test mode, the plugin will use your test API keys and process test payments.
The plugin supports all payment methods available on Notch Pay, including Mobile Money, Cards, Bank Transfers, and more. The available methods depend on your Notch Pay account and the countries you operate in.
Yes, you can customize the appearance of payment forms and buttons using custom CSS. You can also use hooks and filters to modify the behavior of the plugin.
Yes, when integrated with WooCommerce Subscriptions or membership plugins, the plugin can handle recurring payments.
The plugin is designed to be compatible with most WordPress themes. If you encounter any compatibility issues, you can use custom CSS to adjust the appearance.
I