Why is my virtual card being declined? Here is what to check

Read summarized version with:

ChatGPT Claude Grok Perplexity Gemini

A virtual card is declined for one of five reasons: the charge is over the spend cap, the merchant does not match the card's lock, the location or time is outside the allowed range, the card has been cancelled or expired, or the card details were entered incorrectly. Check them in this order. Most declines are fixable without cancelling the card or reissuing. Here is what each one looks like and what to do about it.

The five most common reasons a virtual card is declined

Not every decline has the same cause. Here are the five reasons, in order of how often they come up, along with what the employee likely sees at the terminal and how to fix each one.

• 1
  Spend cap hit

  The charge is higher than the remaining balance on the card. The terminal returns a generic decline. The employee may not know the exact cap, so they are confused when the card does not go through.

  Fix: log in to your dashboard, check the remaining balance on the card, and raise the cap if the purchase is legitimate. Tell the employee to try again.
• 2
  Merchant or category lock

  Where your card program supports merchant controls, a charge at a store not on the card's allowed list, or in a blocked merchant category, is declined. This fires even if the card has plenty of balance.

  Fix: go to the card's settings in your dashboard, add the merchant by name or adjust the category, and have the employee retry the card.
• 3
  Location or time restriction

  Where supported, a charge outside the card's allowed geography or outside the allowed time window is declined. A purchase at a store in a different city, or a charge made outside working hours, can both trigger this.

  Fix: check which restrictions are active under the card's settings, widen the location window or adjust the time range, and have the employee try again.
• 4
  Card cancelled or expired

  The card was cancelled from the dashboard, or it reached its expiration date. All new authorizations on a cancelled card are declined. An expired card behaves the same way.

  Fix: issue a new card from your dashboard and email the card details to the employee. They add it to their phone wallet and try the purchase again.
• 5
  Incorrect card details entered

  Common with manual keyed entry. If the card number, expiry month and year, CVV, or billing zip is wrong by even one digit, the authorization fails.

  Fix: have the employee re-enter the 16-digit card number, expiry, and CVV carefully. Confirm the billing zip matches if the terminal asks for it.

How to check the decline reason from your dashboard

You do not have to guess which reason fired. Your card dashboard shows you what happened. Here is how to find it in under a minute.

1. Log in to your Virtual Card Maker dashboard.
2. Go to the card list and select the specific card the employee was using.
3. Open the transaction log for that card. The most recent declined attempt will appear at the top, usually marked as declined or failed.
4. Check the decline code or note attached to the attempt. Common codes point to insufficient funds (spend cap), restricted merchant (merchant or category lock), or invalid card data (incorrect entry).
5. Check the spend cap remaining. It is shown on the card detail screen next to the current balance.
6. Check the active locks. They are listed under the card settings, usually labelled merchant controls, category controls, or location and time settings, where supported.

Once you know which setting fired, you can fix it directly from the same screen. You do not need to cancel the card or contact support for most of these.

How to fix each type of decline

Here is the specific fix for each of the five reasons. Each one takes one to two steps in your dashboard.

Spend cap

1. Open the card in your dashboard and check the remaining balance. If the charge was more than what was left, the cap is the cause.
2. Raise the cap to cover the purchase amount, plus a small buffer for tax and any small order overages.
3. Tell the employee the cap has been adjusted and to try the card again at the terminal.

Merchant or category lock

1. Open the card settings and look at the merchant or category controls (where supported).
2. Add the specific merchant by name, or adjust the category to include the type of store the employee is at.
3. Save the change and have the employee retry the card. The updated lock takes effect immediately in most cases.

Location or time restriction

1. Open the card settings and review the location and time controls (where supported).
2. Check which restriction fired: is the store outside the allowed geography, or is the purchase happening outside the allowed hours?
3. Widen the location window to include the current store's area, or adjust the time range to cover the current hour. Save the change and have the employee retry.

Card cancelled or expired

