Pay and Save — UI Validations

This page provides a complete reference for validation rules and error messages for the Pay and Save flow in Payment mode. Pay and save allows authenticated wallet users to make a payment and save their payment method to their wallet in a single step.

Use this reference to understand what the widget will display when a user submits invalid input or encounters a form-level error.

Validation Types Covered:

• Field Level: Triggered per input field on blur or submit.
• Form Level: Triggered on form submission for cross-field or service-level errors.

Bank Account

Field Level Validations

Field Name	Validation Rules	Error Messages
Name on Account	1. This field is required. 2. Must contain only alphabets and special characters.	1. Name on account is required. 2. Name on account is invalid. Please make sure name field includes alphabet and special characters only.
Routing Number	1. This field is required. 2. Must be 9 characters long. 3. Must only have numerical values.	1. Routing number is required. 2. Routing number is incomplete.
Account Number	1. This field is required. 2. Must only have numerical values. 3. Account number must be between 6 and 17 digits.	1. Account number is required. 2. Account number is incomplete.
Nickname	1. Must only contain alphanumeric characters and spaces, and must not exceed 30 characters. 2. Must not contain the account number.	1. Invalid bank account nickname 2. Please make sure that the nickname field doesn't contain a bank account number.

Form Level Validations

Error Scenario	Error Message
Invalid Routing Number	Please enter a valid routing number.
Invalid Account Number	Please enter a valid account number.
Account and Routing Number Mismatch	The account and routing number do not match.
Unsupported Bank	This bank is not supported.
Account Not Found	The bank account could not be found.
Insufficient Funds	There are insufficient funds in the account.
Account Closed	The bank account has been closed.
Account Frozen	The bank account has been frozen.
Transaction Not Allowed	This transaction is not allowed for this account.

Note: Some validations are also managed by the Wells Fargo API.

Card

Field Level Validations

Field Name	Validation Rules	Error Messages
Name on Card	1. This field is required. 2. Must not contain card numbers.	1. Name on card is required. 2. Invalid name on card
Card Nickname	1. Must contain only valid characters (alphanumeric and spaces). 2. Must not contain card numbers.	1. Please enter a valid card nickname. 2. Card nickname is required.
Manufacturer Copay Card (Dropdown)	1. A medication selection is required.	1. A medication selection is required.

Stripe Handled Validations: Card Number, Expiration Date, CVC, ZIP Code

Form Level Validations

Error Scenario	Error Message
Invalid Card Number	Please enter a valid card number.
Invalid Expiration Date	Please enter a valid expiration date.
Invalid CVV	Please enter a valid CVV.
Expired Card	Your card has expired.
ZIP Code Mismatch	Please enter a valid ZIP code.
Unsupported Card	This card is not supported.
Card Declined	Your card was declined.
Payment Processing Failed	The payment could not be processed.
Network/Connection Error	Something went wrong due to a network error. Please check your connection and try again.
Card Reported Stolen	This card has been reported stolen. Please use a different payment method.
Billing Address Mismatch	The billing address does not match the card.
Incorrect CVV	The CVV is incorrect.
Card Restriction	There is a restriction on the card.
Insufficient Funds	The card has insufficient funds.
Card Issuer Unavailable	The card issuer is unavailable.
Card Cancelled	The card has been cancelled.
Invalid Card	The card is invalid.
Transaction Not Allowed	The transaction is not allowed.