FV API Documentation

Description

This API helps to Activate the 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
CARD_NUMBER	16-digit Card Number Example: 1234123412341234	Y*	string Length = 16 digits
ADMIN_NO	Unique Embossing Number Associated to Card Example: 123456	Y*	string Length >= 6 digits
CardSequenceNumber	Sequence Number of the Card Example: 99	N	string Length = 2 digits
ExpirationDate	Expiration Date Printed On Card Example: MMYYYY	Y	string Length = 6 digits
CARDTYPE	Card Type Example: XXXX	N	string Length >= 3
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*)CARD_NUMBER OR ADMIN_NO must be present in Request

Return Values

MessageResponse

Property	Description	Type
ERRMSG	Error message	string Length <= 30
ERR_NUMBER	Error number for the returns message	Numeric Length <= 19
ERROR_FOUND	If any error found, then “Yes” else “No”	string Length <= 3
BSAccountNumber	Account Number Associated to Card	string Length = 16 digits

REST

Method: POST

Urls:

Production:	https://api.fvfn.net/fvfnunvwebapi/core/CardActivation
SandBox:	https://api.firstviewcorp.com/fvfnunvwebapi/core/CardActivation

JSON Request:

{
  "CARD_NUMBER": null,
  "ADMIN_NO": null,
  "CardSequenceNumber": null,
  "ExpirationDate": null,
  "CARDTYPE": null,
  "ANI": null,
  "DNIS": null
}

Response:

{
  "ERROR_FOUND": null,
  "ERR_NUMBER": null,
  "ERRMSG": null,
  "BSAccountNumber": null
}

CardActivation API