BankToCardAccount API
Description
This API helps to Request Funds from External Bank Account to Card.
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 |
| CardNumber |
16-digit Card Number Example: 1234123412341234 |
Y* |
string Length = 16 digits |
| AccountNumber |
19-digit Account Number Example: 1234123412341234123 |
Y* |
string Length = 19 digits |
| TokenID |
Firstview Issued Unique Reference Number for Card Example: 1234123412341234 |
Y* |
string Length = 16 digits |
| TransactionAmount |
Amount to be Transfered Example: 1234.21 |
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 |
Note:
(Y*)either CardNumber or AccountNumber or TokenID must be present in request
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 |
TransactionID |
Credit Transaction ID |
string Length <= 19 digit |
REST
Method: POST
Urls:
| Production: | https://api.fvfn.net/fvfnunvwebapi/ACH/BankToCardAccount |
| SandBox: | https://api.firstviewcorp.com/fvfnunvwebapi/ACH/BankToCardAccount |
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,
"CardNumber": null,
"AccountNumber": null,
"TokenID": null,
"TransactionAmount": null
}
Response:
{
"ErrorMessage": null,
"ErrorNumber": null,
"ErrorFound": null,
"TransactionID": null
}