Edit Payment Method — UI Validations
This page provides a complete reference for validation rules and error messages for the Edit Payment Method flow in Wallet mode. This covers the experience when a wallet user updates an existing bank account or card in their wallet.
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
- Card
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. |
| Nickname | 1. Must only contain alphanumeric characters and spaces, and must not exceed 30 characters. 2. Must not contain the account number. | 1. Enter a valid 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 |
|---|---|
| Duplicate Payment Method | This payment method already exists in your wallet. |
| Invalid Account Number | The account number you entered is invalid. Please check the number and try again. |
| Invalid Routing Number | The routing number you entered is invalid. Please check the number and try again. |
| System Error | We're sorry, but we encountered a problem processing your request. Please try again later. |
Note: Some validations are also managed by the Wells Fargo API.
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. Please make sure that the name field doesn't contain a card number. |
| Expiration | 1. This field is required. 2. Must be exactly 4 digits (MM/YY format). 3. Year cannot be more than 50 years in the future. 4. Year cannot be in the past. 5. Month/Year combination cannot be in the past. | 1. Expiration is required. 2. Expiration date is incomplete. 3. Expiration year is invalid. 4. Expiration year is in the past. 5. Expiration date is in the past. |
| ZIP Code | 1. This field is required. 2. Must be at least 5 characters long. | 1. ZIP code is required. 2. ZIP code is incomplete. |
| 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. Please make sure that the card nickname field doesn't contain a card number. |
| Manufacturer Copay Card (Dropdown) | 1. A medication selection is required. | 1. A medication selection is required. |
Form Level Validations
| Error Scenario | Error Message |
|---|---|
| Duplicate Payment Method | This payment method already exists in your wallet. |
| Invalid Account Number | The account number you entered is invalid. Please check the number and try again. |
| Invalid Routing Number | The routing number you entered is invalid. Please check the number and try again. |
| System Error | We're sorry, but we encountered a problem processing your request. Please try again later. |