Library
List of Errors
The transaction cannot be processed because the address provided by the customer is incorrect. Please advise the customer to verify and correct their address details.

Recommended Customer Message

The address you entered is incorrect or there is an address mismatch with the payment method. Please double-check your address details and try again.

Description

The payment failed due to an Address Verification System (AVS) mismatch. The billing address provided by your customer does not match the address on file with their card issuer, which can occur due to typos, outdated records, or formatting differences.

Recommended Customer Message

Your payment could not be completed because the billing address does not match the address on file with your bank. Please verify your address details and try again.

Root Cause

  • Incorrect billing address: The customer entered an address that does not match the bank's records.
  • Typographical errors: Mistakes in street address, ZIP code, or other address fields.
  • Outdated bank records: The bank has outdated address information, causing validation failures.
  • Regional differences: Address formats differing across countries can trigger AVS mismatches.

Troubleshooting and Solutions

  • Inform the customer that their transaction failed due to an address mismatch.
  • Ask the customer to double-check and update their billing address details.
  • Ask the customer to ensure that the entered address matches the one registered with their card issuer.
  • Retry the transaction after the correct billing address has been entered.
  • Work with your payment gateway to see if you need to relax the validation to balance out on the failures without adding further risk.
  • If the issue persists, recommend using an alternative payment method.