WooCommerce: complete setup and operating guide

Features, installation, checkout settings, daily payment operations, testing, troubleshooting and limitations

The basics
A plugin is a ready-made connector between your online shop and Paypercut. It saves you from building your own payment connection. A webhook is the automatic message that tells your shop whether a payment succeeded so it can update the order.

At a glance: what this integration supports

The WooCommerce integration lets you accept card payments, choose a hosted or embedded checkout experience, adjust the payment label, offer supported wallets and saved payment methods, and keep WooCommerce orders updated after payment.

Before starting

You need a Paypercut account, administrator access to WooCommerce, an HTTPS website and Sandbox access for testing. A plugin is a ready-made connection between your shop and Paypercut. An API key is the private credential that lets the plugin connect securely. For version and server requirements, see the linked WooCommerce technical guide.

Install and connect

  1. Open WordPress → Plugins → Add New and search for Paypercut Payments for WooCommerce, or install the official plugin from WordPress.org. Activate it.
  2. Open WooCommerce → Settings → Payments → Paypercut and choose Manage.
  3. Enable Paypercut Payments, choose the customer-facing payment-method title and whether Paypercut branding should appear.
  4. Paste your Paypercut sandbox API key from your Merchant Dashboard into API Configuration, then select Test Connection.
  5. Save changes.

Choose how shoppers check out

  1. In Checkout settings, select Hosted when you want customers to complete payment on a secure Paypercut page; select Embedded when the payment form should appear inside your shop.
  2. If the plugin version displays an Elements checkout choice, check its wallet settings and domain configuration before enabling wallet buttons. Available options may vary by plugin version.
  3. Set Saved payment methods if you want returning shoppers to reuse a saved card where the checkout supports it.
  4. Decide whether to enable diagnostic Logging so errors can be investigated. Save changes.

Make order statuses update automatically

A webhook is an automatic payment-status message. In the Paypercut plugin Webhooks section, choose Create Webhooks. The plugin creates the required connections so a successful Paypercut payment can update the matching WooCommerce order. If a customer pays but the order stays unpaid, check this connection first.

Run a complete test before going live

  1. Place a small test order in your storefront and choose Paypercut at checkout.
  2. Use a Paypercut test card in sandbox. Never use a real card in the test environment.
  3. Check the payment in Paypercut → Payments and the matching order under WooCommerce → Orders.
  4. Check the paid status and customer return flow. Test a refund separately before you rely on it operationally.
  5. When approved, replace the test key with the production key, recheck webhooks and make a small live payment.

choose hosted or embedded checkout

Choose Hosted if you want customers to pay on a secure Paypercut page, or Embedded if the payment form should appear inside your shop. Open the Paypercut payment settings in WooCommerce to select the experience and check the result with a test order.

Configure

  1. Go to WooCommerce → Settings → Payments → Paypercut → Manage.
  2. Under Checkout settings choose Hosted or Embedded.
  3. Edit the payment-method Title and Paypercut branding options in Display settings.
  4. Save changes, then place a sandbox test order using each experience you intend to offer.

What to check

Check payment success, order-status updates and customer return experience. Do not assume choosing Embedded automatically makes wallet buttons appear. Verify wallet configuration separately.

Additional features and limitations

In the Paypercut settings, review the options for wallet payments, saved payment methods and order updates. Enable only the payment options you plan to offer, then check them in Sandbox. For subscription billing or additional payments, ask Paypercut about a suitable integration before advertising the feature.

Configure and check

  1. Open WooCommerce → Settings → Payments → Paypercut → Manage.
  2. Choose the checkout experience you use for wallet payments.
  3. Review Apple Pay, Google Pay and payment-domain settings in your plugin, and complete any required domain setup.
  4. Turn on saved payment methods if you want eligible returning customers to reuse their cards.
  5. Test the payment options on a compatible device with Sandbox before accepting real payments.

refund an order paid with Paypercut

Refunds can be initiated from WooCommerce order management if the installed Paypercut plugin exposes the refund-via-gateway action.

Refund the order

  1. Open WooCommerce → Orders and select the paid order.
  2. Choose Refund and specify the items or amount.
  3. Use the payment-gateway refund action (for example, Refund via Paypercut) rather than Refund manually when you want money to return through Paypercut.
  4. Confirm the action and check order notes and the payment status in the Paypercut Dashboard.

Important limits

The WooCommerce plugin offers a defined set of payment features. Review its available checkout options and test any wallets or saved methods before enabling them for customers. For any additional payment capability, confirm availability with Paypercut first.

If a button is missing

Check the customer device/browser, enabled wallet settings and domain verification. If your plugin does not expose a required setting, contact integrations support rather than assuming it is automatically available.

If it fails

Check that the payment succeeded, is eligible to refund and has available refundable balance. Do not create the same refund again in the Paypercut dashboard without first checking whether WooCommerce already sent it.


Official Paypercut documentation

For advanced configuration and technical details, see the official Paypercut documentation.

Open documentation


Need more help?

Find the right support contact for your question.

Contact support