Add Payment Method — UI Validations
This page provides a complete reference for validation rules and error messages for the Add Payment Method flow in Wallet mode. This covers the experience when a wallet user adds a new bank account or card to 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 (e.g., duplicate payment method).
- Bank Account
- Card
- Card - Telephonic Entry
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. 3. Enter a valid routing number. |
| 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. Enter a valid account number. 3. Account number must be between 6 and 17 digits. |
| 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. |
| 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. |
Stripe Handled Validations: Card Number, Expiration Date, CVC, ZIP Code
Form Level Validations
| Error Scenario | Error Message |
|---|---|
| Duplicate Payment Method | This payment method already exists in your wallet. Please enter a new payment method. |
| Payment Card Declined | Your card was declined. Please try a different card or contact your bank. |
| Payment Processing Failed | The payment could not be processed. Please try again later. |
| Network/Connection Error | Something went wrong due to a network error. Please check your connection and try again. |
| 3D Secure Authentication Failed | 3D Secure authentication failed. Please try again or use a different payment method. |
Note: Agent Mode Only
Field Level Validations
| Field Name | Validation Rules | Error Messages |
|---|---|---|
| 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. |
Sycurio Handled Fields: Name, Card Number, Expiration Date, CVC, ZIP Code
Form Level Validations
| Error Scenario | Error Message |
|---|---|
| Duplicate Payment Method | This payment method already exists in your wallet. Please enter a new payment method. |
| Payment Card Declined | Your card was declined. Please try a different card or contact your bank. |
| Payment Processing Failed | The payment could not be processed. Please try again later. |
| 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. |