Skip to main content

Get Help With Your Card Reader

Get answers to frequently asked questions and common troubleshooting steps for your Toast Tap™ (Direct Attach), Toast Tap™ (On-Counter), and

Written by Agent Support Bot

If your Toast Tap™ card reader is not working, keeps disconnecting, or is forcing manual card entry, run these troubleshooting steps before contacting Customer Care.

Before You Begin

Applies to: Toast Tap™ (Direct Attach), Toast Tap™ (On-Counter), Toast Flex terminal

Permissions needed:

  • Device administrator access on the Toast Flex terminal

  • Toast POS app credentials

What you'll accomplish: Restore card reader functionality so your Toast Tap™ can accept tap, dip, and swipe payments through the Toast POS app.

Different reader? This article only covers Toast Tap™ readers used with the Toast Flex terminal. If you have a different device, use the right guide:

Note: Before troubleshooting, verify your Toast Flex terminal is online and connected to your Toast Network. A dropped internet connection often looks like a card reader problem. See Verify Your Internet Connection for more details.

Note: You can never have an eDynamo (chip) reader and a Toast Tap™ connected to the same terminal at the same time. If you installed your Toast Tap™ by removing an eDynamo or ICMP chip reader, see Manager Swipe Cards Not Working After Installation for a related step you may need to complete.

Quick Fix

Match your symptom in the table below. If the quick fix doesn't resolve the issue, jump to the linked step for the full procedure.

Symptom

Most Common Cause

Quick Fix

Self-Service?

Card reader not working at all (no lights, no response)

Reader unplugged, loose USB connection, or USB damage

Reseat the USB cable; check for the green pinhole power light; if no lights at all, swap to a different USB port

Yes — see Step 2 and Step 5

Forced to manually enter card numbers on every payment

Reader is not connected to the Toast POS app

Power cycle the terminal; force-close and reopen the Toast POS app

Yes — see Step 1

Tap or dip payments fail; swipe still works

EMV is not enabled in Device Setup

Enable EMV Enabled in Device Setup

Yes — see Step 6

Card reader test passes but real payments fail in the Toast POS app

Card Reader Support app left open in the background

Force-close the Card Reader Support app

Yes — see Step 3

Reader was working, suddenly keeps disconnecting

Internet drop, USB power issue, or device queue timeout

Verify internet connection; check Device Status > Queues for timeout errors

Yes — see Step 1

"Looking for Card Reader Upgrades" message keeps appearing

A pending firmware update is in progress

Verify device settings in the Device Status menu

"Remove Card From Card Reader" message repeats

Reader's internal connection cable may need reseating

Run all standard troubleshooting steps; if persistent, the internal cable may need reseating — contact Customer Care

Tap payment fails and the guest is prompted to swipe instead

Fast Processing is enabled in Payment Options

Switch Background Processing to Yes, Offline Mode

Yes — see Step 7

EMV update keeps failing when enabling EMV Enabled

Network firewall is blocking the card reader firmware server

Whitelist tms.bbpos.com, or try a different network

Yes — see Step 5

Manager swipe cards stopped working after Toast Tap™ was installed

An eDynamo or ICMP chip reader was removed during installation

Re-register manager swipe cards

Card reader is physically damaged or USB connector is bent

Hardware failure

Stop troubleshooting; contact Customer Care for warranty replacement

Video demonstration of card reader troubleshooting steps.

Step 1: Power Cycle

Power cycling the terminal or printer that the card reader is plugged into is the fastest way to fix most card reader issues. Always try this first if your card reader is not accepting payments.

For card readers plugged directly into the Toast Flex terminal:

  1. Press and hold the power button on the Toast Flex terminal until the device turns off.

  2. Wait 30 seconds.

  3. Press and hold the power button again to restart the terminal.

  4. Open the Toast POS app and run a test card payment.

For Toast Tap™ (On-Counter) readers plugged into a Toast Printer:

  1. Unplug the printer power cord from the wall.

  2. Wait 30 seconds.

  3. Plug the printer power cord back in and press the printer's power button.

  4. Open the Toast POS app and run a test card payment.

Note: Check the Toast Tap™ for a small pinhole light near the cable connection. A blinking blue light means the reader is powered on but not yet ready to accept a payment; a solid blue light means the reader is ready. If you see no light at all, the reader may not be receiving power — go to Step 4: Swap USB Ports.

