2021 Q4 Sale BFCM – Free Users Sitewide Banner

  1. Documentation
  2. WooCommerce Payments
  3. WooCommerce Payments FAQs

Getting started with In-Person Payments with WooCommerce Payments

Welcome to In-Person Payments with WooCommerce Payments!

With the launch of In-Person Payments with WooCommerce Payments, we’re excited to have you join us on this journey as we bring tap, swipe, chip card, and mobile wallet payments to your store!

In-Person Payments with WooCommerce Payments is available to qualified US merchants using iPhone, iPad, or Android devices for non-subscription-based products. Support for subscriptions and other countries are coming soon or planned for later this year.

In addition to a device running iOS 14+ or Android 5+, In-Person Payments with WooCommerce Payments requires a BBPOS Chipper 2X BT card reader and a connection to the Internet (WiFi or Cellular) to collect payments. Your store should also have the WooCommerce Payments plugin (version 2.9 or newer) active and connected to a WooCommerce Payments account in good standing.

There are a few things you’ll need to take care of before you can collect your first In-Person Payment.

First, Meet Your Card Reader ↑ Back to top

Your BBPOS Chipper 2X BT card reader is shipped with a partial charge and should be charged before first use. To charge your reader, use the included USB A to Micro B cable to connect the reader to any USB charger. A full charge takes just a few hours.

You should NOT pair the card reader in your phone or tablet’s settings. The WooCommerce Mobile App will take care of communicating with the reader automatically.

Next, Set Up for Delivery or Local Pickup (or Both) ↑ Back to top

You’ll need to decide if you want to deliver to your customers, or if they will be picking up their orders, or both. You’ll then set up Shipping Methods that your customers can choose during checkout.

Option 1: Delivery ↑ Back to top

If you already have shipping set up for delivery, feel free to review or skip this section without making changes.

First, go to WP Admin for your store and click WooCommerce > Settings > Shipping.

If you don’t already have a Shipping Zone that includes delivery, add a new Shipping Zone, and give it a Zone name, e.g. “North End Seattle Metro”:

In Zone regions pick the state you deliver to and then the  specific ZIP Codes:

A screenshot of the Shipping Zone screen showing options for Zone name, Zone regions (that can be more specific via postal codes), and Shipping Methods.

While on this Shipping Zone screen, add a Shipping Method for delivery using the Flat rate method. In this example, we called it “Seattle Metro North End Delivery.

And if you want to support traditional shipping for these nearby customers, don’t forget to add a Shipping Method for that too (see USPS above as an example.) Remember, for customers whose shipping address falls within the shipping zone, only the shipping methods specified for that zone will be visible. 

Don’t forget to click Save changes when you are finished

Option 2: Local Pickup ↑ Back to top

If you already have shipping set up for local delivery, feel free to review or skip this section without making changes.

First, go to WP Admin for your store and click on WooCommerce > Settings > Shipping.

If you don’t already have a Shipping Zone that includes local pickup, add a new Shipping Zone, and give it a Zone name, e.g. “Washington State”:

In Zone regions pick the state that you want to offer local pickup for and then, optionally, the specific ZIP Codes (or allow any ZIP code in your state if you prefer):

While on this Shipping Zone screen, add a Shipping Method for local pickup using the Local pickup method. In this example, we called it “Local Pickup (Free!)”

An additional screenshot of the Shipping Zones screen. Two Shipping Methods are shown: Pickup in store (Free), and USPS.

And if you want to support traditional shipping for these nearby customers, don’t forget to add a Shipping Method for that too (see USPS above as an example.) Remember, for customers whose shipping address falls within the shipping zone, only the shipping methods specified for that zone will be visible. 

Don’t forget to click Save changes when you are finished

Option 3: Both Delivery AND Local Pickup ↑ Back to top

If you already have shipping set up for delivery and local pickup, feel free to review or skip this section without making changes.

First, go to WP Admin for your store and click on WooCommerce > Settings > Shipping.

If you don’t already have a Shipping Zone that includes delivery and local pickup, add a new Shipping Zone, and give it a Zone name, e.g. “North End Seattle Metro”:

