Virtual Card-SVC/LVC

post https://uatmea-iss-apigw.creditpluspinelabs.com/deviceapi/apis/v1/services/cardholder/virtualCardIssuance

This API is used for virtual card issuance. It is applicable for prepaid, credit and debit products issued on Pine Labs platform. Third party enables the virtual card issuance service to a cardholder using API resource. Cardholder can issue the static and limited validity virtual card using this service. In case of credit card issuance, the scoring and other application processes are not applicable through API channel. This gets the minimum limit that the bank had configured on virtual device issuance plan. The card is immediately issued to the cardholder.

Card Number Alias(CNA) processing logic for prepaid products- Institution level uniqueness

If the system locates a device with status code as Normal (0), then that device is used for processing the request.
If the CNA is linked to multiple devices with status code as Normal (0), the request is rejected.
If the system does not find any device with status code as Normal (0), then the system tries to search the CNA at institutional level. If found, the latest device (based on Opening Date and Date Create) linked to the CNA is used for further processing the request.
Ifthe latest device isfound as Replaced, then the system searchesfor the updated device to process the request.

Card Number Alias(CNA) processing logic for prepaid products- Device level uniqueness

If the system locates a device with status code as Normal (0), then that device is used for processing the request.
If the CNA is linked to multiple devices with status code as Normal (0), the request is rejected.
If the system does not find any device with status code as Normal (0), the system tries to search the CNA at institutional level.
If the uniqueness is configured at device plan level, then the system checks if the Existing Device Plan Code and Existing Program Code fields are present in the API request. Else the request is rejected.
If the Existing Device Plan Code and Existing Program Code fields are present in the API request, the system tries to locate the CNA linked to a latest device. If found, the latest device (based on Opening Date and Date Create) linked to the CNA is used for further processing the request.
Ifthe latest device isfound as Replaced, then the system searchesfor the updated device to process the request.

HTTP Status and Response Status Matrix

HTTP Code: This is the response status code issued by a server in response to a client's request made to the server.
Error Code: This is the error code returned by Credit+ Issuing application in the ‘code’ field of the response message indicating if the request was processed successfully or failed.
Reason: This is the description of the error code returned by Credit+ Issuing application.