1. Confirm the card status in your dashboard. A cancelled or expired card will show a status label indicating it is no longer active.
2. Issue a new virtual card from your dashboard. Set the spend cap and any applicable locks before sending it.
3. Email the new card details (card number, expiry, and CVV) to the employee. They add it to their phone wallet or enter the details manually at the counter and complete the purchase.

Incorrect entry

1. Have the employee pull up the card details from the email or wallet where they stored them.
2. Re-enter the 16-digit card number carefully, one digit at a time. Then enter the expiry month and year, and the CVV.
3. If the terminal asks for a billing zip, confirm the zip on file matches what the employee is entering. A mismatch here causes a decline even when all other details are correct.

When a card is declined because of the merchant category code

Every merchant has a Merchant Category Code (MCC) assigned by Visa. This is a four-digit number that describes what type of business the merchant is. When you set a category lock on a card, the card allows or blocks charges based on the MCC, not the store's name.

This matters because the store name and the MCC do not always match what you expect. A hardware supplier might be coded as general merchandise rather than hardware and home improvement. A gas station that sells convenience items might have a different MCC than a pure fuel retailer. A charge gets declined not because the store name is wrong, but because the MCC assigned to that store falls outside the category you allowed.

If your employee's card is declined at a store you expected it to work at, check the MCC assigned to that specific location. You can look up merchant category codes in the IRS instructions for Form 1099-K, which includes a full MCC reference table. Once you know the MCC, adjust your category lock to include it, where your card program supports category controls.

The practical fix: if you are not sure which MCC applies to a new merchant, have the employee make a small test purchase before they depend on the card for a large order. A $1 or $2 buy at the right store tells you immediately whether the category lock will allow charges there. For full spending control, see how to set up a virtual expense card with the right locks before issuing it to your team.

What the employee should do when the card is declined at the store

Your employee is at the counter and the card is declined. Here is what they should do, in order.

1. Do not retry the card multiple times in a row. One retry is fine. Multiple rapid retries at the same terminal can trigger a fraud flag, which may lock out the card at that terminal even after you fix the underlying setting. One try, then stop and call you.
2. Call or text you with the exact store name and the purchase amount. You need both to diagnose which setting fired. "The card did not work" is not enough information. "I am at Riverside Building Supply, the total is $347" gives you what you need to check the cap and locks.
3. If the decline is from the spend cap, wait for you to raise it, then retry once. The cap update takes effect quickly. One retry after your confirmation is all the employee needs.
4. If the store does not take tap to pay, ask whether they accept keyed entry. Most counters can key in a card number manually. Have the employee re-enter the full card number, expiry, and CVV from the card details they received by email.
5. If the card is cancelled, wait for a new card number to be sent. A cancelled card will not work no matter how many times it is retried. The employee should wait for the new card details to arrive by email before attempting another purchase.

Once the issue is resolved, you may also want to review how virtual card security controls work to prevent future declines.

How to set up cards to avoid declines before they happen

Most declines are preventable. These four habits cut the most common causes before the employee is standing at a counter.

• Set the cap above the expected spend, not at it. A $500 expected spend should carry a cap of $550 to $600. Tax, a slightly larger order, or a small add-on item will push the charge over a cap that is set too tightly. Build in a buffer every time.
• Test the card at the right merchant before the worker is counting on it. A small test purchase confirms the category lock, location, and merchant settings all work at that store before the employee is standing there with a full cart and a line behind them. If you are new to setting up virtual cards, start with our guide to creating your first virtual card.
• Where your program supports category controls, verify the category before you lock the card. A $1 purchase at the intended store tells you the MCC falls inside your allowed list. If it is declined, you know to adjust the category setting before the real purchase.
• Make sure your employee has all four card details before they leave. Card number, expiry, CVV, and billing zip. All four. If they only have the card in their phone wallet and the store does not take contactless, they need the number to key it in. Send the details by email when you issue the card.

Things to avoid when a decline happens

People also ask