Using This API, Clients can Pull Funds from their Customer Accounts.
null Values will Not be Accepted For * Marked Parameters in the Request Message
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
CardTokenID*
-[string(22)]--CardTokenID. FirstView issued Token ID for the card number. This will be Shared while creating the Customer Account.
AccountID
-[string(32)]--Unique account/customer id for the merchant/partner. If account id for the partner is already exist in the system it will append the card number as a secondary card
CenterID
-[string(5)]--Clients CenterID
MerchantReferenceId*
-[string(50)]--Merchant-generated transaction reference or tracking number. FirstView recommends that you send a unique value for each transaction so that you can perform meaningful searches for the transaction
TranType*
-[integer(1)]--Type of Transaction
TranType = 1 -> Sale
TranType = 2 -> Auth
TranType = 3 -> Capture
TranType = 4 -> Auth Reversal
TranType = 5 -> Refund
TranAmount*
-[string(16)]--Grand total for the transaction. This value cannot be negative.
You can include a decimal point (.), but you cannot include any other special
characters. System truncates the unit to the correct number of decimal places.
*For Type 3, enter 0.0 for full capture or enter specific amount for Partial
Capturing
*For Type 4, enter 0.0 for full reversal or enter specific amount for
Partial Reversal
*For Type 5, enter 0.0 for full refund or enter specific amount for Partial
Refund
TranDescriptor*
-[string(22)]--Transaction description appears on cardholder statement
TransactionReferenceID**
-[string(32)]--Populate this with API unique reference ID Issued by Firstview
via previous calls for the same account. Inorder to make a connection between
current transaction and any previous transaction.
**This field is mandatory for Transaction Types 3, 4 and 5.
**Best Example is Txn1 was an Auth for $10.02, and Txn2 came to capture the
funds Authorised in Txn1. So Txn2 require to fill in this field with Txn1's API
Unique Reference ID.
CardCVV**
-[string(3)]--CVV of the card associated with the
Token
**This field is mandatory for Transaction Types 1 and 2
Firstname*
-[string(50)]--Cardholder's First Name
Lastname*
-[string(50)]--Cardholder's Last Name
AddressLine1
-[string(50]--Cardholder's current Address for Communication line 1
AddressLine2
-[string(50)]--Cardholder's current Address for Communication line 2
City
-[string(25)]--City in which current address located
State
-[string(2)]--State (2-Letter Code) in which current address is located
PostalCode
-[string(10)]--Postal Code for given address
Country
-[string(3)]--Country in which current address located
Phonenumber*
-[string(15)]--Cardholder's Phone number for communication
DOB
-[string(10)]--Card Holder's Date Of Birth in MM-DD-YYYY or MM/DD/YYYY format
Email*
-[string(100)]--Card Holder's Email ID for communication
MessageResponse
# | Name | Type | Description |
---|---|---|---|
1 | APIResponseCode | string (MaxLength = 6) | Response Code for the Request |
2 | APIReasonDescription | string (MaxLength = 64) | Description of the Response Message |
3 | APIResponseDateTime | Datetime | Time at the API Response Generated |
4 | APIUniqueReferenceID | string (MaxLength = 32) | Unique Tag number for the Response |
5 | Type | string | Type of Response |
6 | TokenID | string (MaxLength = 22) | Unique Token for the Card Number |
7 | Cardnumberlast4 | string[4] | Last Four Digits of the given Card Number |
8 | TranAmount | string (MaxLength = 16) | Transaction amount |
9 | AccountID | string (MaxLength = 32) | Unique account/customer id for the merchant/partner. If account id for the partner already exist in the system it will append the card number as a secondary card. |
10 | CenterID | string (MaxLength = 5) | Client's Center ID that Initiated the Transaction. |
11 | MerchantReferenceId | string (MaxLength = 50) | Merchant-generated transaction reference or tracking number |
Method: POST
Url: TBD
{
"CardTokenID": {},
"AccountID": {},
"CenterID": {},
"MerchantReferenceId": {},
"TranType": {},
"TransactionReferenceID": {},
"TranAmount": {},
"TranDescriptor": {},
"CardCVV": {},
"Billing": {
"Address": {
"Addressline1": {},
"Addressline2": {},
"City": {},
"State": {},
"Country": {},
"PostalCode": {}
},
"Name": {
"FirstName": {},
"LastName": {}
},
"DOB": {},
"PhoneNumber": {},
"Email": {}
}
}
{
"Response": {
"APIResponseCode": {},
"APIReasonDescription": {},
"APIResponseDateTime": {},
"APIUniqueReferenceID": {},
"Type": {}
},
"TokenID": {},
"Cardnumberlast4": {},
"TranAmount": {},
"AccountID": {},
"CenterID": {},
"MerchantReferenceId": {}
}
E-Mail:
info@fvfn.com
Address:
2000 Riveredge PKWY, Suite 580, Georgia - 30328