Expected outcome: The Toast POS app accepts a credit card payment via tap, dip, or swipe.

If the reader still does not work, continue to Step 2: Run a Test.

Step 2: Run a Test

The Card Reader Support app on your Toast Flex terminal lets you test tap, dip, and swipe payments without charging a card. Use it to confirm whether the reader hardware is working. If this is a Dual Card Reader setup, please remove the card reader that is not being tested before proceeding.

  1. Exit Toast App

  2. Open the Card Reader Support app from the Home Screen.

    1. For devices with Launcher, navigate to Use Toast Launcher for navigation

    2. For devices using Locktask, unlock the device shown in Use Kiosk Mode on Your Terminal, then navigate the same as with Launcher.

  3. Wait for the app to initialize the card reader. Does it innitialize?

    1. "Error USB_DEVICE_NOT_FOUND" Go to Step 4

    2. USB Status: Connected: Continue below

  4. Select each of the three buttons at the top — NFC (tap), Insert (dip), and Swipe — one at a time. Run a test payment with each method using a credit or debit card. The card will not be charged. Use a card that is NFC-enabled (look for the sound wave icon) for the tap test.

  5. If one or more tests fail, repeat the test with a different credit or debit card.

  6. If the reader continues to fail any test, see Before You Contact Customer Care.

  7. Force-close the Card Reader Support app: select the gray square at the bottom of your device's screen and swipe up on the Card Reader Support window to close it.

gif showing how to forced quit an app

Important: If you don't force-close the Card Reader Support app, the card reader will not function within the Toast POS app.

  1. Open the Toast POS app and attempt another credit card payment.

Expected outcome: All three test payment methods (NFC, Insert, Swipe) show as successful in the Card Reader Support app, and the Toast POS app accepts a real credit card payment.

If the credit card payment does not register in the Toast POS app, continue to Step 3: Clear the Cache.

Step 3: Clear the Cache

Clearing the cache forces the Toast POS app to reload its connection to the card reader.

  1. Select the gray circle at the bottom of your device's screen and open the Clear Cache shortcut.

    1. For devices with Launcher go Use Toast Launcher for navigation

    2. For devices using Locktask, unlock device shown in Use Kiosk Mode on Your Terminal, then navigate the same as with Launcher.

  2. Select Clear Cache.

  3. Select the gray square at the bottom of your device's screen and swipe up on the Clear Cache window to close it.

  4. Open the Toast POS app and attempt another credit card payment.

Note: For a more thorough cache clear, you can navigate to Settings > Apps > Toast POS > Storage and select Clear Cache.

Expected outcome: The Toast POS app accepts a credit card payment via tap, dip, or swipe.

If the card reader still does not work, continue to Step 4: Swap USB Ports.

Step 4: Swap USB Ports

Switching the card reader to a different USB port on the Toast Flex terminal can resolve issues caused by a bad port or loose connection.

  1. If the Toast Tap™ is screwed in, carefully unscrew it. Otherwise, unplug the card reader from its USB port.

  2. The Toast Flex terminal has several USB ports on the top, left, and right sides. Choose an available port. You may need to remove a small cover plate.

  3. Plug the Micro-USB or USB cable from the Toast Tap™ firmly into the new USB port.

  4. If the cable has a mounting plate, screw it securely to the terminal or guest-facing display so the connection stays stable.

  5. For Toast Tap™ (On-Counter): also confirm that the cable is securely plugged into the port on the bottom of the Toast Tap™ device itself.

  6. Open the Card Reader Support app and run a test payment by tapping, dipping, and swiping a credit card.

Note: For Toast Tap™ (On-Counter), if the problem continues, and if this is currently plugged into the printer, try using the micro USB to micro USB cable that comes with the Toast Tap to plug into the Terminal or Guest Facing Display.

Expected outcome: The card reader is recognized in the new port and successfully passes a test payment.

If the reader shows a solid blue light but still fails the test, repeat the steps in any other available USB port you have not yet tried. Systematically checking each port helps identify whether a specific port is the problem. If all ports fail, continue to Step 5: Verify EMV Is Enabled.

