Skip to main content
Version: 2.x

Payment Methods

Each payment method your store offers at the till appears as a tile on the checkout tender pane, or on its Legacy tab. Cash and Card come with every store; other WooCommerce gateways need WCPOS Pro.

Default Payment Methods​

The free plugin offers two payment methods, Cash and Card, and no others. Both are recorded at the till, so a sale paid with them completes even when the store can't be reached.

Cash​

  • Enter the amount handed over; the change is shown as you type
  • The only method that gives change (with Pro, WooCommerce's cash on delivery does too)
  • Several cash payments can go on one order
  • No additional configuration required

Card​

  • For a card terminal that isn't connected to the POS
  • Take the payment on the terminal, then record it at the till
  • No direct integration required

Additional Payment Gateways (Pro)​

Pro Feature

Additional payment gateways require WCPOS Pro.

With Pro, you can enable any installed WooCommerce gateway for the POS. How it works at the till depends on the gateway:

  • Recorded at the till — WooCommerce's cash on delivery, bank transfer and cheque gateways are recorded by the cashier, like Card, and complete offline.
  • Card readers — terminal gateways such as Stripe Terminal (including Bluetooth readers and Tap to Pay) and SumUp are driven from the tender pane. A terminal gateway that hasn't been built for the tender pane is offered on the Legacy tab instead.
  • Pay-later gateways — such as Email Invoice, which sends an invoice and leaves the order unpaid until the customer pays it.
  • Any other WooCommerce gateway — appears on the Legacy tab, which opens the gateway's own payment page inside the POS. A legacy gateway charges the whole order, so it can't be part of a split payment.

Refunds for gateways that support them run on your store, against the payment they apply to. See Refunds.

Enabling and Disabling Gateways​

Payment gateways are managed in the WordPress admin:

  1. Go to WP Admin > POS > Settings > Checkout
  2. You'll see a list of all installed WooCommerce payment gateways
  3. Toggle each gateway on or off for the POS independently of your online store
  4. Drag to reorder — the order is the order of the tiles at the till

This means a gateway can be active on your website but disabled in the POS, or vice versa. See Checkout Settings for full details.

Testing Payments​

Before going live with a new gateway:

  1. Cash gateway — always available for testing the checkout flow without real transactions.
  2. Stripe Terminal — Stripe provides a simulated reader for test mode. Enable test mode in your Stripe dashboard first.
  3. Third-party gateways — check the gateway's own documentation for sandbox/test mode instructions. Most WooCommerce gateways support a test mode toggle.
tip

If a newly enabled gateway doesn't appear at checkout, try refreshing the POS. Gateway changes in WP Admin take effect on the next page load.

Common Issues​

Gateway Not Appearing at Checkout​

  • Confirm the gateway is enabled for POS in WP Admin > POS > Settings > Checkout.
  • Check that the gateway's plugin is installed and active. The gateway doesn't have to be switched on in WP Admin > WooCommerce > Settings > Payments to work in the POS.
  • Gateways other than Cash and Card need WCPOS Pro.
  • Look on the Legacy tab: a gateway that hasn't been built for the tender pane is listed there.
  • Refresh the POS after making changes.

A tile that is shown but can't be used is listed with its reason, for example Needs a connection while you're offline, or a prompt to update the app.

Gateway Displays Incorrectly​

This applies to gateways on the Legacy tab, whose payment page loads your site's theme styles and scripts. Use the Checkout Settings button on that page to selectively disable styles or scripts. See Checkout Troubleshooting for details.

Payment Processing Fails​

  • Check your site's error logs (WP Admin > POS > Support > Logs) for gateway-specific errors.
  • For a card reader, open the payment's log on the tender pane; it shows each step the reader reported.
  • Ensure your SSL certificate is valid — most payment gateways require HTTPS.
  • If using a staging or local environment, confirm the gateway supports test/sandbox mode.

Custom Gateways​

Create your own payment integrations using the Custom Gateways system.