1. Home
  2. DebitCard API
  3. CardCreate API

CardCreate API

Last updated: April 15th, 2020

Description

This API helps to Create New 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
AcctCreationDate

Date for Account Creation in MMDDYY

Example: 010190

 Y

string

Length = 6 digits
AcctCreationTime

Time for Account Creation in HHMMSS

Example: 101059

 Y

string

Length = 6 digits
ReferenceNo

ClientSide Unique Reference Number for this account

Example: 12121211515

 Y

string

Length = 23 digits
CurrencyCode

3-Letter Currency Code

Example: USD

 Y

string

Length = 3
Name

First Name of the account holder

Example: JOhn

 Y

string

Length <= 50
MiddleName

First Name of the account holder

Example: David

 N

string

Length <= 50
Name2

Last Name of the account holder

Example: JOhn

 Y

string

Length <= 50
Address1

Address of Account holder without any Special Characters (*NO PO BOX ALLOWED*)

Example: 2000 RiverEdge

 Y

string

Length <= 40
Address2

Additional Address of Account holder without any Special Characters (*NO PO BOX ALLOWED*)

Example: S580

 N

string

Length <= 40
State

State the address belongs to

Example: GA

 Y

string

Length = 2
City

City the address belongs to

Example: Atlanta

 Y

string

Length <= 40
GovtIdType

Type of Government ID Proof

Following are various Options:

  • 01 = SSN
  • 02 = Drivers license #
  • 03 = Matricular #
  • 04 = Passport
  • 05 = Visa
  • 06 = Green Card
  • 07 = State ID
  • 08 = Military ID
  • 09 = Voters Registration Card
  • 10 = Government ID
  • 11 - Tax Identification Number

 Y

string

Length = 2
GovtIdIssueState

State where the ID is issued, (Valid only for options GovtIdType 02 & 07 and Counties US & CANADA)

Example: GA

 Y

string

Length = 2
PostalCode

Postal Code the address belongs to

Example: 12345 or 12345-1234

 Y

string

Length = 10
ConuntryOfIssue

Country where the ID is issued

Example: USA

 Y

string

Length = 15
AccountType

Individual or Business

I - Individual

 Y

string

Length = 1
EmailId

Email of Account Holder for communications

Example: abc@abc.com

 Y

string

Length <= 100
GovtId

Govt. ID number

Example: DL1234566

 Y

string

Length <= 25
PhoneNumber

Account Holder Phone Number

Example: 1234567890

 Y

string

Length = 10
Comment

Other Special Notes

Example: Special Request Account

Y

string

Length <= 50
DateOfBirth

Account Holder Date of Birth in MMDDYYYY Format

Example: 01011970

Y

string

Length = 10
ProductId

Unique Product Reference Number issued by FirstView

Example: 54321

Y

string

Length <= 10
WorkPhoneNumber

Account Holders work Phone Number if any

Example: 1234567890

N

string

Length = 10
MobilPhoneNumber

Account Holders Mobile Phone Number if any

Example: 1234567890

N

string

Length = 10
OtherPhoneNumber

Account Holders any other Phone Number

Example: 1234567890

N

string

Length = 10
FollowUpDate

Follow-Up date in MMDDYYYY format

Example: 01011970

N

string

Length = 10
Employername

Name of Employer if Any

Example: FirstView

N

string

Length <= 50
EmployerContactName

Employer Contact Person Name

Example: John Smith

N

string

Length <= 50
EmployerContactPhoneNumber

Employer Contact Person Phone Number

Example: 1234567890

N

string

Length = 10
EmployerContactFax

Employer Contact Person Fax Number

Example: 1234567890

N

string

Length = 10
Memos

Memo Statemet for Account

Example: Test Account

N

string

Length <= 200
CustRefName

Referral Name

Example: John Smith

 N

string

Length <= 40
SotreName

Unique Store Name Provided by FirstView

Example: Test Store

 Y*

string

Length <= 10
GovtIdIssueDate

Issue Date for Govt. ID in MMDDYYYY (except for ID No 08,09,11)

Example: 01011970

 Y

string

Length = 8
GovtIdExpirationDate

Expiration Date for Govt. ID in MMDDYYYY (except for ID No 09,11)

Example: 01011970

 Y

string

Length = 8
GovtIdCountryOfIssuance

Country of Govt. ID issued(except for ID No 11)

Example: USA

 Y

string

Length <= 5
cipType

cip Type Typically 'D' - Document

Example: D

 Y

string

Length = 1
cipNumber

cip verification Number

Example: X123455

 N

string

Length <= 15
cipStatus

cip verification Status (Y /N)

Example: Y

 N

string

Length = 1
ssn

Social Security Number

Example: 123456789

 Y

string

Length = 9 - digits
EmbossingLine4

Text in Embossing Line

Example: Sample Text

 N

string

Length <= 26
EmbossingHotStamp

Text in Embossing Hot Stamp

Example: Sample Text

 N

string

Length <= 30
SecondaryPan

Funder Accounter Number

Example: 1234123412341234

 N

string

Length = 16-digits

Note:

