validationInformation
The following fields provide validation information.
validationInformation. accountType
The bank account type.
Possible values:
- BC: Business checking
- BI: Business IRA
- BS: Business savings
- CC: Consumer checking
- CI: Consumer IRA
- CS: Consumer savings
Specifications
- Data Type:String
- Data Length:Enum
Mapping Information
- REST API Field:validationInformation.accountType
- SCMP API Field:ecp_avs_account_type
- Simple Order API Field:ecAVSReply_accountType
validationInformation. authorizationLevel
validationInformation.bank. accountOwner.
customerDataConditionCode
Indicates the status of the account owner data provided by the customer.
Condition codes help provide context about the account owner and authorized signer data in
the National Shared Database.
Specifications
- Data Type:String
- Data Length:3
Mapping Information
- REST API Field:validationInformation.bank. accountOwner.customerDataConditionCode
- SCMP API Field:ecp_avs_customer_data_condition_code
- Simple Order API Field:ecAVSReply_customerDataConditionCode
validationInformation.bank.
accountOwner. matchAddress
Indicates how closely the overall address (address line 1 and address line 2) in the
request matches a National Shared Database record.
Possible values:
- Y: The address information in the request closely or exactly matches a National Shared Database record.
- C: The address information in the request partially matches a National Shared Database record.
- N: The address information in the request does not match a National Shared Database record.
- U: No address information is available in the National Shared Database.
Specifications
- Data Type:String
- Data Length:1
Mapping Information
- REST API Field:validationInformation.bank.accountOwner.matchAddress
- SCMP API Field:ecp_avs_match_bill_address
- Simple Order API Field:ecAVSReply_matchBillToAddress
validationInformation.bank. accountOwner.
matchAdministrativeArea
Indicates how closely the state code in the request matches a National Shared Database
record.
Possible values:
- Y: The state code in the request closely or exactly matches the information in a National Shared Database record.
- C: The state code in the request partially matches the information in a National Shared Database record.
- N: The state code in the request does not match the information in a National Shared Database record.
- U: The database contains the routing transit number is found in the database, but a state code is not available for the database record.
Specifications
- Data Type:String
- Data Length:1
Mapping Information
- REST API Field:validationInformation.bank.accountOwner.matchAdministrativeArea
- SCMP API Field:ecp_avs_match_bill_state
- Simple Order API Field:ecAVSReply_matchBillToState
validationInformation.bank. accountOwner.
matchCompanyName
Indicates how closely the business name in the request matches a National Shared Database
record.
Possible values:
- Y: The value in the request closely or exactly matches a National Shared Database record.
- C: The value in the request partially matches a National Shared Database record.
- N: The value in the request does not match.
- U: No relevant data is available in the National Shared Database.
Specifications
- Data Type:String
- Data Length:1
Mapping Information
- REST API Field:validationInformation.bank.accountOwner.matchCompanyName
- SCMP API Field:ecp_avs_match_company_name
- Simple Order API Field:ecAVSReply_matchBillToCompany
validationInformation.bank. accountOwner.
matchCompanyPhoneNumber
Indicates how closely the business phone number in the request matches the National Shared Database record.
Possible values:
- Y: The home phone or work phone number in the request exactly matches a database record.
- C: The home phone or work phone number in the request is a close match but does not exactly match by one digit, or two correct digits have been transposed.
- N: The home phone or work phone number in the request does not match the database record. Two or more digits do not match.
- U: The routing transit number is in the database, but a home or work phone number is not available in the database record.
Specifications
- Data Type:String
- Data Length:1
Mapping Information
- REST API Field:validationInformation.bank.accountOwner.matchCompanyPhoneNumber
- SCMP API Field:ecp_avs_match_company_phone
- Simple Order API Field:ecAVSReply_matchBillToCompanyPhoneNumber
validationInformation.bank. accountOwner.
matchDateOfBirth
Indicates how closely the date of birth in the request matches the National Shared Database
record.
Possible values:
- Y: The date of birth in the request exactly matches a database record.
- C: The year and month of the date of birth in the request match the database record, but the day of the month does not match
- N: The date of birth in the request does not match a database record. The year or month or both do not match.
- U: The routing transit number number is in the database, but a date of birth is not available in the database record.
Specifications
- Data Type:String
- Data Length:1
Mapping Information
- REST API Field:validationInformation.bank.accountOwner.matchDateOfBirth
- SCMP API Field:ecp_avs_match_date_of_birth
- Simple Order API Field:ecAVSReply_matchBillToDateOfBirth
validationInformation.bank. accountOwner.
matchFirstName
Indicates how closely the first name in the reqeust matches the National Shared Database record.
Possible values:
- Y: The value in the request closely or exactly matches a record in the National Shared Database.
- N: The value in the request does not match a record in the National Shared Database.
- U: No first name data for this account is available in the National Shared Database.
Specifications
- Data Type:String
- Data Length:1
Mapping Information
- REST API Field:validationInformation.bank.accountOwner.matchFirstName
- SCMP API Field:ecp_avs_match_customer_first_name
- Simple Order API Field:ecAVSReply_matchBillToFirstName
validationInformation.bank. accountOwner.
matchFullName
How closely the full name matches the record in the National Shared Database.
Indicates how closely the full name (first name, middle name, and last name) in the request matches the National Shared Database record.
Possible values:
- Y: The value in the request closely or exactly matches a National Shared Database record.
- C: The value in the request conditionally (partially) matches a National Shared Database record.
- N: The value in the request does not match a National Shared Database record.
- U: No full name data for this account is available in the National Shared Database.
Specifications
- Data Type:String
- Data Length:1
Mapping Information
- REST API Field:validationInformation.bank.accountOwner.matchFullName
- SCMP API Field:ecp_avs_match_customer_full_name
- Simple Order API Field:ecAVSReply_matchBillToFullName
validationInformation.bank. accountOwner.
matchLastName
Indicates how closely the last name in the reqeust matches the National Shared Database record.
Possible values:
- Y: The value in the request closely or exactly matches a National Shared Database record.
- N: The value in the request does not match a National Shared Database record.
- U: No last name data for this account is available in the National Shared Database.
Specifications
- Data Type:String
- Data Length:1
Mapping Information
- REST API Field:validationInformation.bank.accountOwner.matchLastName
- SCMP API Field:ecp_avs_match_customer_last_name
- Simple Order API Field:ecAVSReply_matchBillToLastName
validationInformation.bank. accountOwner.
matchLocality
Indicates how closely the city name in the request matches the National Shared Database record.
Possible values:
- Y: The city name in the request closely or exactly matches a National Shared Database record.
- C: The city name in the request partially matches a National Shared Database record.
- N: The city name in the request does not match a National Shared Database record.
- U: No city name information for this account is available in the National Shared Database.
Specifications
- Data Type:String
- Data Length:1
Mapping Information
- REST API Field:validationInformation.bank.accountOwner.matchLocality
- SCMP API Field:ecp_avs_match_bill_city
- Simple Order API Field:ecAVSReply_matchBillToCity
validationInformation.bank. accountOwner.
matchMiddleName
Indicates how closely the middle name in the request matches a National Shared Database
record.
Possible values:
- Y: The value in the request closely or exactly matches a National Shared Database record.
- N: The value in the request does not match a National Shared Database record.
- U: No middle name data is available in the National Shared Database.
Specifications
- Data Type:String
- Data Length:1
Mapping Information
- REST API Field:validationInformation.bank.accountOwner.matchMiddleName
- SCMP API Field:ecp_avs_match_customer_middle_name
- Simple Order API Field:ecAVSReply_matchBillToMIddleName
validationInformation.bank. accountOwner.
matchNamePrefix
How closely the name prefix matches the National Shared Database record.
When a name prefix is included in the request,
U
is always returned.Possible values:
- U: No data is available in the National Shared Database.
Specifications
- Data Type:String
- Data Length:1
Mapping Information
- REST API Field:validationInformation.bank.accountOwner.matchNamePrefix
- SCMP API Field:ecp_avs_match_customer_prefix
- Simple Order API Field:ecAVSReply_matchBillToPrefix
validationInformation.bank. accountOwner.
matchNameSuffix
How closely the name suffix matches the National Shared Database record.
When a name suffix is included in the request,
U
is always returned.Possible values:
- U: No data is available in the National Shared Database.
Specifications
- Data Type:String
- Data Length:1
Mapping Information
- REST API Field:validationInformation.bank.accountOwner.matchNameSuffix
- SCMP API Field:ecp_avs_match_customer_suffix
- Simple Order API Field:ecAVSReply_matchBillToSuffix
validationInformation.bank. accountOwner.
matchPersonalIdentificationID
Indicates how closely the document identification number in the request matches the National
Shared Database record.
Possible values:
- Y: The value in the request closely or exactly matches information in a National Shared Database record.
- C: The value in the request partially matches information in a National Shared Database record.
- N: The value in the request does not match information in a National Shared Database record.
- U: No personal identification ID data is available in the National Shared Database.
Specifications
- Data Type:String
- Data Length:1
Mapping Information
- REST API Field:validationInformation.bank.accountOwner.matchPersonalIdentificationID
- SCMP API Field:ecp_avs_match_personal_id
- Simple Order API Field:ecAVSReply_matchPersonalID
validationInformation.bank. accountOwner.
matchPersonalIdentificationIssuedBy
Indicates how closely the issuer of the document in the request matches the National Shared Database record.
Possible values:
- Y: The value in the request closely or exactly matches information in a National Shared Database record.
- N: The value in the request does not match information in a National Shared Database record.
- U: No personal identification issued by data is available in the National Shared Database.
Specifications
- Data Type:String
- Data Length:1
Mapping Information
- REST API Field:validationInformation.bank.accountOwner.matchPersonalIdentificationIssuedBy
- SCMP API Field:ecp_avs_match_personal_id_issued_by
- Simple Order API Field:ecAVSReply_matchPersonalIDIssuedBy
validationInformation.bank. accountOwner.
matchPersonalIdentificationType
Indicates how closely the type of identification in the request matches the National Shared
Database record.
Possible values:
- Y: The value in the request closely or exactly matches information in a National Shared Database record.
- C: The value in the request partially matches information in a National Shared Database record.
- N: The value in the request does not match information in a National Shared Database record.
- U: No personal identification type data for this account is available in the National Shared Database.
Specifications
- Data Type:String
- Data Length:1
Mapping Information
- REST API Field:validationInformation.bank.accountOwner.matchPersonalIdentificationType
- SCMP API Field:ecp_avs_match_personal_id_type
- Simple Order API Field:ecAVSReply_matchPersonalIDType
validationInformation.bank. accountOwner.
matchPhoneNumber
Indicates how closely the home phone number in the request matches the National Shared Database record.
Possible values:
- Y: The home or work phone number in the request exactly matches a database record.
- C: The home or work phone number in the request is a close match but does not exactly match by one digit, or two correct digits are transposed.
- N: The home or work phone number in the request does not match a database record. Two or more digits do not match.
- U: The routing transit number is in the database, but no home or work phone number is in the database record.
Specifications
- Data Type:String
- Data Length:1
Mapping Information
- REST API Field:validationInformation.bank.accountOwner.matchPhoneNumber
- SCMP API Field:ecp_avs_match_customer_phone
- Simple Order API Field:ecAVSReply_matchBillToPhoneNumber
validationInformation.bank. accountOwner.
matchSocialSecurityNumber
validationInformation.bank. accountOwner.
matchTaxId
Indicates how closely the tax ID number in the request matches the National Shared Database record.
Possible values:
- Y: The tax identification number in the request exactly matches a database record.
- C: The tax identification number in the request is a close match but does not exactly match by one digit, or two correct digits have been transposed.
- N: The tax identification number in the request does not match a database record. Two or more digits do not match.
- U: The routing transit number is found in the database, but no tax identification number is in the database record.
Valid values for a four-digit tax ID are
Y
, N
,
U
.Valid values for a nine-digit tax ID are
Y
, C
,
N
, U
. Specifications
- Data Type:String
- Data Length:1
Mapping Information
- REST API Field:validationInformation.bank.accountOwner.matchTaxId
- SCMP API Field:ecp_avs_match_bill_company_tax_id
- Simple Order API Field:ecAVSReply_matchBillToCompanyTaxID
validationInformation.bank. accountOwner.
matchPostalCode
Indicates how closely the postal code in the request matches the National Shared Database record.
Possible values:
- Y: The postal code in the request closely or exactly matches a National Shared Database record.
- C: The postal code in the request partially matches a National Shared Database record.
- N: The postal code in the request does not match a National Shared Database record.
- U: No postal code data for this account is available in the National Shared Database.
Specifications
- Data Type:String
- Data Length:1
Mapping Information
- REST API Field:validationInformation.bank.accountOwner.matchPostalCode
- SCMP API Field:ecp_avs_match_bill_zip
- Simple Order API Field:ecAVSReply_matchBillToPostalCode
validationInformation.bank. accountOwner.
overallMatchScore
Score designating how well the request data matches a database record.
The score is a measure of how closely the data values in the request match the information
in a National Shared Database record. It is derived by compiling all of the data matches
for the account information submitted for matching and includes name variations,
abbreviations, spelling, phonetic encoding, and other matching algorithms.
Possible values range from 0 through 100.
A value of 81 or greater meets the criteria for a match.
Specifications
- Data Type:Integer
- Data Length:1-3
Mapping Information
- REST API Field:validationInformation.bank.accountOwner.overallMatchScore
- SCMP API Field:ecp_avs_overall_match_score
- Simple Order API Field:ecAVSReply_overallMatchScore
validationInformation.bank. accountStatus.
addedOrClosedDate
Date on which the bank account was added or closed.
For closed accounts, this is the date on which the account was closed. For added accounts, this is
the date that the account was added to the National Shared Database.
Format: YYYYMMDD.
Specifications
- Data Type:String
- Data Length:8
Mapping Information
- REST API Field:validationInformation.bank.accountStatus.addedOrClosedDate
- SCMP API Field:ecp_avs_added_or_closed_date
- Simple Order API Field:ecAVSReply_addedOrClosedDate
validationInformation.bank. accountStatus.
additionalStatusCode
Additional status code for the customer's bank account.
The primary, secondary, and additional status codes are automatically determined by
combining the bank account status with information provided by contributing financial
institutions.
Specifications
- Data Type:String
- Data Length:3
Mapping Information
- REST API Field:validationInformation.bank.accountStatus.additionalStatusCode
- SCMP API Field:ecp_avs_additional_status_code
- Simple Order API Field:ecAVSReply_additionalStatusCode
validationInformation.bank. accountStatus. fcraDisputeCode
Code indicating a dispute related to the Fair Credit Reporting Act
(FCRA).
Possible value:
- B9: Consumer information includes a statement of dispute.
Specifications
- Data Type:String
- Data Length:2
Mapping Information
- REST API Field:validationInformation.bank.accountStatus.fcraDisputeCode
- SCMP API Field:ecp_avs_fcra_dispute_code
- Simple Order API Field:ecAVSReply_fcraDisputeCode
validationInformation.bank. accountStatus. lastUpdateDate
Date on which the customer's bank account was
most recently updated in the National
Shared Database.
Format: YYYYMMDD
Specifications
- Data Type:String
- Data Length:8
Mapping Information
- REST API Field:validationInformation.bank.accountStatus.lastUpdateDate
- SCMP API Field:ecp_avs_previous_status_code
- Simple Order API Field:ecAVSReply_previousStatusCode
validationInformation.bank. accountStatus.
previousStatusCode
Status code for the customer's bank account before its most recent
update in the National Shared Database.
Specifications
- Data Type:String
- Data Length:3
Mapping Information
- REST API Field:validationInformation.bank.accountStatus.previousStatusCode
- SCMP API Field:ecp_avs_previous_status_code
- Simple Order API Field:ecAVSReply_previousStatusCode
validationInformation.bank. accountStatus. primaryStatusCode
Primary status code for the customer's bank account.
The primary, secondary, and additional
status codes are automatically determined by combining
the bank account status with
information provided by contributing
financial institutions.
Specifications
- Data Type:String
- Data Length:3
Mapping Information
- REST API Field:validationInformation.bank.accountStatus.primaryStatusCode
- SCMP API Field:ecp_avs_primary_status_code
- Simple Order API Field:ecAVSReply_primaryStatusCode
validationInformation.bank. accountStatus.
scoredAccountProcessorResponse1
Scored account processor response 1.
The value of the field indicates the reason
for the score shown in the primary status
code field.
This value is returned for scored accounts only. A scored account refers to a bank account
residing at a financial institution that does not contribute to the National Shared
Database. Scored Account Reason Codes 1-3 contain the primary reasons that contributed to
the score value in the
validationInformation.bank.accountStatus.primaryStatusCode
field.Specifications
- Data Type:String
- Data Length:2
Mapping Information
- REST API Field:validationInformation.bank.accountStatus.scoredAccountProcessorResponse1
- SCMP API Field:ecp_avs_scored_account_processor_response1
- Simple Order API Field:ecAVSReply_scoredAccountProcessorResponse1
validationInformation.bank. accountStatus.
scoredAccountProcessorResponse2
Scored account processor response 2.
The value of the field
indicates the reason for the score shown in the primary status code field.
validationInformation.bank.accountStatus.primaryStatusCode
field.Specifications
- Data Type:String
- Data Length:2
Mapping Information
- REST API Field:validationInformation.bank.accountStatus.scoredAccountProcessorResponse2
- SCMP API Field:ecp_avs_scored_account_processor_response2
- Simple Order API Field:ecAVSReply_scoredAccountProcessorResponse2
validationInformation.bank. accountStatus.
scoredAccountProcessorResponse3
Scored account processor response 3.
The value of the field indicates the reason
for the score shown in the primary status
code field.
This value is returned for scored accounts only. A scored account refers to a bank account
residing at a financial institution that does not contribute to the National Shared
Database. Scored Account Reason Codes 1-3 contain the primary reasons that contributed to
the score value in the
validationInformation.bank.accountStatus.primaryStatusCode
field.Specifications
- Data Type:String
- Data Length:2
Mapping Information
- REST API Field:validationInformation.bank.accountStatus.scoredAccountProcessorResponse3
- SCMP API Field:ecp_avs_scored_account_processor_response3
- Simple Order API Field:ecAVSReply_scoredAccountProcessorResponse3
validationInformation.bank. accountStatus.
scoredAccountProcessorResponse5
Scored account processor response 5.
Used with scored accounts only. A scored account is a bank account residing at a financial
institution that does not contribute to the National Shared Database. Reason code 5
represents the reason provided to the National Shared Database for one or more incoming
returns.
Specifications
- Data Type:String
- Data Length:2
Mapping Information
- REST API Field:validationInformation.bank.accountStatus.scoredAccountProcessorResponse5
- SCMP API Field:ecp_avs_scored_account_processor_response5
- Simple Order API Field:ecAVSReply_scoredAccountProcessorResponse5
validationInformation.bank. accountStatus.
secondaryStatusCode
Secondary status code for the customer's bank account.
The primary, secondary, and additional status codes are automatically determined by
combining the bank account status with information provided by contributing financial
institutions.
Specifications
- Data Type:String
- Data Length:3
Mapping Information
- REST API Field:validationInformation.bank.accountStatus.secondaryStatusCode
- SCMP API Field:ecp_avs_secondary_status_code
- Simple Order API Field:ecAVSReply_secondaryStatusCode
validationInformation. calculatedResponse
Calculated response based on the business rules provided to Wells Fargo.
Possible values:
- Y: Yes, the account matches your acceptance criteria.
- N: No, the account does not match your acceptance criteria.
- U: Unavailable. There is insufficient data in the National Shared Database to determine whether the account is valid.
Specifications
- Data Type:Enum
- Data Length:1
Mapping Information
- REST API Field:validationInformation.calculatedResponse
- SCMP API Field:ecAVSReply_calculatedResponse
- Simple Order API Field:ecp_avs_calculated_response
validationInformation.referenceID
Reference ID generated to track each request. This ID is returned in the response header.
The reference ID must be a UUID value compliant with RFC 4122.
Specifications
- Data Type:String
- Data Length:36
Mapping Information
- REST API Field:validationInformation.referenceID
- SCMP API Field:ecp_avs_reference_id
- Simple Order API Field:ecAVSReply_referenceID
validationInformation.resultCode
The result code indicates whether high-focus items and duplicate items or participant score
information or both are available (if applicable).
Specifications
- Data Type:String
- Data Length:5
Mapping Information
- REST API Field:validationInformation.resultCode
- SCMP API Field:ecp_avs_result_code
- Simple Order API Field:ecAVSReply_resultCode
validationInformation.transactionReason
Three-character code indicating the reason for the transaction.
This field is generated by combining payment requests such as eCheck debit or credit with
AVS.
This field is mandatory for standalone AVS calls.
Possible values:
- DEP: Deposit.
- ENR: Enrollment for recurring payments.
- PMT: Payment.
Specifications
- Data Type:String
- Data Length:Enum
Mapping Information
- REST API Field:validationInformation.transactionReason
- SCMP API Field:ecp_transaction_reason
- Simple Order API Field:check_transactionReason
validationInformation.validationType
Type of account validation that you are requesting.
Possible values:
- ACCOUNT STATUS (default)
- ACCOUNT OWNERSHIP
If your account is enabled for account
ownership, this field is required.
If your account is enabled for both ownership and status, this field is required whenever
you request ownership.
Specifications
- Data Type:String
- Data Length:17
Mapping Information
- REST API Field:validationInformation.validationType
- SCMP API Field:ecp_avs_validation_type
- Simple Order API Field:ecAVSReply_validationType