A “Gateway Rejected: AVS” message means the merchant’s payment gateway blocked your transaction because the billing address you typed at checkout didn’t match the address your card issuer has on file. Your bank may have approved the charge itself, but the gateway ran its own address check and stopped the sale anyway. The mismatch almost always traces back to a typo, a recent move, or an apartment number that was entered in a format the system couldn’t read.
Why the Charge Failed Even Though Your Card Is Fine
Two separate systems look at every online card payment. Your bank decides whether to authorize the funds. The merchant’s payment gateway then runs its own security filters, and address verification is one of them. The gateway can reject a transaction after your bank has already said yes.
The card networks classify this as a “soft decline.” Visa’s processing documentation describes it this way: the issuing bank approved the authorization, but the transaction was declined because it did not pass the Address Verification Service check.1Visa Acceptance Support Center. Payments – Understanding the Difference Between a Soft Decline and Hard Decline That distinction matters, because a soft decline can leave a pending authorization on your statement for a purchase that never shipped.
AVS checks only the numeric parts of your billing address: the digits in your street number and your five-digit ZIP code. Street name spelling doesn’t matter to the system. Getting “123” versus “132,” or transposing two digits of your ZIP, does.
What Caused the Mismatch
A Typo at Checkout
The most common cause is simple data entry. One wrong digit in the street number or ZIP is enough to produce a full mismatch, which is the response code most gateways reject automatically.2Authorize.net Support Center. What is Address Verification Service (AVS) and How to Use and Configure It Re-read the numbers you entered before trying anything else.
You Recently Moved
If you updated your address with your bank in the last few weeks, the change may not have reached the system that answers AVS queries. Some issuers update within a day or two; others take a full billing cycle. During that gap, your old address is still the one that will match.
Apartment or Unit Numbers
Secondary address details cause a lot of silent mismatches. If your bank stores your address as “100 Oak St Apt 3” on a single line and the checkout form puts “Apt 3” on a separate line the AVS system doesn’t read, the “3” is missing from the comparison. The U.S. Postal Service recommends placing the apartment or unit designator at the end of the main delivery address line rather than on a separate line.3Postal Explorer. 213 Secondary Address Unit Designators Entering your billing address the same way raises the odds of a clean match.
A Non-U.S. Card
AVS was built around U.S. and Canadian card issuers. If your card was issued elsewhere, the issuing bank may not support AVS at all and will return a code indicating the service is unavailable or unsupported.4Visa Acceptance Support Center. Payments – AVS (Address Verification System) Results Many U.S. merchant gateways reject those codes by default, which blocks legitimate international cardholders.
A Prepaid or Gift Card
Prepaid debit and gift cards often have no billing address on file with the issuer. When the gateway’s AVS check comes back as unavailable, the transaction can be rejected automatically. Some prepaid card providers let you register a billing address through their website or app, which usually resolves it.5Authorize.net Support Center. What is Address Verification Service (AVS) and How to Use and Configure It If registration isn’t offered, that card may not work with merchants running strict AVS filters.
How to Fix It
Confirm the Exact Address Your Bank Has
Log into your bank’s online portal or mobile app and look at the billing address attached to the specific card you tried to use. This is not the same thing as your mailing preferences. If you can’t find it in the app, call the number on the back of the card and ask a representative to read the address back, including how any apartment or unit number is formatted in their system.
Re-Enter the Address Precisely
Type the address exactly the way the bank stores it. Focus on the street number and ZIP code, since those are the only pieces AVS actually compares. If the bank has your address on a single line with “Apt 3” at the end, enter it that way rather than splitting the unit number into a second field. Use the designator the bank uses (“Apt,” “Ste,” “Unit”) rather than a pound sign.
Contact the Merchant
If your address is correct and the rejection still happens, the problem may be on the merchant’s side. Reach out to their customer support, explain that you’re hitting an AVS rejection, and ask whether they can process the order manually. American Express’s gateway documentation confirms that merchants can override AVS rules on a per-transaction basis when they decide to accept the risk.6American Express. Address Verification Service Not every merchant will do this, but many will for a verified repeat customer.
Try a Different Payment Method
If the merchant can’t help and your address is confirmed, switch methods. A card from a different issuer, a digital wallet like Apple Pay or Google Pay, or PayPal will often go through where a direct card entry failed. Digital wallets commonly bypass the problem because the address attached to the wallet was already verified when you set it up.
About That Pending Charge on Your Statement
Your purchase didn’t complete, but your bank may still show a pending charge or temporary hold for the attempted amount. That happens because the bank authorized the funds a moment before the gateway rejected the sale. These authorizations are not real charges and they drop off on their own.
How long you wait depends on the card network and your bank. Mastercard’s processing rules allow issuers to hold funds for up to 7 calendar days on standard authorizations and up to 30 calendar days on preauthorizations.7Mastercard. Transaction Processing Rules In practice, most banks release holds from failed transactions within a few business days. If one is still sitting there after a week, call your bank and ask them to release it. They can usually do that once they confirm no completed transaction is attached to the authorization.
One practical note while you wait: each retry at checkout can create its own pending hold. If you’ve already tried the same card several times, you may see several identical pending amounts on your statement. They should all fall off, but your available balance will look lower until they do. That’s a good reason to confirm your billing address with the bank before attempting the purchase again, rather than guessing a third or fourth time.
If You’re the Merchant Seeing This
If you landed here because your own customers are being blocked, the fix lives in your gateway’s AVS filter settings rather than at the shopper’s end. Most gateways let you choose which response codes trigger a rejection, and the defaults are often stricter than they need to be, particularly for international cards and prepaid cards that commonly return “unavailable” or “unsupported” codes.5Authorize.net Support Center. What is Address Verification Service (AVS) and How to Use and Configure It Your gateway’s documentation will walk through the specific codes and how to adjust them.