Get Help With Your Card Reader

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

In this Article:

• Before You Begin
• Tamper-Alert Check (TDA300/TOC300 only)
• Quick Fix
• Step 1: Power Cycle
• Step 2: Run a Test
• Step 3: Clear the Cache
• Step 4: Check the Connection
• Step 5: Verify EMV Is Enabled
• Step 6: Reset USB Detection
• Step 7: Fix Tap Payments That Prompt for a Swipe
• Manager Swipe Cards Not Working After Installation
• Persistent Connection or Repeated Errors
• Frequently Asked Questions
• Before You Contact Customer Care
• Related Articles

Before You Begin

Applies to: Toast Tap™ (Direct Attach), Toast Tap™ (On-Counter), Toast Flex terminal — covers both legacy readers and the current-generation TDA300/TOC300 readers.

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:

• Toast Go® handheld with an attached card reader → see Toast Go® 2 Card Reader Not Working
• e285, P400, P630, V400m, AMS1, or S1 (UK / Ireland / Canada) → see Identify Your Card Reader Type to find the right setup or troubleshooting article
• MagTek or Elo magnetic stripe reader → see Remove Your Magnetic Card Reader (MSR)

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 two EMV readers connected to the same terminal at the same time — this includes any combination of legacy eDynamo, legacy Toast Tap™, TDA300, or TOC300. 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.

Back to top

Tamper-Alert Check (TDA300/TOC300 only)

Check this first if you have a TDA300 or TOC300 reader. A tamper alert can look like a normal connectivity issue, but requires a different fix — replacement, not troubleshooting.

Is the power light on your reader solid red, are the payment lights flashing blue, yellow, green, and red, and is the device beeping about every 5 seconds?

• If yes, this indicates tamper detection. All data on the device has been erased and it cannot be restored to service. Do not continue troubleshooting — contact Customer Care for a replacement; see Before You Contact Customer Care.
• If no (or you have a legacy reader), continue to the Quick Fix table below.

Back to top

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.

Back to top

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. On legacy readers, a blinking blue light means the reader is powered on but not yet ready to accept a payment; a solid blue light means it's ready. On TDA300/TOC300, this power light is solid green when the reader is on and working normally — there is no blue light on Gen 3 hardware. If you see no light at all on either generation, the reader may not be receiving power — go to Step 4: Check the Connection.

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.

Back to top

Step 2: Run a Test

Confirm whether the reader hardware itself is working, separate from the Toast POS app. If this is a Dual Card Reader setup, please remove the card reader that is not being tested before proceeding.

Expected outcome: All test payment methods show as successful, 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.

Back to top

Step 3: Clear the Cache

Clearing the cache forces the Toast POS app to reload its connection to the card reader. This applies regardless of reader generation.

1. Select the gray circle at the bottom of your device's screen and open the Clear Cache shortcut.
   1. For devices with Launcher, see Use Toast Launcher for navigation instructions.
   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: Check the Connection.

Back to top

Step 4: Check the Connection

Expected outcome: The card reader is recognized and successfully passes a test payment.

If the connection checks out but the reader still fails, continue to Step 5: Verify EMV Is Enabled.

Back to top

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 reader should appear under one of these official model names:

• Legacy: BBPOS Chipper 2X(USB)
• TDA300: TDA300 Direct-Attach Card Reader(USB)
• TOC300: TOC300 On-Counter Card Reader(USB)

If you're using a Guest-Facing Display or a Toast Flex for Guest with a swipe-only reader, your EMV reader will show under Guest Pay instead.

If payment still isn't working after enabling EMV: Select your reader under Card Readers and select Remove Reader. Scroll down and confirm the reader is still listed. This will automatically turn EMV back off. Return to Device Setup and turn EMV Enabled back on, then run another test payment.

Note: On legacy readers, if the EMV update keeps failing, 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. On TDA300/TOC300, there is no external server dependency, so a firewall whitelist won't apply here — if the update keeps failing, try a different network anyway, and if it still doesn't resolve, 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.

Back to top

Step 6: Reset USB Detection

If the card reader still doesn't work after checking the connection, reset USB detection on the terminal. This applies regardless of reader generation.

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.

Back to top

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 — this applies regardless of reader generation. 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.

Back to top

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.

Note: Manager swipe cards registered on one reader generation do not work on the other — a card registered on a legacy Toast Tap™ will not work on a TDA300/TOC300, and vice versa. If your restaurant has a mix of legacy and current-generation readers, consider switching to Toast Access Cards instead, since they work across all reader generations.

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.

Back to top

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. This applies regardless of reader generation.

• Test the card reader connection again (see Step 4: Check the Connection).
• Replace or reset USB cables as needed to ensure a stable connection (legacy and TOC300 only — TDA300 has no cable).
• Verify the terminal's internet connection (see Verify Your Internet Connection).

"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.
• On legacy readers: a BBPOS firmware update may be in progress. If the update has failed, power cycle the terminal and try again. See BBPOS Card Reader Firmware Updates.
• On TDA300/TOC300: firmware updates finish with an audible beep rather than a light sequence — if the update seems stuck, power cycle the terminal and try again.
• If the update continues to fail or the error persists after a power cycle, contact Customer Care.

Back to top

Frequently Asked Questions

Why is my card reader not working?

Card readers usually stop working for one of three reasons: a loose 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 its connectivity 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). On legacy readers, also 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?

On legacy readers, 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 it, then attempt a payment again (see Step 2: Run a Test). On TDA300/TOC300, this isn't an issue, since no Force Stop is needed — if the Payment Readiness check passes but real payments still fail, continue to Step 5 to double-check EMV is enabled.

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 two EMV readers connected to the same terminal at the same time — this includes any combination of legacy eDynamo, legacy Toast Tap™, TDA300, or TOC300.

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.

How do I know if I have a legacy reader or a TDA300/TOC300?

Check Device Setup > Card Readers. Legacy readers show as BBPOS Chipper 2X(USB). Current-generation readers show their full model name: TDA300 Direct-Attach Card Reader(USB) or TOC300 On-Counter Card Reader(USB).

Back to top

Before You Contact Customer Care

If you've completed the steps above 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 (legacy or TOC300).
• The card reader has no power light in any USB port or mount position.
• The connectivity test fails on multiple cards, in multiple ports, or after reseating (TDA300).
• The card reader was working previously and has now physically failed (overheating, melted connector, no response).
• A tamper alert was detected (TDA300/TOC300) — see Tamper-Alert Check.

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, tamper alert).

For warranty information, see Toast's limited warranty policy. To order a replacement, head to Toast Shop and search card readers for more information and product availability.

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

Back to top

Related Articles

• Identify Your Card Reader Type
• Toast Tap™ (On-Counter) Installation Guide
• Toast Tap™ (Direct Attach) Installation Guide
• Guest Pay and Dual Reader Functionality with Toast Tap™

Back to top