ValidateBusinessAccounts API
Description
This API helps to Validate the MicroDeposits Made to External Bank Account (Recipient).
Request Parameters
Y = Required, Y* = Conditional, X = Required When Block Present and N = Optional
APIAccessToken*
-[string(256)]--Issued by FirstView web services authorization call. Auth Token is valid for 24 hours and is required to obtain a new token prior to the expiration. Has to be send in the "Authorization" Header when making the requests
| Property | Description | Required | Type |
|---|---|---|---|
| IPAddress |
Source IP Address in xxx.xxx.xxx.xxx format Example: 123.123.123.123 |
N |
string Length <= 15 |
| UniqueIDFlag |
Reserved for future use |
N |
string Length = 1 digit |
| UniqueID |
Reserved for future use |
N |
string Length <= 19 |
| Source |
Source from where API Call is initiated. FirstView have multiple value of source for internal system Example: WEB |
Y |
string Length <= 10 |
| APIVersion |
Version of the API to be invoked. Please refer API Version mentioned in document header. It’s default value is 1.0 Example: 1.0 |
N |
string Length <= 10 |
| ApplicationVersion |
Reserved for future use |
N |
string Length <= 100 |
| CallerID |
Reserved for future use |
N |
string Length <= 20 |
| SessionID |
Reserved for future use |
N |
string Length <= 8 |
| RequestDate |
Date of Request in YYYY-MM-DD hh:mm:ss format Example: 1970-01-01 10:10:59 |
N |
string Length <= 19 |
| RecipientID |
UniqueID of Recipient Bank |
Y |
string Length <= 10 - digits |
| MicroDeposit1 |
Micro Deposit Amount 1 (It validates Micro deposit transaction.) Example: 1.21 |
Y |
currency |
| MicroDeposit2 |
Micro Deposit Amount 2 (It validates Micro deposit transaction.) Example: 1.01 |
Y |
currency |
| Language |
Communication Language Example: EN,ES etc. |
N |
string Length = 2 |
| ANI |
ANI Number, Used for reporting and error tracking |
N |
string Length <= 30 |
| DNIS |
DNIS Number, Used for reporting and error tracking |
N |
string Length <= 30 |
Return Values
MessageResponse
| Property | Description | Type |
|---|---|---|
|
ErrorMessage |
Error message |
string |
|
ErrorNumber |
Error number for the returns message |
Numeric Length <= 10 |
|
ErrorFound |
If any error found, then “Yes” else “No” |
string Length <= 3 |
|
BankAccountStatus |
Bank Status |
string Length <= 25 |
|
ValidationTriesCount |
It gives how many times validation is tried. |
string Length <= 5 digit |
REST
Method: POST
Urls:
| Production: | https://api.fvfn.net/fvfnunvwebapi/ACH/ValidateBusinessAccounts |
| SandBox: | https://api.firstviewcorp.com/fvfnunvwebapi/ACH/ValidateBusinessAccounts |
JSON Request:
{
"IPAddress": null,
"UniqueIDFlag": null,
"UniqueID": null,
"Source": null,
"APIVersion": null,
"ApplicationVersion": null,
"CallerID": null,
"SessionID": null,
"ANI": null,
"DNS": null,
"Language": null,
"RequestDate": null,
"RecipientID": null,
"MicroDeposit1": null,
"MicroDeposit2": null
}
Response:
{
"ErrorMessage": null,
"ErrorNumber": null,
"ErrorFound": null,
"BankAccountStatus": null,
"ValidationTriesCount": null
}