Additional Notes on Input Field

  1. If Government ID is “02 - Driving License #”, then the ID Number, ID Issue Date, ID Expiration Date, ID Issue Country, and ID Issue State (State is required only if Driver’s License issued in US/ Canada) will be mandatory.
  2. If Government ID is “03 - Matricular”, then the ID Number, ID Issue Country, ID Issue Date and ID Expiration Date will be mandatory.
  3. If Government ID is “04 - Passport”, then the ID Number, ID Issue Country, ID Issue Date, ID Expiration Date will be mandatory.
  4. If Government ID is “05 - Visa”, then the ID Number, Issue Country ID, Issue Date, ID Expiration Date will be mandatory.
  5. If Government ID is “06 - Green Card”, then the ID Number, ID Issue Country, ID Issue Date, ID Expiration Date will be mandatory.
  6. If Government ID is “07 - State ID”, then the ID Number, ID Issue Country and ID Issue State (State is required only if Drivers License issued in US/ Canada) will be mandatory, ID Issue Date, ID Expiration Date.
  7. If Government ID is “08 - Military ID”, then the ID Number, ID Issue Country, ID Expiration Date will be mandatory.
  8. If Government ID is “09 - Voters Registration Card”, then the ID Number and ID Issue Country will be mandatory.
  9. If Government ID is “10 - Government ID”, then the ID Number, ID Issue Country, ID Issue Date, ID Expiration Date will be mandatory.
  10. If Government ID is “11 - Tax Identification Number”, then the ID Number is mandatory
  11. Country of Issue will accept both US and USA for United States.

Return Values

MessageResponse

Property Description Type

ReasonDescription

Error message

string

Length <= 30

ResponseCode

Error number for the returns message (Successful = 1 ; Otherthan 1 incase of Failure)

Numeric

Length <= 19

RequestType

Type of Request ( = 1)

string

ProductType

Product Type ( = P)

string

SubProductType

Sub Product Type ( = 1)

string

FromCardRange

Not a Valid Filed

string

ToCardRange

Not a Valid Filed

string

Account Number

System Generated New Account Number

string

DdaNo

System Generated Direct Deposit Account Number

string

Pan

Last 4-digits of the Card Number

string

SecondaryPan

Not a Valid Field

string

AccountCreationDate

Date when the Account is created

string

AccountCreationTime

Time when Account is created

string

Amount

Not a Valid Field

string

ReferenceNo

Not a Valid Field

string

ExpirationDate

Not a Valid Field

string

CurrencyCode

Fund Currency Code (840 = $)

string

MerchantGroup

Not a Valid Field

string

Mcc

Not a Valid Field

string

GovernmentIdType

Govt.Id Type

string

GovernmentId

Govt.Id

string

TerminalId

Terminal Where the Account Creation Request Initiated ( = WEB)

string

StoreName

Name of the Store Provided in Request

string

REST

Method: POST

Urls:

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

JSON Request:
{
  "RecordType": null,
  "RecordNumber": null,
  "RequestType": null,
  "ProductType": null,
  "SubProductType": null,
  "FromCardRange": null,
  "ToCardRange": null,
  "PAN": null,
  "SecondaryPAN": null,
  "AccountCreationDate": null,
  "AccountCreationTime": null,
  "Amount": null,
  "ReferenceNo": null,
  "ExpirationDate": null,
  "CurrencyCode": null,
  "MerchantGroup": null,
  "MCC": null,
  "TerminalID": null,
  "AccountType": null,
  "Name1": null,
  "Name2": null,
  "Address1": null,
  "Address2": null,
  "City": null,
  "State": null,
  "PostalCode": null,
  "GovernmentIDType": null,
  "GovernmentID": null,
  "CountryOfIssue": null,
  "PhoneNumber": null,
  "WorkPhoneNumber": null,
  "MobilePhoneNumber": null,
  "OtherPhoneNumber": null,
  "EmailID": null,
  "EmailTwo": null,
  "DateOfBirth": null,
  "BankRouting": null,
  "BankAcctNumber": null,
  "Comment": null,
  "PIN": null,
  "KeyLabel": null,
  "Filler": null,
  "ProductId": null,
  "FollowUpDate": null,
  "Employername": null,
  "EmployerContactName": null,
  "EmployerContactPhoneNumber": null,
  "EmployerContactFaxNumber": null,
  "Memos": null,
  "CustRefName": null,
  "StoreName": null,
  "GovtIDIssueDate": null,
  "GovtIDExpirationDate": null,
  "GovtIDCountryofIssuance": null,
  "CIPType": null,
  "CIPNumber": null,
  "CIPStatus": null,
  "GovtIDIssueState": null,
  "SSN": null,
  "TaxId": null,
  "DeliveryMechanism": null,
  "EmbossingLine4": null,
  "OtherIDDescription": null,
  "EmbossingHotStamp": null,
  "Title": null,
  "SecondLastName": null,
  "NameOnCard": null,
  "MotherMaidenName": null,
  "HomeFaxNumber": null,
  "WorkFaxNumber": null,
  "LanguageIndicator": null,
  "MiddleName": null
}
Response:
{
  "RequestType": null,
  "ProductType": null,
  "SubProductType": null,
  "FromCardRange": null,
  "ToCardRange": null,
  "PAN": null,
  "SecondaryPAN": null,
  "AccountCreationDate": null,
  "AccountCreationTime": null,
  "Amount": null,
  "ReferenceNo": null,
  "ExpirationDate": null,
  "CurrencyCode": null,
  "MerchantGroup": null,
  "MCC": null,
  "GovernmentIDType": null,
  "GovernmentID": null,
  "TerminalID": null,
  "StoreName": null,
  "ResponseCode": null,
  "ReasonDescription": null,
  "AccountNumber": null,
  "DDA_NO": null
}

Contact US

E-Mail:

info@fvfn.com

Address:

2000 Riveredge PKWY, Suite 580, Georgia - 30328