HTTP Code	Error Code	Reason
201	CREDEV000	Request processed successfully.
400	997	Commodity Unit Price field value must have max length 20.
400	997	Certificate Number field value must have max length 50.
400	997	Commodity Unit Quantity field value must have max length 12.
400	997	Commodity Type field value must have max length 10.
400	997	Certificate Number field should be alphanumeric.
400	997	Commodity Unit Price Must be a positive value with maximum 12 integers and 7 fractions.
400	997	Commodity Unit Quantity field value must be a number and greater than zero.
400	997	Commodity Type field should be alphanumeric.
400	997	Application Type field is invalid.
400	997	clientCustomerID field value must have max length 20.
400	997	clientCustomerID field should be alphanumeric.
400	997	clientCustomerID must be null for application type other than 1 and 4.
400	997	Client Customer ID field must be null for existing client.
400	BUS159	CLIENT_CUSTOMER_ID is mandatory.
400	VRCD001	No data found in API_BULK_REQUEST for transaction counter.
400	VRCD002	Exception when fetching data from API_BULK_REQUEST for transaction counter.
400	VRCD003	Error while executing Virtual CardRequest API.
400	CREDEV013	Invalid Gender.
400	CREDEV001	Error: Fetching Virtual device for program failed.
400	CREDEV002	Product type not define for program.
400	CREDEV003	Client not found.
400	CREDEV004	Batch is not getting generated through SVC API.
400	CREDEV005	SVC OR LVC device creation has failed due to internal error. Please contact the system admin.
400	CREDEV006	Create Client Failed For job id.
400	CREDEV007	Error WHILE Inserting Client Event Def For Client.
400	CREDEV008	Error while creating wallets for device.
400	CREDEV009	Error WHILE Fetching DEVICE_WALLET_LINK.
400	CREDEV010	Error WHILE creating devices FOR personalised cards for device.
400	CREDEV011	Error while creating devices wallet LINK for personalised cards.
400	CREDEV012	Error While processing request.
400	CREDEV015	Initial Load not allowed for credit and debit virtual device.
400	CFUERR030	Error while processing issue personalised device request.
400	997	Application Type field is mandatory.
400	997	Program Code field is mandatory.
400	997	Primary Device Number field is mandatory.
400	997	Preferred Mailing Address field must be null for existing client.
400	997	KYC Status field must be null for existing client.
400	997	KYC Remark field must be null for existing client.
400	997	Preferred Mailing Address is mandatory.
400	997	Preferred Mailing Address field is invalid.
400	997	KYC Status field is invalid.
400	997	Language Preference field is mandatory.
400	997	Language Preference field value must be alphabets in lower case.
400	997	Language Preference field value must have size 2.
400	997	Title field must be null for existing client.
400	997	First Name field must be null for existing client.
400	997	Middle Name1 field must be null for existing client.
400	997	Middle Name2 field must be null for existing client.
400	997	Last Name field must be null for existing client.
400	997	Marital Status field must be null for existing client.
400	997	Maiden Name field must be null for existing client.
400	997	VIP Flag field must be null for existing client.
400	997	Gender field must be null for existing client.
400	997	Birth Date field must be null for existing client.
400	997	Birth City field must be null for existing client.
400	997	Birth Country field must be null for existing client.
400	997	Nationality Code field must be null for existing client.
400	997	Education field must be null for existing client.
400	997	Maiden Name field is mandatory.
400	997	VIP Flag field is invalid.
400	997	Education field should be numeric.
400	997	Title field is invalid.
400	997	First Name field is mandatory.
400	997	First Name field value must be alphabets and without space.
400	997	First Name field value must have max length 100.
400	997	Middle Name1 field value must be alphabets and without space.
400	997	Middle Name1 field value must have max length 100.
400	997	Middle Name2 field value must be alphabets and without space.
400	997	Middle Name2 field value must have max length 100.
400	997	Last Name field value must be alphabets and without space.
400	997	Last Name field value must have max length 100.
400	997	Marital Status field is mandatory.
400	997	Marital Status field is invalid.
400	997	Maiden Name field value must be alphabets and without space.
400	997	Maiden Name field value must have max length 50.
400	997	Gender field is mandatory.
400	997	Birth Date field is mandatory.
400	997	Birth Date field must be in yyyyMMdd format.
400	997	Birth City field value must have max length 50.
400	997	Birth Country field value must have max length 3.
400	997	Nationality Code field value must have max length 3.
400	997	Permanent Address1 field value must have max length 150.
400	997	Permanent Address2 field value must have max length 150.
400	997	Permanent Address3 field value must have max length 150.
400	997	Permanent Address4 field value must have max length 150.
400	997	Permanent Contact No1 field value must have max length 15.
400	997	Permanent Contact No2 field value must have max length 15.
400	997	Office Address1 field value must have max length 150.
400	997	Office Address2 field value must have max length 150.
400	997	Office Address3 field value must have max length 150.
400	997	Office Address4 field value must have max length 150.
400	997	Office Contact No1 field value must have max length 15.
400	997	Office Contact No2 field value must have max length 15.
400	997	Current Address1 field value must have max length 150.
400	997	Current Address2 field value must have max length 150.
400	997	Current Address3 field value must have max length 150.
400	997	Current Address4 field value must have max length 150.
400	997	Current Contact No1 field value must have max length 15.
400	997	Current Contact No2 field value must have max length 15.
400	997	Employee ID field must be null for existing client.
400	997	Designation field must be null for existing client.
400	997	Department field must be null for existing client.
400	997	Job Tenure Year field must be null for existing client.
400	997	Joining Date field must be null for existing client.
400	997	Employer Name field must be null for existing client.
400	997	Occupation Type field must be null for existing client.
400	997	Employer Type field must be null for existing client.
400	997	Employment Status field must be null for existing client.
400	997	Designation field should be numeric.
400	997	Joining End Date field must be in ddMMyyyy format.
400	997	Occupation Type field should be numeric.
400	997	Occupation Type field value must have size 1.
400	997	Employer Type field should be numeric.
400	997	Employer Type field value must have max length 20.
400	997	Employment Status field should be numeric.
400	997	Fax Number field must be null for existing client.
400	997	Register Mobile ISDN Code field must be null for existing client.
400	997	Registered Mobile Number field must be null for existing client.
400	997	Registered e-mail ID field must be null for existing client.
400	997	Register for DNCR field must be null for existing client.
400	997	SMS Alert field must be null for existing client.
400	997	Email Alert field must be null for existing client.
400	997	Statement Copy Mode field must be null for existing client.
400	997	Register for DNCR field is invalid.
400	997	Fax Number field value must have max length 15.
400	997	Register Mobile ISDN Code field value must have max length 15.
400	997	Registered Mobile Number field Is mandatory.
400	997	Registered e-mail ID field is mandatory.
400	997	Register Mobile Number field value must have max length 15.
400	997	Registered e-mail ID field value must have max length 50.
400	997	Registered e-mail ID field must be a valid email id.
400	997	Registered e-mail ID field is invalid.
400	997	Registered Mobile Number field is invalid.
400	997	Registered Mobile ISDN Code field is invalid.
400	997	Statement Copy Mode field is invalid.
400	997	Legal Id Type1 field value must have max length 30.
400	997	Legal Id Type2 field value must have max length 30.
400	997	Legal Id Type3 field value must have max length 30.
400	997	Legal Id Type4 field value must have max length 30.
400	997	Legal Id Type1 and Legal Id Type2 are same.
400	997	Legal Id Type1 and Legal Id Type3 are same.
400	997	Legal Id Type1 and Legal Id Type4 are same.
400	997	Legal Id Type2 and Legal Id Type3 are same.
400	997	Legal Id Type2 and Legal Id Type4 are same.
400	997	Legal Id Type3 and Legal Id Type4 are same.
400	997	Legal Id1 field is mandatory.
400	997	Legal Id1 field value must have max length 25.
400	997	Legal Id2 field is mandatory.
400	997	Legal Id2 field value must have max length 25.
400	997	Legal Id3 field is mandatory.
400	997	Legal Id3 field value must have max length 25.
400	997	Legal Id4 field is mandatory.
400	997	Legal Id4 field value must have max length 25.
400	997	Legal ID1 PlaceOfIssuance field value must have max length 15.
400	997	Legal ID2 PlaceOfIssuance field value must have max length 15.
400	997	Legal ID3 PlaceOfIssuance field value must have max length 15.
400	997	Legal ID4 PlaceOfIssuance field value must have max length 15.
400	997	Legal ID1 Expiry Date field must be in ddMMyyyy format.
400	997	Legal ID2 Expiry Date field must be in ddMMyyyy format.
400	997	Legal ID3 Expiry Date field must be in ddMMyyyy format.
400	997	Legal ID4 Expiry Date field must be in ddMMyyyy format.
400	997	Wallet Currency 1 field should be numeric.
400	997	Wallet Currency 2 field should be numeric.
400	997	Wallet Currency 3 field should be numeric.
400	997	Wallet Currency 4 field should be numeric.
400	997	Wallet Currency 5 field should be numeric.
400	997	Wallet Currency 1 field value must have size 3.
400	997	Wallet Currency 2 field value must have size 3.
400	997	Wallet Currency 3 field value must have size 3.
400	997	Wallet Currency 4 field value must have size 3.
400	997	Wallet Currency 5 field value must have size 3.
400	997	Wallet Priority 1 field is mandatory.
400	997	Wallet Priority 3 field is mandatory.
400	997	Wallet Priority 4 field is mandatory.
400	997	Wallet Priority 5 field is mandatory.
400	997	Wallet Priority 1 and Wallet Priority 2 are same.
400	997	Wallet Priority 1 and Wallet Priority 3 are same.
400	997	Wallet Priority 1 and Wallet Priority 4 are same.
400	997	Wallet Priority 2 and Wallet Priority 3 are same.
400	997	Wallet Priority 2 and Wallet Priority 4 are same.
400	997	Wallet Priority 2 and Wallet Priority 5 are same.
400	997	Wallet Priority 3 and Wallet Priority 4 are same.
400	997	Wallet Priority 4 and Wallet Priority 5 are same.
400	997	Client Data Field1 field must be null for existing client.
400	997	Client Data Field2 field must be null for existing client.
400	997	Client Data Field3 field must be null for existing client.
400	997	Client Data Field4 field must be null for existing client.
400	997	Client Data Field5 field must be null for existing client.
400	997	Client Date Field1 field must be null for existing client.
400	997	Client Date Field2 field must be null for existing client.
400	997	Client Date Field3 field must be null for existing client.
400	997	Client Date Field4 field must be null for existing client.
400	997	Client Date Field5 field must be null for existing client.
400	997	Client Amount Field1 field must be null for existing client.
400	997	Client Amount Field2 field must be null for existing client.
400	997	Client Amount Field3 field must be null for existing client.
400	997	Client Amount Field4 field must be null for existing client.
400	997	Client Amount Field5 field must be null for existing client.
400	997	Client Data Field1 field value must have max length 100.
400	997	Client Data Field2 field value must have max length 100.
400	997	Client Data Field3 field value must have max length 100.
400	997	Client Data Field4 field value must have max length 100.
400	997	Client Data Field5 field value must have max length 100.
400	997	Client Date Field1 field must be in yyyyMMdd format.
400	997	Client Date Field2 field must be in yyyyMMdd format.
400	997	Client Date Field3 field must be in yyyyMMdd format.
400	997	Client Date Field4 field must be in yyyyMMdd format.
400	997	Client Date Field5 field must be in yyyyMMdd format.
400	997	Client Amount Field1 field must be a positive value with maximum 9 integers and 2 fractions.
400	997	Client Amount Field2 field must be a positive value with maximum 9 integers and 2 fractions.
400	997	Client Amount Field3 field must be a positive value with maximum 9 integers and 2 fractions.
400	997	Client Amount Field4 field must be a positive value with maximum 9 integers and 2 fractions.
400	997	Client Amount Field5 field must be a positive value with maximum 9 integers and 2 fractions.
400	997	Wallet Data Field1 field must be null for existing client.
400	997	Wallet Data Field2 field must be null for existing client.
400	997	Wallet Data Field3 field must be null for existing client.
400	997	Wallet Data Field4 field must be null for existing client.
400	997	Wallet Data Field5 field must be null for existing client.
400	997	Wallet Date Field1 field must be null for existing client.
400	997	Wallet Date Field2 field must be null for existing client.
400	997	Wallet Date Field3 field must be null for existing client.
400	997	Wallet Date Field4 field must be null for existing client.
400	997	Wallet Date Field5 field must be null for existing client.
400	997	Wallet Amount Field1 field must be null for existing client.
400	997	Wallet Amount Field2 field must be null for existing client.
400	997	Wallet Amount Field3 field must be null for existing client.
400	997	Wallet Amount Field4 field must be null for existing client.
400	997	Wallet Amount Field5 field must be null for existing client.
400	997	Wallet Data Field1 field value must have max length 100.
400	997	Wallet Data Field2 field value must have max length 100.
400	997	Wallet Data Field3 field value must have max length 100.
400	997	Wallet Data Field4 field value must have max length 100.
400	997	Wallet Data Field5 field value must have max length 100.
400	997	Wallet Date Field1 field must be in yyyyMMdd format.
400	997	Wallet Date Field2 field must be in yyyyMMdd format.
400	997	Wallet Date Field3 field must be in yyyyMMdd format.
400	997	Wallet Date Field4 field must be in yyyyMMdd format.
400	997	Wallet Date Field5 field must be in yyyyMMdd format.
400	997	Wallet Amount Field1 field must be a positive value with maximum 12 integers and 2 fractions.
400	997	Wallet Amount Field2 field must be a positive value with maximum 12 integers and 2 fractions.
400	997	Wallet Amount Field3 field must be a positive value with maximum 12 integers and 2 fractions.
400	997	Wallet Amount Field4 field must be a positive value with maximum 12 integers and 2 fractions.
400	997	Wallet Amount Field5 field must be a positive value with maximum 12 integers and 2 fractions.
400	997	Device Data Field1 field must be null for existing client.
400	997	Device Data Field2 field must be null for existing client.
400	997	Device Data Field3 field must be null for existing client.
400	997	Device Data Field4 field must be null for existing client.
400	997	Device Data Field5 field must be null for existing client.
400	997	Device Date Field1 field must be null for existing client.
400	997	Device Date Field2 field must be null for existing client.
400	997	Device Date Field3 field must be null for existing client.
400	997	Device Date Field4 field must be null for existing client.
400	997	Device Date Field5 field must be null for existing client.
400	997	Device Amount Field1 field must be null for existing client.
400	997	Device Amount Field2 field must be null for existing client.
400	997	Device Amount Field3 field must be null for existing client.
400	997	Device Amount Field4 field must be null for existing client.
400	997	Device Amount Field5 field must be null for existing client.
400	997	Device Data Field1 field value must have max length 100.
400	997	Device Data Field2 field value must have max length 100.
400	997	Device Date Field3 field must be in yyyyMMdd format.
400	997	Device Date Field4 field must be in yyyyMMdd format.
400	997	Device Date Field5 field must be in yyyyMMdd format.
400	997	Device Amount Field1 field must be a positive value with maximum 12 integers and 2 fractions.
400	997	Device Amount Field2 field must be a positive value with maximum 12 integers and 2 fractions.
400	997	Device Amount Field3 field must be a positive value with maximum 12 integers and 2 fractions.
400	997	Device Amount Field4 field must be a positive value with maximum 12 integers and 2 fractions.
400	997	Device Amount Field5 field must be a positive value with maximum 12 integers and 2 fractions.
400	997	Birth Date should be less than equal to institution date.
400	997	Legal ID1 Expiry Date should be greater than equal to institution date.
400	997	Legal ID2 Expiry Date should be greater than equal to institution date.
400	997	Legal ID3 Expiry Date should be greater than equal to institution date.
400	997	Legal ID4 Expiry Date should be greater than equal to institution date.
400	997	Only alphanumeric characters and underscore are allowed.
400	997	Card Number Alias field value must have max length 24.
400	997	Corporate Client Code is not allowed for 'Customer Type'
400	997	Program Code field should only contain [A-Z 0-9] and underscore and must start and end with alphanumeric character.
400	997	Program Code field value must have max length 10.
400	997	Branch Code field value must have max length 6.
400	997	Account Type field value must have max length 6.
400	997	Field must be null for existing client.
400	997	Registered Mobile ISDN Number field value must have max length 15.
400	997	Embossed Name should not contain any special characters other than spaces, periods and field length should be between 2-26.
400	997	Residential Join Date field must be in ddMMyyyy format.
403	900	Invalid User.
404	998	Card Number(s) does not exist.
400	999	Internal Error.
500	999	Invalid Request Type.
500	913	Backward offset time limit violated.
400	994	Invalid Request - Unrecognized field.
400	988	Encryption type Not Supported.
400	913	Forward offset time limit violated.
400	999	Exception occurred while serving the request.
400	APPUP00195	Length of Client Customer ID is invalid.
400	APPUP00237	Invalid billing cycle code.
400	APPUP00245	Invalid Credit Plan.
400	APPUP00246	Credit Plan code allowed only for Application Type Primary.
400	APPUP00247	Billing Cycle Code allowed only for Application Type Primary.
400	ORGUNIT01	For Multilevel Corporate - department field must be a valid organization unit/ Entity.
400	ORGUNIT02	For Multilevel Corporate - department field cannot be blank.
400	APP043	Supplementary Card Issuance Allowed For Primary Clients Only.
400	MISSING_BANK_CODE	Bank Code is mandatory.
400	INVALID_BANK_CODE	Invalid bank code.
400	CREDEV035	Load currency is different than program currency. Initial load is not allowed.
400	CREDEV036	Currency [] not defined or inactive for the institution.
400	APPADDON01	Add-on cards are not allowed for Corporate cards.
400	APPOB0001	Onboarding is not allowed on Device Plan: [Device plan code related to the device].
400	997	Existing Card Number Alias field is not allowed with Existing Device Number or for New Primary application type.
400	997	Existing Add-On Card Number Alias field is not allowed with Existing Add-On Client Code or allowed for Existing Add-On application type only.
400	997	Either Existing Device Number or Existing Card Number Alias field is mandatory.
400	997	Either Existing Add-on Client Code or Existing Add-On Card Number Alias field is mandatory.
400	997	Existing Card Number Alias field should be alphanumeric.
400	997	Existing Card Number Alias field value must have max length 24.
400	997	Existing Add on Card Number Alias field should be alphanumeric.
400	997	Existing Add On Card Number Alias field value must have max length 24.
400	997	Existing Program Code field should be alphanumeric. Underscore are allowed and must start and end with an alphanumeric character.
400	997	Existing Device Plan Code field should be alphanumeric. Underscores are allowed and must start and end with an alphanumeric character.
400	997	Existing AddOn Program Code field should be alphanumeric. Underscore are allowed and must start and end with an alphanumeric character.
400	997	Existing AddOn Device Plan Code field should be alphanumeric. Underscores are allowed and must start and end with an alphanumeric character.
400	997	Existing Program Code field value must have max length 10.
400	997	Existing Device Plan Code field value must have max length 10.
400	997	Existing AddOn Program Code field value must have max length 10.
400	997	Existing AddOn Device Plan Code field value must have max length 10.
400	APP050	Supplementary Card Issuance Allowed For Primary Clients Only.
400	APP051	Wallet is in Freeze or closed status.
400	APP052	Existing Device Number is not in Valid status.
400	APP055	Existing CNA applicable only for Prepaid product.
400	APPUP00309	Either Existing Device number or Existing Card number Alias should be present.
400	APPUP00310	Either Existing Add on Client code or Existing Add on Card number Alias should be present for application type 5.
400	CNA001	Error While processing request.
400	CNA003	No Data Found.
400	CNA005	Too many Devices for CAN.
400	997	Device plan/program mandatory.
400	APP076	Existing device number interchange is different with requested device interchange.
400	994	Invalid Encryption-Algorithm header value.
400	994	Invalid Encryption Request Parameters.
400	994	Cryptography error.