Step 5: Verify EMV Is Enabled

EMV must be enabled to accept chip and dip payments. If tap or dip payments fail but swipe works, EMV is likely disabled.

  1. In the Toast POS app, select the arrow in the upper-left corner until you reach the main menu.

  2. Scroll down and select Device Setup.

  3. Locate and select the EMV Enabled setting near the bottom of the page.

  4. If EMV Enabled is not already set to Yes, select Yes and then select Continue. Download an update if prompted.

  5. Select the arrow in the upper-left corner to return to a service mode.

  6. Attempt another credit card payment in the Toast POS app.

Verify your hardware is recognized: While in Device Setup, scroll to Card Readers. Your Toast Tap™ should appear as BBPOS Chipper 2X(USB) — its official model name. If you're using a Guest-Facing Display or a Toast Flex for Guest with a swipe-only reader, the BBPOS Chipper 2X(USB) will show under Guest Pay instead.

If payment still isn't working after enabling EMV: Select the Toast Tap™ under Card Readers and select Remove Reader. Scroll down and confirm you still see BBPOS Chipper 2X(USB) listed. This will automatically turn EMV back off. Return to Device Setup and turn EMV Enabled back on, then run another test payment.

Note: If the EMV update keeps failing while you're trying to enable it, this is usually related to your network's firewall. Confirm your firewall allows outbound access to tms.bbpos.com and try again. If the update still fails, connect the terminal to a different network — for example, disconnect the Ethernet cable and connect to a personal phone hotspot over WiFi — and retry the update. If the problem continues, contact Customer Care.

Expected outcome: Chip and tap payments succeed in the Toast POS app.

If the credit card payment does not register, continue to Step 6: Reset USB Detection.

Step 6: Reset USB Detection

If the card reader still doesn't work after a port swap, reset USB detection on the terminal.

  1. Navigate to Settings > About Device > USB Detection.

  2. Select Reset All.

  3. Restart the Toast Flex terminal.

  4. After the terminal restarts, test the card reader functionality with a real credit card payment.

Expected outcome: The Toast Flex terminal recognizes the card reader and processes a payment successfully.

If the card reader still does not work, see Persistent Connection or Repeated Errors and Before You Contact Customer Care.

Step 7: Fix Tap Payments That Prompt for a Swipe

If tap payments never succeed and always prompt the guest to swipe instead, this is usually a payment setting rather than a hardware issue. Check whether Fast Processing is enabled.

  1. In Toast's back-end (Toast Web), navigate to Payments > Payment Options.

  2. Scroll to the Credit section and check whether Enable Background Processing is set to Yes, Fast Processing.

  3. If it is, change it to Yes, Offline Mode.

  4. Select Save and then Publish.

Note: Yes, Offline Mode is the recommended setting. It allows the terminal to accept credit card payments even when a connection is temporarily unavailable, queuing transactions to process in the background once the device reconnects. If you don't have the Offline/Background Credit Card Processing permission, you'll need a manager to approve the change.

Expected outcome: Tap payments complete successfully in the Toast POS app instead of prompting the guest to swipe.

If tap payments still fail after this change, return to Step 1: Power Cycle and work through the remaining hardware troubleshooting steps.

Manager Swipe Cards Not Working After Installation

If you removed a chip card reader (also known as an eDynamo or ICMP reader) to install your Toast Tap™, the Toast system will no longer recognize your existing manager swipe cards. Reprogram your manager swipe cards using the steps below.

Note: If your previous card reader was a swipe-only card reader (also known as a magnetic stripe reader), the Toast system will recognize your manager swipe cards automatically and no action is necessary.

Register Swipe Card is a manager-level permission. You may need to review your manager permissions or contact your restaurant administrator to gain access to this permission.

  1. Select Register Swipe Card from the main Toast POS dashboard.

  2. Locate and select the employee who needs to register a card.

  3. Select the +Add button in the top right corner and swipe the card through the credit card reader attached to the Toast device. Make sure the stripe is facing toward the top of the reader when you swipe.

  4. Select Done.

Expected outcome: The employee can now swipe their card to log in.

Persistent Connection or Repeated Errors

Some card reader problems point to a hardware or firmware issue that the standard troubleshooting steps cannot fix. Use this section to identify your scenario.

