When checkout returns a “Gateway Rejected: AVS” error, the merchant’s payment gateway has blocked your transaction because the billing address you entered doesn’t match the address your card issuer has on file. Your bank may have approved the charge on its side, but the gateway ran its own address check and stopped the sale anyway. The fix is almost always a small correction to the address you typed, though a recent move, an apartment number, or an international or prepaid card can complicate things.
What the Error Is Actually Telling You
Two separate systems evaluate every online card payment. Your card-issuing bank checks whether you have the funds or available credit and returns an authorization. The merchant’s payment gateway then runs its own security filters, including the Address Verification Service, and can reject the transaction even after the bank said yes.
Visa classifies this outcome as a “soft decline”: the issuer approved the authorization, but the transaction was declined because it did not pass the AVS check.1Visa Acceptance Support Center. Payments – Understanding the Difference Between a Soft Decline and Hard Decline That’s why you may see a pending charge on your bank statement for a purchase you never actually completed. The authorization went through; the sale didn’t.
What AVS Compares
AVS only looks at the numeric parts of your billing address. It pulls the digits from your street address (the “123” in “123 Main Street”) and your five-digit ZIP code, sends them through the card network to your issuing bank, and gets back a code showing how well they matched. The gateway then applies its own rules to decide whether to accept or reject.
Because only the numbers are checked, misspelling your street name won’t cause a failure on its own. Typing “132” when your address is “123,” or transposing digits in your ZIP, will.
Why Your Transaction Got Rejected
A Typo in the Numbers
The most common cause is a data-entry mistake in exactly the fields AVS checks: the street number or the ZIP code. Slow down and re-read those two fields before anything else.
You Recently Moved
If you updated your address with your bank recently, the change may not have propagated to the authorization system yet. Some issuers update AVS records within a day or two; others can take a full billing cycle. During that gap, your old address is still what the system will match against.
Apartment or Unit Numbers
Secondary address details cause a lot of trouble. If your bank stores “Apt 4B” as part of your street line and the checkout form splits the unit number onto a separate line the AVS system ignores, the numeric “4” drops out of the comparison and you get a mismatch. The U.S. Postal Service recommends placing the apartment or unit designator at the end of the main delivery address line rather than on its own line.2Postal Explorer. 213 Secondary Address Unit Designators Entering your billing address the same way improves the match.
Your Card Was Issued Outside the U.S.
AVS was designed primarily for cards issued by U.S. and Canadian banks. Issuers in other countries often don’t support it, and the system returns a code indicating the check isn’t available.3Visa Acceptance Support Center. Payments – AVS (Address Verification System) Results Many gateways reject that response by default, which means international cardholders can be blocked even when the card and the buyer are completely legitimate.
You’re Using a Prepaid or Gift Card
Prepaid debit cards and gift cards often don’t have a billing address registered with the issuer. AVS comes back with an “unavailable” response, and stricter gateways treat that as a rejection. Some prepaid card providers let you register a billing address through their website or app, which fixes the problem. If registration isn’t offered, the card may not work at merchants with tight AVS filters.4Authorize.net Support Center. What is Address Verification Service (AVS) and How to Use and Configure It
How to Get the Payment Through
Start by confirming the exact billing address your card issuer has on file. Log into your bank’s online portal or mobile app and look at the billing address tied to your card, not your mailing preferences. If you can’t find it online, call the number on the back of the card and ask a representative to read the address back to you, including how they format any apartment or unit number.
Then re-enter that address at checkout exactly as the bank stores it. Focus on the street number and the ZIP code, since those are the only parts AVS actually checks. If your bank has your address as “100 Oak St Apt 3” on a single line, enter it that way rather than splitting the apartment number into a separate field. Use the designator the bank uses (“Apt,” “Ste,” “Unit”) instead of a pound sign.
If your address is correct and the rejection keeps happening, the issue is on the merchant’s side. Contact the merchant’s customer support and explain what’s happening. They can sometimes verify your identity another way and process the order manually; American Express’s gateway documentation confirms that merchants can override AVS on a per-transaction basis when they’re willing to accept the risk.5American Express. Address Verification Service
If that doesn’t work either, switch payment methods. A card from a different issuer often clears where the first one didn’t. Digital wallets like Apple Pay and Google Pay frequently bypass AVS because the address is pre-verified inside the wallet. PayPal handles verification on its own end. Any of these can sidestep the problem entirely.
The Pending Charge From the Failed Attempt
Because the bank authorized the transaction before the gateway rejected it, you may see a pending charge or temporary hold on your account for the amount you tried to spend. It isn’t a real charge, and no money has actually moved. The authorization will drop off on its own.
How long that takes depends on the card network and your issuer. Mastercard’s rules allow issuers to hold funds for up to 7 calendar days on standard authorizations and up to 30 calendar days on preauthorizations.6Mastercard. Transaction Processing Rules In practice, most banks release holds from failed transactions within a few business days. If a hold is still sitting there after a week, call your bank and ask them to release it. They can usually do it on the spot once they confirm no completed transaction is attached to the authorization.