In Zone regions pick the state that you want to offer local pickup for (in this example, Washington State) and then the specific ZIP Codes to which you deliver.

While on this Shipping Zone screen, add a Shipping Method for delivery using the Flat rate method. In this example, we called it “Seattle Metro North End Delivery.”

And then add another Shipping Method for local pickup using the Local pickup method. In this example, we called it “Local Pickup (Free!)”

And if you want to support traditional shipping for these nearby customers, don’t forget to add a Shipping Method for that too (see USPS below as an example.) Remember, for customers whose shipping address falls within the shipping zone, only the shipping methods specified for that zone will be visible. 

When you’re done it should look something like this:

A third screenshot of the Shipping Zone screen, showing yet another Shipping method has been added, this time the Seattle Metro North End Delivery.

Don’t forget to click Save changes when you are finished

For more information on setting up Shipping Zones see https://docs.woocommerce.com/document/setting-up-shipping-zones 

Next, Add a Cash on Delivery Payment Method ↑ Back to top

You’ve already got the WooCommerce Payments Payment Method setup on your store to allow your customers to enter their card information on your website to complete checkout. But for In-Person Payments, you’ll also need to add another payment method: Cash on Delivery.

Don’t worry about the word “Cash” there – we’ll fix that in the next few steps.

To do so, go to WP Admin for your store and click on WooCommerce > Settings > Payments All Payment Methods:

Showing the Payments tab that is accessible via WooCommerce > Settings > Payments > All payment methods.

Next, enable Cash on delivery:

Highlighting the Cash on delivery payment method under the Payments tab in WooCommerce Settings.

Then click on Manage to access the settings for Cash on delivery. We recommend changing the name to something like “Pay on Delivery” or “Pay in Person” depending on your business, e.g.:

A detailed view of the Cash on delivery payment method. Sowing the Enable/Disable checkbox setting, and title, description, instruction, Enable for shipping methods text fields, and the Accept for virtual orders checkbox setting.

Note that you can limit Cash on delivery to selected Shipping Methods like those we set up earlier. This way your customers will only see the Cash on delivery Payment Method only if they qualify for those Shipping Methods. Just select those Shipping Methods in the Enable for shipping methods box (see above.)

Lastly, Update Your Privacy Policy ↑ Back to top

Like any Payment Method, customers using In-Person Payments should be aware of what data is shared about them and their transactions with others. Customers using card-present-payments can expect to have the following personal data shared with our partner Stripe:

  • their location at the time and date of purchase
  • their email address
  • their name
  • a Stripe assigned customer ID if the buyer has prior payments for this store
  • the buyer’s address and phone number
  • the quantity, price, and description of items in the order

All this data is used to support fraud detection during payment collection.

More details on privacy on our products can be found here: https://automattic.com/privacy/ 

To manage your store’s privacy policy, go to WP Admin for your store and click on Settings > Privacy.

Getting Started: Testing Your Reader Connection ↑ Back to top

Give your card reader a good charge before proceeding. To do so, connect the Micro USB connector on the reader using the supplied cable to a USB charger. While charging, the reader power LED will alternate between red and magenta. Once fully charged, the reader can process hundreds of transactions before needing a recharge.

The next step is to connect your card reader to your mobile device for the first time. To do so, in the WooCommerce Mobile App, got to Settings (gear icon) > In-Person Payments:

The Settings screen within the WooCommerce app with emphasis on the Store Settings > In-person Payments option.

Then, on the In-Person Payments screen, look for Manage card reader and tap on it, i.e.:

Showing the specific screen for In-Person Payments in the WooCommerce app, with emphasis on the Manage card reader setting option.

If you don’t see the Manage card reader item, your store may not be properly gated into the In-Person Payments. Contact support so that we can sort it out by navigating to the main screen in the WooCommerce Mobile App, and going to Settings (gear icon) > Help & Support > Contact Support.

When you see the Connect your card reader screen, tap on Connect Card Reader, e.g.:

A screenshot of the Connect your card reader screen. Emphasis on the button labeled Connect Card Reader.

