Application

CardApplication

This API can be used to create virtual and physical payment cards.

Note: By default, newly created cards are inactive and must be explicitly activated via CardActivation action. Virtual cards can be used instantly after they are created and activated, while physical cards will need to be printed and sent by mail.

Request:

	Data Element	Field Name	Description	Format	Length	M/O	Remark
1	Card Number	cardNumber	Card Number	String	Maximum 19 characters	Optional
2	Card Flag	cardFlag	V- Virtual/Nonphysical P- Physical	String	Maximum 1 character	Required
3	Card Product Code	cardProdCode	Card Product Code ( Debit Card , Virtual Card , ....) 1000 - Debit Card 2000 - Credit Card	String	Miximum 4 characters	Required	Defined in Back Office
4	Card Picture Code	cardPicCode	Card Picture Code	String	Maximum 15 characters	Optional
5	Card Emboss Name	cardEmbossName	Card Emboss Name	String	Maximum 26 characters	Optional	If cardFlag = P and it is real-name card, the field is required.
6	CIF Number	customerId	Customer unique ID	String	Maximum 32 characters	Required	Customer CIF number
7	Customer ID Type	custIdType	Customer NRIC Type: D: Driver license P: Default Id Type I: National Professional ID card U: Unified Multipurpose ID (UMID) Z: Postal ID V: Voter’s (COMELEC) ID Card S: Social Security System (SSS) T: Tax Identification Number (TIN) O: Others	String	Maximum 1 characters	Required
8	Customer ID Number	custIdNo	Customer NRIC No.	String	Maximum 32 characters	Required	A unique identifier for the customer
9	Customer Issuer ID Type	custIssIdType	Customer Issuer ID Type	String	Maximum 1 characters	Optional
10	Customer Issuer ID No.	custIssIdNo	Customer Issuer ID No.	String	Maximum 32 characters	Optional	Customer's real document information, after KYC (if required)
11	Customer Name	custName	Customer Name	String	Maximum 120 characters	Optional
12	Customer Enligsh Name	custEngName	Customer English Name	String	Maximum 140 characters	Optional
13	Customer Class	custClass	Customer Class	String	Maximum 4 characters	Optional	Defined in back office
14	Customer Mobile Number	custMobile	Customer mobile number	String	Maximum 25 characters	Optional
15	Customer E-mail	custEmail	Customer E-mail	String	Maximum 60 characters	Optional
16	Customer Sex	custSex	Customer Sex	String	Maximum 1 characters	Optional
17	Customer Birthday	custBirthday	Customer Birthday	String	Maximum 8 characters	Optional
18	Country	homeCountry	Country	String	Maximum 20 characters	Conditional	If cardFlag = P, the field is required.
19	State/Province	homeState	State/Province	String	Maximum 20 characters	Conditional	If cardFlag = P, the field is required.
20	City	homeCity	City	String	Maximum 20 characters	Conditional	If cardFlag = P, the field is required.
21	District	homeDistrict	District	String	Maximum 20 characters	Conditional	If cardFlag = P, the field is required.
22	Street Name	homeStreetName	Street Name	String	Maximum 20 characters	Conditional	If cardFlag = P, the field is required.
23	Building Name	homeBuildingName	Building Name	String	Maximum 6 characters	Optional
24	House Number	homeHouseNo	House Number	String	Maximum 6 characters	Optional
25	Postal Code	homePostalCode	Zip Code	String	Maximum 6 characters	Conditional	If cardFlag = P, the field is required.

Response:

	Response Header	Field Name	Description	Format	Length	M/O	Remark
1	CIF Number	customerId	Customer unique ID	String	Maximum 32 characters	Required
2	Card Number	cardNumber	Card Number	String	Maximum 19 characters	Required
3	Card Token Number	cardToken	Card Token Number	String	Maximum 19 characters	Required
4	Card Expiry Date	expiryDate	Card Expiry Date	String	YYMM	Required
5	CVV2	CVV2	CVV2	String	Maximum 3 characters	Required