# Payment Methods

**WP admin:** methods are turned on in `WP Admin → POS → Settings → Checkout`. This page also explains the tiles in the POS.

Press **Checkout** to see your payment methods on the tender pane. This page explains each kind of method and how to set them up, then what the till is telling you when a method or a payment doesn't go the way you expect. To take a payment step by step, see [Checkout](/zh-CN/getting-started/make-sale.md).

Go straight to what you need:

* [Take cash or record a card payment](#default-payment-methods)
* [Switch a gateway on, or change the order of the tiles](#enabling-and-disabling-gateways)
* [Round cash to the coins you have](#cash-rounding)
* [A method says it's not available right now](#unavailable-tiles)
* [A payment method is missing](#gateway-not-appearing-at-checkout)
* [A card reader payment didn't finish](#card-reader-problems)
* [The order has an invoice out](#invoice-sent)
* [The Legacy tab shows a message instead of the payment page](#legacy-notices)

## Find the payment controls[​](#payment-controls "直接链接到 Find the payment controls")

![The tender pane for a $45.00 sale: the Payments and Legacy tabs, Split, the amount to pay, the Cash and Card tiles, the exact amount, the keypad and the Take button](/img/2.x/payment/index/en/tablet-light-regular--pay-1-tiles.png)123456789

1. **Payments** — the methods built for the till: Cash, Card and, with Pro, card readers and Email Invoice.
2. **Legacy** — payment methods on their own payment page: **Card** in every version, every other gateway with Pro. **Cash** is taken on the **Payments** tab only. See [The Legacy Tab](/zh-CN/sell/take-payment/legacy-tab.md).
3. **Split** — take the order in more than one payment. See [Split Payments](/zh-CN/sell/take-payment/split-payments.md).
4. **To pay** — the amount for this payment. It starts at the full balance.
5. **Cash** — the selected method is outlined. The first available method in your list is selected when checkout opens.
6. **Card** — for a terminal that isn't connected to the POS. Take the payment on that terminal first, then record it here.
7. **Quick amounts** — tap one instead of typing. **Exact** is the balance to the cent.
8. **Keypad** — type what the customer hands over.
9. **Take** — names the amount and the method. Press it to take the payment.

A method that can't be used right now is folded under a line below the tiles; see [When a tile can't be used](#unavailable-tiles).

## Cash and Card[​](#default-payment-methods "直接链接到 Cash and Card")

Every store has two payment methods, **Cash** and **Card**. Both are recorded at the till, so a sale paid with them completes at the till even when the store can't be reached. The exception is a sale your store has never received, such as one started while offline: checkout shows **No connection** instead of the payment methods, and the sale waits in your open orders. See [Take a payment offline](/zh-CN/sell/offline-mode.md#take-payment-offline).

While the till is offline, their tiles say **Sent later** and **Store may refuse**. The till records the sale now and sends it to your store when the connection returns. In rare cases the store refuses it, and the sale waits in **Store health** with the store's reason until you send it again or discard it. See [Offline Mode](/zh-CN/sell/offline-mode.md#offline-writes).

### Cash[​](#cash "直接链接到 Cash")

* Select **Cash**, type the amount the customer hands over or tap a quick amount, then press **Take … in Cash**. The change shows as you type.
* Cash is the only method that gives change. With WCPOS Pro, WooCommerce's cash on delivery gives change too.
* An order can take several cash payments.
* Your store can round cash totals; see [Cash rounding](#cash-rounding).

### Card[​](#card "直接链接到 Card")

* For a card terminal that isn't connected to the POS.
* Take the payment on your terminal first. Then select **Card** at the till and press **Take** to record it.
* A card payment can't be more than the balance due.

When nothing is left to pay, the sale is done: give any change shown, print or email the receipt, and press **New sale**. If a balance is left, take the rest with another payment; see [Split Payments](/zh-CN/sell/take-payment/split-payments.md). The paid screen is shown step by step in [See it paid](/zh-CN/getting-started/make-sale.md#paid).

## Gateways with WCPOS Pro[​](#additional-payment-gateways-pro "直接链接到 Gateways with WCPOS Pro")

Pro Feature

Gateways other than Cash and Card require [WCPOS Pro](/zh-CN/getting-started/pro-license.md).

With Pro, any payment gateway installed on your store can be switched on for the till, even one that's off for your website. At the till, each works one of four ways:

* **Recorded at the till.** For cash on delivery, bank transfer and cheque, collect or confirm the payment first, then record it at the till, like Card. You can record it without a connection.
* **Card readers.** **Stripe Terminal** (including Bluetooth readers; Tap to Pay comes in an app update) and **SumUp** take the card on a reader: the till sends the amount to the reader and shows each step. See [On a Card Reader](/zh-CN/sell/take-payment.md#card-reader), and pair a reader from its gateway's page under [Payment Gateways](/zh-CN/settings/checkout/payment-gateways.md).
* **Pay later.** [Email Invoice](/zh-CN/sell/take-payment/email-invoice.md) sends the customer an invoice and leaves the order unpaid until they pay it.
* **Their own payment page.** Every other payment method opens its own payment page on the **Legacy** tab, inside the POS. It takes payment for the whole order, so you can't use it for a [split payment](/zh-CN/sell/take-payment/split-payments.md). See [The Legacy Tab](/zh-CN/sell/take-payment/legacy-tab.md).

Refunds for gateways that support them run on your store, against the payment they apply to. See [Refunds](/zh-CN/manage-store/orders/refund-rules.md).

## Set up payment methods[​](#enabling-and-disabling-gateways "直接链接到 Set up payment methods")

Payment gateways are managed in the WordPress admin:

1. Go to `WP Admin > POS > Settings > Checkout`.
2. You'll see every installed WooCommerce payment gateway.
3. Switch each gateway on or off for the POS, separately from your online store.
4. Drag to reorder. The order of the list is the order of the tiles at the till, and the first available one is selected when checkout opens.

A gateway can be switched on for your website and off for the POS, or the other way round. The gateway's **POS settings** change the title and description the till shows, and the [cash rounding](#cash-rounding) for a cash gateway. See [Checkout Settings](/zh-CN/settings/checkout.md) for every option, including the order status each gateway sets.

提示

The POS reads your payment methods each time it starts. If a gateway you just switched on doesn't appear at checkout, reload the POS.

## Cash rounding[​](#cash-rounding "直接链接到 Cash rounding")

Where small coins are out of circulation, your store can round cash payments to a coin or note you can actually hand over. Rounding is set per cash gateway, so Card and online payments always keep the exact total.

To set it up:

1. Go to `WP Admin > POS > Settings > Checkout`.
2. Open the cash gateway's **⋮** menu and choose **POS settings**.
3. Under **Rounding**, pick an increment: **0.05**, **0.10**, **0.25**, **0.50**, **1**, **5** or **10**. **No rounding** is the default.

The **Rounding** setting appears for Cash and, with Pro, for cash on delivery.

At the till, when the cash you take covers the balance rounded to the nearest increment, the till asks for the rounded amount and shows **Rounded from** with the exact amount under the figure. The difference goes on the order as a fee line named **Rounding**, so the order's total matches the cash in the drawer.

Rounding only applies to the payment that settles the order. A part payment in cash, or a cash payment below the rounded amount, is taken at the exact amount you type. If the payment that settled the order is later voided, the **Rounding** line comes off the order with it.

## Test a gateway[​](#testing-payments "直接链接到 Test a gateway")

Before going live with a new gateway:

1. **Cash** runs the whole checkout without moving any money. The sale is still a real order, so void or refund it afterwards.
2. **Stripe Terminal** offers a [simulated reader](https://docs.stripe.com/terminal/testing) in test mode. Switch on test mode in your Stripe dashboard first.
3. **Other gateways**: check the gateway's own documentation for its sandbox or test mode. Most WooCommerce gateways have a test mode switch.

## When a tile can't be used[​](#unavailable-tiles "直接链接到 When a tile can't be used")

A method that can't take a payment right now isn't shown as a tile. It's folded under a line below the tiles: **Card is not available right now**, or **2 not available right now** when there are several. Tap the line to see each method and its reason, then find the reason below.

<!-- -->

Needs a connection

**Why:** card readers and gateways need your store to be reachable. So does a recorded method that isn't set up to work offline, and so do Cash and Card on an order your store hasn't received yet.

**What to do:** take Cash, Card or another method that works offline, or wait for the connection. See [Offline Mode](/zh-CN/sell/offline-mode.md#what-requires-a-connection).

No terminals set up for *gateway*

**Why:** no terminal for this gateway is online. If your store locks tills to one default terminal, that terminal is offline.

**What to do:** check the terminal is switched on and connected, and registered on the gateway's settings page. See the gateway's page under [Payment Gateways](/zh-CN/settings/checkout/payment-gateways.md).

In use by order #… (Pro)

**Why:** every terminal for this gateway is busy with a payment on another order.

**What to do:** finish or cancel the payment on that order first: open it from [Open Orders](/zh-CN/sell/cart/open-orders.md). When only some terminals are busy, pick a free one.

Update the app to use *gateway*

**Why:** the gateway needs a newer version of WCPOS than the one on this device.

**What to do:** update the app. Until then, use another method.

Only the app's readers are allowed for this payment method

**Why:** the gateway is set to take cards only on a reader paired with the WCPOS app on a phone or tablet (Bluetooth or Tap to Pay). The web and desktop apps can't drive those readers.

**What to do:** allow smart readers on the gateway's WooCommerce settings page so this till can pay on one, or take the payment in the WCPOS app on a phone or tablet. See [Card reader compatibility](/zh-CN/hardware.md#card-reader-compatibility).

Turn on Bluetooth to use the reader

**Why:** Bluetooth is off on this device.

**What to do:** turn Bluetooth on in the device's settings.

Allow access to the reader in app settings

**Why:** WCPOS isn't allowed to use Bluetooth or the reader on this device.

**What to do:** allow it for WCPOS in the device's settings, then come back to checkout.

Sign in to the payment provider

**Why:** the reader's provider needs you signed in on this device.

**What to do:** in the POS, go to **Settings > Card readers** and open the provider's reader settings to sign in.

Takes the whole order, so not once a payment has been taken

**Why:** a gateway that charges the whole order can't be one payment among several.

**What to do:** pay the rest another way, or [cancel the payments taken so far](/zh-CN/sell/take-payment/cancel-payment.md) and take the whole order on that gateway.

If a payment method is missing from both the tiles and this list, see [Gateway not appearing at checkout](#gateway-not-appearing-at-checkout).

## When a card reader payment gets stuck[​](#card-reader-problems "直接链接到 When a card reader payment gets stuck")

Pro Feature

Card readers at the till require [WCPOS Pro](/zh-CN/getting-started/pro-license.md).

While a reader is taking a payment, the tender pane shows the amount, each step (**Sent**, **On terminal**, **Approved**, **Captured**) and what the reader is doing now. Most payments end there. Find the message the till shows below.

<!-- -->

警告

Don't take a payment a second time while the till is still working out what happened to the first. The customer's card may already have been charged.

Authorised, not captured

The customer's card was approved, so the money is held on their card, but the store couldn't collect it. The reason follows the colon.

1. Press **Try capture again**.
2. If it keeps failing, press **Cancel on terminal** to release the hold on the card, and take the payment another way.

Payment confirmation incomplete

A reader paired with this device (Bluetooth or Tap to Pay) finished, but the store hasn't confirmed the payment yet. Press **Check payment again**, and wait until the till says what happened before you do anything else.

An earlier payment attempt on this order has no answer from the provider yet

The till sent a payment to the provider and never heard back, for example because the connection dropped. The store keeps checking and records the payment if the money was taken. Check the provider's dashboard before you take payment again:

* If the dashboard shows the charge, wait: the payment will appear on the order.
* If it shows no charge for this order, press **Clear attempt**, then confirm. Clearing records that nothing was charged. It never refunds or removes a payment, and the order's notes in WooCommerce name you as the cashier who cleared it.

If the store won't clear it yet, it is either still checking with the provider or has found a payment you need to look at. The order's notes in WooCommerce say which. Try again in a few minutes.

Declined, timed out or cancelled on the reader

Press **Try again** or **Choose another way**. To undo a payment that went through, see [Cancelling a Payment](/zh-CN/sell/take-payment/cancel-payment.md).

**Details.** Tap **Details** under the steps to see the payment's log: every step the reader and the store reported, with the reader and action IDs under the first line and the payment ID under the last. A line that went wrong is marked **warn** or **error**. **Copy** (in the browser and on the desktop) or **Share** (on a phone or tablet) sends the whole log on, and **Hide details** folds it away. Include the log with any support request about the payment.

## When an invoice has been sent[​](#invoice-sent "直接链接到 When an invoice has been sent")

When you open checkout on an order whose invoice has gone to the customer, the tender pane says **Invoice sent to** *address* **on** *date*. The order is waiting for the customer to pay it. You can still take payment at the till for the full balance, or send the invoice again from its tile.

To take the invoice back:

1. Press **Cancel invoice**. It needs a connection.
2. The till says **Invoice cancelled. The order is open again.**
3. If the customer still needs to pay by invoice, send it again.

Cancelling doesn't unsend the email: its **Pay for this order** link still takes payment while the order is open. Tell the customer before you take another payment.

If the till says the store did not cancel the invoice, it still stands: check the order before you take another payment. See [Email Invoice](/zh-CN/sell/take-payment/email-invoice.md).

## When the Legacy tab's payment page won't load[​](#legacy-notices "直接链接到 When the Legacy tab's payment page won't load")

信息

Card is on the Legacy tab in every version; Cash is taken on the Payments tab only. Other gateways need [WCPOS Pro](/zh-CN/getting-started/pro-license.md).

The Legacy tab loads a gateway's payment page from your store. If it can't, the tab shows one of the first three messages below. If the gateway turns the payment down, the till shows the fourth as a pop-up.

The payment form didn't load — check the connection to your store, then retry.

Check the connection, then press **Retry**.

The payment form can't load — this order has no payment link from the server yet.

The store hasn't finished creating the order. Close checkout and try again.

The payment page failed to load after processing — close checkout and check the order's status before paying again.

The gateway may have taken the money. Open the order and check its status before you take another payment.

The payment didn't go through, so this sale is not paid. The cart is unchanged.

The gateway turned the payment down, for example a declined card or a missing field, and no money moved. When the gateway gives its own reason, the till shows that instead. Try again or choose another method.

If the page loads but looks or works wrong, see [Gateway displays incorrectly](#gateway-displays-incorrectly).

## If something goes wrong[​](#common-issues "直接链接到 If something goes wrong")

### Gateway not appearing at checkout[​](#gateway-not-appearing-at-checkout "直接链接到 Gateway not appearing at checkout")

* Confirm the gateway is switched on for the 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.
* Look under the tiles for **not available right now**: the method is there with its reason. See [When a tile can't be used](#unavailable-tiles).
* Reload the POS after making changes.

### Gateway displays incorrectly[​](#gateway-displays-incorrectly "直接链接到 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 switch off styles or scripts one by one. See [Checkout Troubleshooting](/zh-CN/troubleshooting/common-problems/checkout-problems.md#checkout-settings-troubleshooting).

### Payment processing fails[​](#payment-processing-fails "直接链接到 Payment processing fails")

* Check your site's error logs (`WP Admin > POS > Support > Logs`) for gateway errors.
* For a card reader, open the payment's [Details](#card-reader-problems) on the tender pane. It shows each step the reader reported.
* Make sure your SSL certificate is valid. Most payment gateways require HTTPS.
* On a staging or local site, confirm the gateway supports test or sandbox mode.

## Payment gateways[​](#custom-gateways "直接链接到 Payment gateways")

Each card reader and gateway built for WCPOS has its own page, with how to install it and pair a reader. Developers can build their own: see [Payment Gateways](/zh-CN/settings/checkout/payment-gateways.md).

[Payment MethodsThe ways your store takes payment at the till: Cash and Card in every store, card readers and other gateways with WCPOS Pro, cash rounding, why a tile can't be used, and what to do when a payment gets stuck.](/zh-CN/settings/checkout/payment-methods.md)

[Payment GatewaysThe WCPOS payment gateways: card terminals, phone payments and invoices. Where each one shows at checkout, how to add one to your store, and what to do when it doesn't show.](/zh-CN/settings/checkout/payment-gateways.md)

[Email NotificationsChoose which WooCommerce emails go out for POS sales: to the admin, to the customer and to the cashier who made the sale.](/zh-CN/settings/checkout/email-notifications.md)

## Related Documentation[​](#related-documentation "直接链接到 Related Documentation")

[CheckoutRing up a sale and take the payment, step by step](/zh-CN/getting-started/make-sale.md)

[Checkout SettingsSwitch gateways on, order them and set each one's order status](/zh-CN/settings/checkout.md)

[Checkout TroubleshootingA tile needs a connection, or the store is slow to answer](/zh-CN/troubleshooting/common-problems/checkout-problems.md)