You should be prompted that Woo Would Like to Use Bluetooth – tap OK to allow it.

Scanning will commence:


Press and briefly hold (a second or so) the power button on your reader to turn it on and keep it near the mobile device.

After a few seconds, you’ll see the Do you want to connect… prompt with your reader’s serial number. Tap Connect to Reader to begin the connection process, e.g.:

You should see the Allow Woo to Use Your Location prompt. Tap to Allow While Using App.

After a second or less, you’ll see the connected reader and its battery status. That’s it – your reader is now connected and ready to accept payments.

If you’re having trouble getting your site connected to the WooCommerce Mobile App, please make sure your site is connected to a WordPress.com account through the Jetpack plugin and no error is reported there.

Collect Payment for an Order ↑ Back to top

Enter Orders and browse orders in the Processing state. Orders created with the Cash on Delivery Payment Method are initially in the Processing state.

Tap on an order from the list, e.g.:


Scroll down to the Payment section and tap on the Collect Payment button, e.g.:


You’ll be prompted to connect your card reader if it isn’t already connected. Tap on Connect Card Reader, wait for the reader to be found, and then tap on Connect to Reader to complete the connection.

Now, you should be prompted to Collect payment from your customer. Have your customer insert their chip card, or swipe their older non-chip card. Newer cards that support tap-and-pay can be simply tapped to the reader. The reader also supports NFC wallets for mobile devices including, for example, wallets on Apple and Google mobile devices.


If a chip card was inserted, remove the card from the reader when prompted.

Wait for the payment to be processed. This can take up to 10 seconds or more.

On success, on iPhones you should hear a sound and feel a haptic vibration. On an iPad and Android devices, you will hear a sound.

Now, you should be prompted to print or email a receipt (or No thanks to doing neither). You can also print a receipt later.

Collect Simple Payments On The Go ↑ Back to top

As an In-Person Payment merchant, you may need to collect an arbitrary amount at any given time. For these situations, there is an experimental feature called Simple Payments. You can enable it by navigating into Settings -> Experimental Features.

Enter the desired amount and tap the Done button to create the order whose payment can be collected by following the steps listed in the Collect Payment for an Order section.

Receipt Printing ↑ Back to top

As an In-Person Payments merchant, you are obligated to provide your customers the option of a printed receipt for any payment.

Printing Receipts to a Printer Accessible via the Same WiFi Network ↑ Back to top

If your mobile device has access to a WiFi Network, e.g. for curbside payments or point-of-sale type payments, you should be able to print any printer accessible via that WiFi network using AirPrint (iOS) or Mopria (Android). 

Android users should note that for some printers (including the Brother RJ-4250WB-L and many others), you may need to install additional software like, for example, the Brother Print Service Plugin – see https://play.google.com/store/apps/details?id=com.brother.printservice&hl=en&gl=US )

Printing Receipts to a Portable WiFi Direct Printer (e.g. Brother RJ-4250WB-L or similar) ↑ Back to top

WiFi Direct printers like the Brother RJ-4250WB-L have their own internal WiFi access point/hotspot that a mobile device can connect to directly for printing receipts.

If you have access to a WiFi Direct Printer like the Brother RJ-4250, ensure your mobile device has access to cellular data and then connect to the printer WiFi using your device’s WiFi settings. In the case of a RJ-4250WB, the printer will have 4250WB in its SSID and the password is 425 followed by the last 5 digits of the serial number, e.g. 42533007.

You can then accept payments (over cellular data) and print receipts (over WiFi Direct). This can be especially useful for in-person delivery at a customer’s home.

Some printers, like the Brother RJ-4250WB-L can be used both with a traditional WiFi network AND with WiFi Direct. This is great for maximizing the use of a somewhat expensive printer like the Brother RuggedJet. Android users may also be able to connect to printers, like the Brother RJ-4250WB-L, using Bluetooth as a third option.

The idea is that, when you have your printer at their place of business, it can be accessed like any other printer on their WiFi network.  But when you take the printer somewhere else, like a customer’s home or trade show, the WiFi Direct mode takes precedence.