Card Reader Intermittently Disconnects

If the card reader disconnects intermittently but passes initial tests, the problem is usually the USB port, the cable, or an internet drop.

"Remove Card From Card Reader" Repeats

If the Remove Card From Card Reader prompt repeats:

  • Inspect and clean the card reader of any debris

  • Complete the basic troubleshooting steps above (Step 1 through Step 6).

"Looking for Card Reader Upgrades" Error

If you see the Looking for Card Reader Upgrades error:

  • Verify your device settings in the Device Status menu.

  • A BBPOS firmware update may be in progress on your reader. If the update has failed, power cycle the terminal and try again. See BBPOS Card Reader Firmware Updates.

  • If the update continues to fail or the error persists after a power cycle, contact Customer Care.

Frequently Asked Questions

Why is my card reader not working?

Card readers usually stop working for one of three reasons: a loose USB connection, a software issue in the Toast POS app, or a hardware failure. Start with Step 1: Power Cycle and work through the steps in order. If the reader fails the Card Reader Support app test, the reader hardware is broken and needs to be replaced.

Why is my Toast Tap™ forcing me to manually enter card numbers?

Forced manual entry usually means the Toast POS app cannot detect the card reader. Power cycle the Toast Flex terminal (see Step 1) and force-close any open apps including Card Reader Support (see Step 2). If manual entry continues, run through the rest of the troubleshooting steps.

My card reader test passes, but real payments still fail. What's wrong?

If the Card Reader Support app test passes but the Toast POS app still fails to take payments, the Card Reader Support app is most likely still open in the background. Force-close the Card Reader Support app, then attempt a payment again. See Step 2: Run a Test for the close procedure.

Does this article cover Toast Go® card readers?

No. This article covers Toast Tap™ (Direct Attach) and Toast Tap™ (On-Counter) readers used with the Toast Flex terminal. For Toast Go® handheld card readers, see Toast Go® 2 Card Reader Not Working or Get Help With Your Toast Go® 2 Handheld.

Can I troubleshoot a Guest Pay or dual reader setup with this article?

This article covers single-reader troubleshooting. For Guest Pay and dual reader functionality, see Guest Pay and Dual Reader Functionality with Toast Tap™.

Why is my guest being prompted to dip instead of swipe?

Guests paying with a chip card are prompted to dip by default, since dipping reads the chip's unique one-time code and is the most secure transaction type for both you and your guest. This is expected behavior, not an error. If the Toast Tap™ can't read the chip after two unsuccessful dip attempts — often because the chip is dirty or damaged — the Toast system automatically prompts the guest to swipe instead.

Does pre-authorization work with tap or dip payments?

No. Pre-authorization only works when a card is swiped. Tap and dip transactions do not support pre-authorization.

Can I have two EMV card readers connected at the same time?

No. You can never have an eDynamo (chip) reader and a Toast Tap™ connected to the same terminal at the same time.

Why aren't my manager swipe cards working after installing Toast Tap™?

If you removed an eDynamo or ICMP chip reader to install your Toast Tap™, existing manager swipe cards need to be re-registered. See Manager Swipe Cards Not Working After Installation for the steps.

Why do my tap payments keep failing and asking me to swipe?

This is usually caused by the Fast Processing setting being enabled in Payment Options rather than a hardware problem. See Step 7: Fix Tap Payments That Prompt for a Swipe to switch to Offline Mode.

Before You Contact Customer Care

If you've completed Steps 1 through 7 and your card reader still does not work — or if any of the following apply — contact Customer Care for hardware replacement options:

  • The USB connector on the card reader is bent or broken.

  • The card reader has no power light in any USB port.

  • The Card Reader Support app test fails on multiple cards in multiple ports.

  • The card reader was working previously and has now physically failed (overheating, melted connector, no response).

Have the following ready when you contact Customer Care:

  • The card reader serial number (printed on a label on the device).

  • The Toast Flex terminal serial number.

  • A summary of which troubleshooting steps you have already completed.

  • A description of the symptom (no power, fails test payments, intermittent disconnects, repeated error message).

For warranty information, see Toast's limited warranty policy. To order a replacement, visit Toast Shop.

To open a Customer Care ticket, see Contact Customer Support.

Related Articles

Did this answer your question?