# Payment Gateways

**WP admin:** each gateway is a plugin you install in WordPress and turn on in `WP Admin → POS → Settings → Checkout`.

A payment gateway adds a way to pay at the till: a card terminal on the counter, a payment from the customer's phone, or an invoice they pay later. Each one is a WordPress plugin from WCPOS that you add to your store. To go straight to yours, see [Choose a gateway](#gateways).

For a customer who wants to pay with a method your online store offers, see [Web Checkout](/sell/take-payment/web-checkout.md); for Cash, Card and the other ways the till takes payment, see [Payment Methods](/settings/checkout/payment-methods.md).

Pro Feature

Gateways need [WCPOS Pro](/getting-started/pro-license.md). Without it, the till takes **Cash** and **Card** only.

## Where a gateway shows at checkout[​](#at-the-till "Direct link to Where a gateway shows at checkout")

Press **Checkout** and the tender pane opens on **Payments**. A gateway marked **Payments** in the [list below](#gateways) gets its own tile there, next to **Cash** and **Card**.

![The tender pane on the Payments tab: the Payments and Legacy tabs, the Cash and Card tiles, the amount to pay and the Take button](/img/2.x/payment/gateways/index/en/tablet-light-regular--gw-1-payments-tab.png)1234

1. **Payments** — the tender pane. Every payment method with a tile is here. See [The Tender Pane](/sell/take-payment/payment-screen.md).
2. **Cash** — counts the change for you. Comes with every store.
3. **Card** — for a card machine that isn't connected to the POS: take the card on the machine, then record it here. Comes with every store.
4. **Legacy** — gateways that run on their own payment page. See [The Legacy Tab](/sell/take-payment/legacy-tab.md).

Gateway tiles sit in the order set in [Checkout Settings](/settings/checkout.md#reordering-gateways). A tile the till can't use right now folds into a line under the tiles: **Stripe Terminal is not available right now**, or **2 not available right now** for more than one. Tap the line to see why.

WooCommerce's cash on delivery, bank transfer and cheque gateways get a tile too: you record them at the till, like **Card**. See [Payment Methods at the Till](/sell/take-payment/payment-screen.md). Any other gateway is on the **Legacy** tab, which opens your store's own pay page for the order inside the POS. A Legacy gateway takes the whole order, so it can't be one part of a [split payment](/sell/take-payment/split-payments.md).

Taking a payment on the Legacy tab

![The Legacy tab: the gateway's own payment page listing the gateways enabled for the POS, and the Process Payment button](/img/2.x/payment/gateways/index/en/tablet-light-regular--gw-2-legacy-tab.png)123

1. **Legacy** — the tab is always there. With no gateway to offer, it says so.
2. **Payment page** — your store's own pay page for this order. Choose the gateway and fill in what it asks for.
3. **Process Payment** — sends the payment to the gateway.

## Choose a gateway[​](#gateways "Direct link to Choose a gateway")

### Card terminals[​](#hardware-terminal-gateways "Direct link to Card terminals")

The customer taps, inserts or swipes a card on a terminal from your payment provider. The till sends the amount to the terminal and records the payment when the provider confirms it.

| Gateway                                                                                       | At checkout           |
| --------------------------------------------------------------------------------------------- | --------------------- |
| [Stripe Terminal](/hardware/card-readers/stripe-terminal.md)                                  | Payments, 2.0+        |
| [SumUp Terminal](/hardware/card-readers/sumup.md)                                             | Payments, 2.0+        |
| [Mollie Terminal](/hardware/card-readers/mollie.md)                                           | Payments, 2.0+        |
| [Square Terminal](/hardware/card-readers/square-terminal.md)                                  | Payments, 1.0+        |
| [Mercado Pago Terminal](/hardware/card-readers/mercado-pago.md) (Point Smart)                 | Payments, 1.0+        |
| [Windcave Terminal](/hardware/card-readers/windcave.md)                                       | Payments, 1.0+        |
| [PayArc Terminal](/hardware/card-readers/payarc.md) (PAX)                                     | Payments, 1.0+        |
| [Authorize.net Tap to Pay](/hardware/card-readers/authorize-net.md) (Authorize.net phone app) | Payments, 0.1.0+      |
| [PayPal Reader (Zettle)](/hardware/card-readers/paypal-zettle.md)                             | Legacy, every version |

Authorize.net Tap to Pay is the exception: you type the amount into Authorize.net's own phone app, and the till records the payment when your store finds it.

The number is the oldest version of the gateway plugin that has a tile. An older version is on the **Legacy** tab. Which readers work on which device is on [Card reader compatibility](/hardware.md#card-reader-compatibility).

### Phone payments[​](#mobile-payment-gateways "Direct link to Phone payments")

* **[Vipps MobilePay](/sell/take-payment/vipps-mobilepay.md)** — the customer scans a QR code on screen, or confirms a request on their phone, in the Vipps or MobilePay app. On the **Legacy** tab.

### Pay later[​](#digital-payment-gateways "Direct link to Pay later")

The order is saved unpaid, and the customer pays it online afterwards.

* **[Email Invoice](/sell/take-payment/email-invoice.md)** — the customer gets an email with a link to pay the order. On the **Payments** tab from version 0.1.0; an older version is on **Legacy**.
* **[Web Checkout](/sell/take-payment/web-checkout.md)** — the customer pays on your web store's checkout. On the **Legacy** tab.

## Add a gateway to your store[​](#install "Direct link to Add a gateway to your store")

You do this once, in WordPress, as the store owner: install the gateway, connect your account, turn it on for the POS, then reload the POS. Each gateway's page has its own settings.

Store owner: install, enable or fix a greyed-out gateway

1. **Install it.** In `WP Admin > POS > Settings > Extensions`, find the gateway, press **Install**, then **Activate**. Or download the plugin zip from the gateway's GitHub releases page and upload it in `Plugins > Add Plugin`, then **Upload Plugin**. Web Checkout isn't in the Extensions list, so it's always a zip. See [Extensions](/manage-store/add-ons.md#installing-an-extension).
2. **Connect your account.** Open the gateway in `WP Admin > WooCommerce > Settings > Payments` and enter the keys from your payment provider. If the gateway has a test mode, take a test payment before going live.
3. **Turn it on for the POS.** In `WP Admin > POS > Settings > Checkout`, switch on **Enabled** for the gateway, and drag it to where you want its tile. It doesn't have to be switched on for your web store. See [Checkout Settings](/settings/checkout.md#enabling-a-gateway).
4. **Reload the POS.** The till reads your payment methods each time it starts.

**Install is greyed out, with Requires Pro to install.** Installing from **Extensions** needs WCPOS Pro.

**The Enabled switch is greyed out.** Every gateway but Cash and Card needs WCPOS Pro, activated with your licence key. See [Pro License](/getting-started/pro-license.md).

## If something goes wrong[​](#goes-wrong "Direct link to If something goes wrong")

**The gateway isn't at checkout.** Look on the **Legacy** tab first. If it isn't there either, check that **Enabled** is on in Checkout Settings, then reload the POS. If the switch is greyed out, open **Store owner: install, enable or fix a greyed-out gateway** under [Add a gateway to your store](#install).

**It's on the Legacy tab, not a tile.** That's where PayPal Reader, Vipps MobilePay and Web Checkout always go. For a terminal [listed above](#hardware-terminal-gateways) with a version, check the installed version against the table. If it's older, update it: its card in **Extensions** shows **Update available** when there's a newer one.

**The tile is under "not available right now".** Tap the line: each gateway shows why, such as **Needs a connection** while you're offline. Finish the sale with another method meanwhile.

**A payment fails.** If the till names **PAYMENT301**, the store refused the gateway: it isn't enabled for the POS, or it's gone. See [PAYMENT301](/error-codes/PAYMENT301.md). A failure on the terminal or at the provider is on the gateway's own page, with its error messages and fixes. To report a fault, see [Support](/troubleshooting/contact-support.md).

### Build your own gateway[​](#creating-your-own-gateway "Direct link to Build your own gateway")

For developers: any WooCommerce payment plugin can be wrapped for the POS. Start from the [Gateway Template](/developers/gateway-template.md).

## Related Documentation[​](#related-documentation "Direct link to Related Documentation")

[Payment MethodsCash, Card and every other way your store takes payment](/settings/checkout/payment-methods.md)

[Checkout SettingsTurn gateways on for the POS and set their order](/settings/checkout.md)

[ExtensionsInstall, activate and update gateways from WordPress](/manage-store/add-ons.md)
