A gateway rejected AVS error means your payment gateway blocked the transaction because the billing address you typed at checkout doesn’t match what your card issuer has on file. Your card itself is fine. It was authorized by the bank, has available credit, and isn’t flagged. The gateway simply refused to let the charge settle because the Address Verification Service response didn’t clear the merchant’s fraud filter. In most cases you can fix it in a few minutes.
Your Card Wasn’t Declined
This distinction matters before you start troubleshooting. When you submit a payment online, the gateway sends your card number, billing street address, and ZIP code to your bank through the card network. The bank authorizes the charge and separately returns a one-letter code telling the merchant how well the address matched.1Visa Developer. How to Use Payment Account Validation The gateway then applies the merchant’s rules to that code and decides whether to complete the transaction.2Authorize.net Support Center. What Does Gateway Rejected AVS Mean and How to Fix It
A “gateway rejected” message tells you the bank said yes but the gateway said no. That’s why re-entering the same card at a different merchant might work: different merchants set different filter thresholds. One might accept a partial match; another rejects anything short of a full match.
Why Your Address Didn’t Match
The most common cause is a plain typo. A transposed ZIP digit or a wrong house number is enough to trigger the rejection.3Chase Payment Solutions. AVS and Card Verification Data Codes Beyond that, a few situations catch people repeatedly:
- You moved recently and updated your address with the post office but never called your bank. Banks don’t pull address changes from USPS records automatically.
- Your apartment or unit number is in the wrong field, or the bank doesn’t store it at all. Some issuers keep the unit on a separate line; some drop it entirely.
- Formatting differs from what the bank stored. “123 N Main St” and “123 North Main Street” are the same address to a human and different strings to an automated comparison.
- You entered a shipping address, a work address, or an old address instead of the billing address currently tied to the card.
The underlying problem is almost always a gap between what you typed and what the bank has stored. Fixing it starts with finding out exactly what the bank has.
How to Fix It
Match Your Statement Exactly
Open your most recent card statement, paper or digital, and look at the billing address printed on it. That’s the format the bank has on file and the string AVS is comparing against. Note the abbreviations, whether directional prefixes appear, and where the unit number sits. Type the address at checkout to match that format character for character.
Call the Number on Your Card
If the statement matches what you entered and the rejection continues, call your issuer and ask the representative to read back the billing address in their system. Banks sometimes store addresses in a format that differs from what appears on statements, especially after a system migration or a branch update. A five-minute call resolves most stubborn AVS failures.
Retry With a Stripped-Down Address
On the next attempt, use the house number, street name, and ZIP code only. Drop the apartment number on the first retry, because some AVS systems ignore it and including it can create a mismatch where there wasn’t one. If that goes through, you’ve found the issue. When the form requires a second address line, put the unit number there rather than appending it to the street.
Ask the Merchant to Push It Through
If your address is right and the charge still won’t go, the merchant’s AVS filter may be stricter than your response code. Contact the merchant, explain what happened, and ask whether they can manually review the order or temporarily adjust the filter. Many can approve a transaction that returned a partial match.
Switch Payment Methods
Apple Pay and Google Pay verify you through your device’s fingerprint or facial recognition instead of matching address fields, so they bypass traditional AVS entirely. PayPal handles billing verification on its own side before passing the payment to the merchant. Any of these can get you through when the address route keeps failing.
International and Prepaid Cards Are Different
AVS works reliably with cards issued in the United States, Canada, and the United Kingdom, but many other issuers don’t participate.3Chase Payment Solutions. AVS and Card Verification Data Codes A non-participating bank returns a “G” code, and a bank that couldn’t run the check returns “U.” A strict merchant filter will reject either one even though your address is correct. If you’re using a foreign-issued card and hitting repeated rejections, the merchant’s configuration is the likely cause, not your data. Contact them directly.
Prepaid and gift cards have their own catch. Many don’t carry a billing address at all until you register one. Federal rules require issuers to verify identity for most prepaid accounts, and registration usually asks for your name, street address, date of birth, and Social Security or taxpayer identification number.4Consumer Financial Protection Bureau. Why Am I Being Asked for Personal Information to Activate or Register a Prepaid Card Without that registration, there’s no address for AVS to check against and the transaction will fail every time. Register the card with the issuer before trying to use it online.
The Pending Charge on Your Account
You may still see a pending hold even though the purchase failed. That’s because the bank authorized the funds before the gateway applied its filter and blocked settlement. The money hasn’t left your account, but it’s temporarily unavailable.
Most holds drop off within about three business days when the merchant doesn’t complete the charge. If you need it released sooner, ask the merchant to void the authorization. Merchants can release a hold faster than a bank can, because the bank is otherwise waiting for either settlement or expiration. If the merchant won’t or can’t, call your card issuer about their release process.
What the AVS Response Codes Mean
If the merchant’s error message or your bank tells you which code came back, that pinpoints what went wrong:
- Y — Full match. Street address and five-digit ZIP both match.
- A — Street address matches, ZIP does not.5Visa Acceptance Support Center. Payments – AVS (Address Verification System) Results
- Z — ZIP matches, street address does not.2Authorize.net Support Center. What Does Gateway Rejected AVS Mean and How to Fix It
- N — Neither field matches.6Authorize.net. Address Verification Service (AVS)
- U — Address information unavailable; the bank couldn’t run the check.6Authorize.net. Address Verification Service (AVS)
- G — Non-U.S. issuer that doesn’t support AVS.6Authorize.net. Address Verification Service (AVS)
A “Z” tells you the street data is off. An “A” points at the ZIP. “N” means both, which usually signals you entered the wrong address entirely or your bank’s records are seriously out of date. “U” or “G” means the check couldn’t happen at all, and your best move there is switching payment methods or asking the merchant to accept the transaction manually.