A large portion of billing and payment tickets come down to incomplete or mismatched billing address, postal/ZIP, or other billing info. These fields impact both payment authorization (AVS/issuer checks) and tax calculation.
Key takeaway: If a payment fails unexpectedly (or taxes look wrong), confirm the account’s billing info is complete and correctly formatted before deeper investigation.
Common Symptoms
- Gateway declines that reference address/ZIP mismatch (AVS-related messaging).
- Transactions that fail only for certain customers or regions.
- Taxes not applied, applied at the wrong rate, or applied to the wrong jurisdiction.
- Invoices that differ from expectations after the customer changed address mid-cycle.
Why Address & Postal Code Matter
1) Payments (AVS / issuer validation)
Many gateways and issuing banks use Address Verification Service (AVS) rules to validate the billing address and postal code. If the merchant or issuer requires an AVS match, missing/incorrect data can increase declines.
2) Tax determination
Taxes often depend on customer location. If the address is incomplete or uses an unexpected format, tax engines (or configured tax rules) may not resolve the correct rate.
Important: Even small differences (postal code format, missing state/province, abbreviated country) can change tax outcomes or increase issuer scrutiny.
What to Check in Recurly
| Field | Why it matters | What “good” looks like |
|---|---|---|
| Country | Tax jurisdiction + gateway validation | Valid ISO country selection and consistent usage |
| Postal/ZIP | AVS + tax jurisdiction | Correct format for country (e.g., US 5-digit or ZIP+4) |
| State/Province | Often required for US/CA taxes | Present and valid for that country |
| Street/City | Improves AVS quality | Not blank; avoids unsupported characters |
How can this be fixed?
- Identify a failing invoice/transaction and confirm the customer’s current billing info.
- Ask the merchant/customer to update billing address and postal code (or update via API if appropriate).
- Re-attempt collection once billing info is corrected.
- If the issue is tax-related, re-check the invoice after updating the address and confirm the expected tax behavior.
Best Practices
- Make billing address + postal code required at checkout for regions where declines are high.
- Validate postal/ZIP format client-side where possible.
- If taxes are critical, standardize when address changes take effect (e.g., next invoice vs. immediate).
- Document the minimum billing info fields required for your gateway risk/AVS settings.
Comments
0 comments
Please sign in to leave a comment.