For the Brother RJ-4250WB-L, a special Windows-based Printer Setting Tool is needed to set up the WiFi network SSID and password. To get this tool

  • Visit https://support.brother.com/g/b/downloadtop.aspx?c=eu_ot&lang=en&prod=rj4250wbeuk 
  • Click on Windows for OS Family and then choose your OS (e.g. Windows 10 (64-bit))
  • To the right of “Software/Document Installer” click on “Click to choose” and choose your preferred language.
  • Agree to the EULA, download and run the installer
  • Connect the RJ-4250WB-L to your computer using a USB “Mini-B” cable. The port is near the paper opening button:
  • After installation completes, launch the Printer Setting Tool, connect to your RJ-4250 over USB, and click on Communication Settings
  • Switch to the Wireless LAN tab, then pick Wireless Settings. Enter (or search for) your wireless network and give its passphrase. Hit Apply to send the settings to the printer.
  • Lastly, on the printer itself:
    • Press the Menu (down arrow) button until you see WLAN
    • Press the OK button
    • Press the Menu (down arrow) button until you see Mode
    • Press the OK button
    • The Menu (down arrow) button until you see Direct/Infra
    • Press the OK button
  • Your printer should now be able to function both on your WiFi network (Infra) and off network (Direct).

Viewing Transactions in WP ADMIN ↑ Back to top

Payments collected using In-Person Payments appear in your Dashboard just like payments collected using WooCommerce Payments online. You can find them in WP Admin under Payments > Transactions.

Powering Off Your Reader ↑ Back to top

If you ever want to power off your reader (e.g. to save battery life), hold down the power button for about 4 seconds. The light will go off and stay off.

When not in use, the reader will power off automatically after a few minutes to conserve power. To turn it back on, simply press the power button.

Refunds ↑ Back to top

You can refund your customers In-Person Payment just as you would any other WooCommerce Payments payment. Simply follow the refund flow on their order in the app or on your site via WP Admin. When refunding orders via WP Admin, be sure to select Refund $x.xx via WooCommerce Payments (avoid using the Refund $x.xx Manually button as this button does NOT refund the customer’s money automatically through WooCommerce Payments – see Manual Refunds for more information.)

Authorizations and Captures ↑ Back to top

If you have enabled Issue an authorization on checkout, and capture later in Settings (this is disabled by default – see image below) it is important to capture in-person payments right away. A best practice is to capture all in-person authorizations at the end of the business day.

Note: Unlike online payments (which allow 7 days to capture), in-person payment authorizations must be captured within 2 days or the authorization and order will be cancelled.

FAQ ↑ Back to top

Does In-Person Payments work with Test Mode enabled on WooCommerce Payments? ↑ Back to top

No. In-Person Payments is not compatible with Test Mode. You should ensure that Test Mode is NOT enabled in WP ADMIN under WooCommerce > Settings > WooCommerce Payments.

Does my mobile device need an Internet connection in order to collect payments? ↑ Back to top

Yes. Your mobile device needs to be connected to the Internet to collect payments. If using cellular (e.g. for delivery), be sure Cellular Data is enabled for the “Woo” application in your iPhone or iPad’s Cellular Settings.

What cards and Digital Wallets are supported? ↑ Back to top

In addition to most credit and debit cards, we also support in-person payments using Apple Wallet, Google Wallet, Samsung Pay, VISA payWave, MasterCard PayPass, AMEX ExpressPay, and Discover D-PAS.

Can I use In-Person Payments for my subscription-based products? ↑ Back to top

No, not at this time. Support for subscriptions products will be coming in a future release.

Can I bring my own Card Reader? ↑ Back to top

No, In-Person Payments only works with a card reader purchased via WooCommerce.com

What is the minimum version of the WooCommerce Mobile App I need on my mobile device for In-Person Payments? ↑ Back to top

Version 7.0 for iOS and version 7.1 for Android.

What is the Card Reader Return Policy? ↑ Back to top

Refer to the WooCommerce Payments Card Reader Return Policy for more information.

WooCommerce - the most customizable eCommerce platform for building your online business.

  • 30 day money back guarantee
  • Support teams across the world
  • Safe & Secure online payment