FV API Documentation

Description

Using This API, Clients can Retrieve The Saved Token Information Related to Customers

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

TokenID*

-[string(22)]--TokenID. This will be Shared while creatign the Customer Account.

Cardnumber

-[string(22)]--16-Digit Customer Card Number (PAN)

Return Values

MessageResponse

#	Name	Type	Description
1	APIResponseCode	string (MaxLength = 4)	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 = 64)	Unique Tag number for the Response
6	CardTokenID	string (MaxLength = 22)	Unique Token for the Card Number
7	TokenStatus	string (MaxLength = 16)	Status of Given TOken (Active,InActive or Closed)
8	Cardnumberlast4	char[4]	Last Four Digits of the Card Number Associated to Token
9	DDATokenID	char[4]	Last Four Digits of the DDA Number Associated to Token
10	CardExpirationDate	char[4]	Expiration date of the Card (MMYY)
11	CardType	string (MaxLength = 22)	Type of the Payment Network
12	DateOfBirth	string (MaxLength = 8)	Date of Birth Associated to Token in MMDDYYYY Format

REST

Method: POST

Url: TBD

JSON Request:

{
  "TokenID": {},
  "Cardnumber": {}
}

Response:

{
  "Response": {
    "APIResponseCode": {},
    "APIReasonDescription": {},
    "APIResponseDateTime": {},
    "APIUniqueReferenceID": {}
  },
  "Token":{
    "CardTokenID": {},
    "Cardnumberlast4": {},
    "DDATokenID": {},
    "CardExpirationDate": {},
    "CardType": {}
  }
  "TokenStatus": {},
  "DateOfBirth": {}
}

Token LookUP API