Setup and Configuration

The Nowacash WooCommerce Gateway plugin enables merchants to accept payments and manage recurring billing directly through WooCommerce. This plugin integrates seamlessly with the Nowacash API, supporting credit/debit card payments and rebill functionality.

🔧 Installation

  1. Download and install the Nowacash WooCommerce Gateway plugin.

  2. In your WordPress dashboard, go to Plugins → Add New.

  3. Upload the plugin .zip file and click Install Now.

  4. Activate the plugin.

58KB
nowacash-woocommerce-gateway.zip
archive
Open

⚙️ Configuration

Once installed, configure the gateway by navigating to:

WooCommerce → Settings → Payments → Nowacash Payment

You will see the following configuration screen:

General Settings

  • Enable/Disable Check this box to enable Nowacash as a payment method in your store.

  • Title The payment method name displayed to customers during checkout. Example: Woocommerce Payment Gateway for Nowacash

  • Description A short description shown to customers at checkout. Example: Pay easily through Nowacash using your preferred method.

API Settings

  • Base URL Enter the NowaCash API base URL. Use the sandbox environment for testing: https://engine-sandbox.nowacash.com For production, use: https://engine.nowacash.com

  • API Key Your unique API key provided by Nowacash. (Keep this secure and do not share it.)

  • Notification URL This is the webhook endpoint used by NowaCash to send payment updates. Example: https://yourdomain.com/wc-api/nowacash_webhook

Payment Options

  • Allowed Payment Methods Select which payment methods to allow (e.g., Credit/Debit Card).

  • Start Recurring Enable this option to allow recurring/rebill payments.

  • Pre-Authorization (optional) Allows 2-phase charges (authorize first, capture later).

  • Send Card Data Directly (PCI DSS only) If your system is PCI DSS compliant, you may enable direct card data sending. Otherwise, leave unchecked.

  • Additional Parameters (JSON) Optional advanced configuration in JSON format. Example:

🔄 Recurring Payments (Rebill)

When Recurring Payment Chain is enabled:

  • Customers can subscribe to products or services.

  • The gateway automatically handles rebills according to WooCommerce Subscriptions logic.

  • Webhooks update payment status (success, failed, canceled).

✅ Testing the Gateway

  1. Enable Sandbox Mode using the sandbox base URL.

  2. Place a test order in WooCommerce checkout.

  3. Confirm webhook notifications update the order status.

  4. Once verified, switch to the production base URL and live API key.

📌 Troubleshooting

  • Payments not updating? Ensure your Notification URL is reachable and properly configured.

  • Invalid API Key? Verify the key matches the one provided in your Nowacash dashboard.

  • Recurring payments failing? Confirm that rebill is enabled both in the plugin and in your Nowacash account.

📷 Screenshots

Plugin Configuration

Checkout page with Nowacash option

WooCommerce Nowacash payment

PreviousPatch subscription

Last updated