Process Transaction API

Last updated: March 4th, 2020

Description

Using This API, Clients can Pull Funds from their Customer Accounts.

Parameters

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

Return Values

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

REST

Method: POST

Url: TBD

JSON Request:
{
  "CardTokenID": {},
  "AccountID": {},
  "CenterID": {},
  "MerchantReferenceId": {},
  "TranType": {},
  "TransactionReferenceID": {},
  "TranAmount": {},
  "TranDescriptor": {},
  "CardCVV": {},
  "Billing": {
    "Address": {
      "Addressline1": {},
      "Addressline2": {},
      "City": {},
      "State": {},
      "Country": {},
      "PostalCode": {}
    },
    "Name": {
      "FirstName": {},
      "LastName": {}
    },
    "DOB": {},
    "PhoneNumber": {},
	"Email": {}
  }
}

Response:
{
  "Response": {
    "APIResponseCode": {},
    "APIReasonDescription": {},
    "APIResponseDateTime": {},
    "APIUniqueReferenceID": {},
	"Type": {}
  },
  "TokenID": {},
  "Cardnumberlast4": {},
  "TranAmount": {},
  "AccountID": {},
  "CenterID": {},
  "MerchantReferenceId": {}
}

Contact US

E-Mail:

info@fvfn.com

Address:

2000 Riveredge PKWY, Suite 580, Georgia - 30328