Stripe: Zip Code Supplied Failed Validation

What This Means

This error means that Stripe is declining the transaction due to a customer's credit card failing a zip code verification (AVS).

When zip code verifications are activated with AVS in your Stripe account, Stripe will cross-reference the zip code supplied by the user in the checkout vs the zip code their bank has on file.

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 in your Stripe account for them.

  4. Instructions to update Zip Code Verification and AVS settings can be found on Stripe’s website here.

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.