Square: Address Verification Failure

What This Means

This error means that Square is declining the customer's payment method because the issuing bank is declining to authorize the card due to address verification (usually a billing postal code mismatch with the issuing bank).

Note: This type of generic error can be returned in many cases where Square declines the payment. Check within your Square Online Dashboard for specific declines and reports by visiting Reports >> Transaction Status. The Transaction Status report will list any unprocessed transactions – declined cards, canceled payments, and other uncompleted transactions.

Suggested Next Steps

  1. Check the customer's information in your payment gateway to determine if the payment simply needs to be updated or retried.

  2. Compare the saved information for your customer in your payment gateway with the billing address for the Customer.

  3. You may need to request that your customer add a new payment method if you are unable to update the Billing Address for the saved payment directly in your payment gateway.

  4. You can update the Billing Address for the customer in QPilot by visiting your Site Dashboard > Customers > Edit Customer. However, for saved payment methods, most payment gateways will require that the customer add a new payment method in order to update the billing address used with that payment method.

Adding A New Payment Method for Your Customer?

If you are adding a new payment method for your customer directly to your payment gateway (manually), ensure that you edit the failed Scheduled Order, add a new payment method, and copy the required billing information directly to their Scheduled Order including:

  • Gateway CustomerId
  • Gateway PaymentId
  • Billing Address
  • Payment Method Description (optional, but strongly suggested because it is used to display the payment method to your customer)

After Resolving The Issue

Once this issue is resolved, you should use the action to Restart Processing the Failed Scheduled Order.