Update Token API
Description
Using This API, Clients can Update 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
TokenID*
-[string(22)]--TOkenID. This will be Shared while creating the Customer Account.
TokenStatus
-[string(16)]--Desired Token Status. Token Status can be Changed from Active to Inactive or Closed, Incative to Active or Closed. A Closed token can not be Activated or Inactivated
AccountID*
-[string(32)]--Unique account/customer id for the merchant/partner.
ReasonDescription
-[string(32)]--Reason for Updating the Token Information.
CardExpirationDate
-[char(4)]--Card expiray date, MMYY
Firstname
-[string(32)]--Customer's First Name
Lastname
-[string(32)]--Customer's Last Name
Addressline1
-[string(64)]--Customer's current Address for Communication line 1
Addressline2
-[string(64)]--Customer's current Address for Communication line 2
City
-[string(32)]--City in which current the address located
State
-[char(2)]--State (2-Letter Code) in which current address is located
PostalCode
-[string(10)]--Postal Code for given address
Country
-[char(2)]--Country in which current the address located
-[string(64)]--Customer's Email for communication
Phonenumber1
-[string(16)]--Customer's 1st Phonenumber for communication
Phonenumber2
-[string(16)]--Customer's alternative Phonenumber for communication
DateOfBirth
-[char(8)]--Customer's DateOfBirth in MMDDYYYY format
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 |
| 5 | TokenID | string (MaxLength = 22) | Unique Token for the Card Number |
REST
Method: POST
Url: TBD
JSON Request:
{
"TokenID": {},
"TokenStatus": {},
"AccountID": {},
"ReasonDescription": {},
"CardExpirationDate": {},
"Name": {
"Firstname": {},
"Lastname": {}
},
"Address": {
"Addressline1": {},
"Addressline2": {},
"City": {},
"State": {},
"PostalCode": {},
"Country": {}
},
"Email": {},
"Phone": {
"Phonenumber1": {},
"Phonenumber2": {}
},
"DateOfBirth": {}
}
Response:
{
"Response": {
"APIResponseCode": {},
"APIReasonDescription": {},
"APIResponseDateTime": {},
"APIUniqueReferenceID": {}
},
"TokenID": {}
}