Card Services

Overview

Our card services support multiple card types, including Visa, MasterCard, American Express, and Discover, as well as other popular payment methods like Apple Pay and Google Pay. You can also set up recurring payments for your customers, making it easy for them to make regular payments without having to enter their card information every time.Our advanced fraud detection and prevention features use machine learning algorithms to help identify and prevent fraudulent transactions. We also provide detailed reporting and analytics, allowing you to track and analyze payment data and make data-driven decisions.

We also offer multi-currency support, which allows you to accept payments from customers in different parts of the world. And with our 24/7 customer support, you can always count on us to help you resolve any issues related to our card services.Our card services are also fully compliant with all local and international regulations, such as PCI DSS, so you can be confident that you're accepting payments in a secure and compliant manner.

Download

Client Create(Post)

This API is used to create a new cardholder within a financial institution. It can be used to register a new customer and issue them with a card.

Node	Child Node	Type	Length	Description
Authorization* required	Bearer xxxx* required	string		Authorization Header (Bearer Token)
Content-Type* required	application/json* required	string		Content Type

Node Type				Type	Length	Description
header	msg_id* required			string	12	Message ID, this field should be unique id for each Api call. This will be generated from client side. If the same message ID is used the system will decline the API call with Error Description “Duplicate Message ID”
	msg_type* required			string	12	Message Type – This can have either “TRANSACTION” or “ENQUIRY” As for this API the value expected is “TRANSACTION”
	msg_function* required			string	50	Message functions: Should be “REQ_CARD_CREATE”
	src_application* required			string	10	Source Application: This is a free Text and the client can populate the source system from where the API is Initiated Example: IVR, IB, MB No Validations of these are kept at Network Systems
	target_application* required			string	10	The target_application can hold any value from FI side, this can be used by FI to check the target system of the API call
	timestamp* required			string	30	Timestamp of the request - Format YYYY-MM-DDtHH:MM:SS.SSS+04:00
	bank_id* required			string	4	Bank Id is Unique Id 4 digit code for each client and the same will be provided once the client setup is completed in our core system. For sandbox testing – Please use “NIC”
body	customer_id* required			string	20	Customer ID: Customer Identification number This should be a unique number
	account_number* required			string	64	Account number
	card_type* required			string	7	Informative value to the request, does not have any functional impact, the value can be PREPAID/CREDIT/DEBIT
	card	customer_id* required		string	20	Customer ID: Customer Identification number This should be a unique number
		account_number* required		string	64	Account number
		institution_id* required		string	5	institution id is the code that is created for each bank or FI(it is the same value as bank code), 982 value is just used as an example in Sandbox
		card_identifier_type		string	20	CONTRACT_NUMBER is used for clear card number or EXID which is a unique identifier for the card generated by CMS
		card_identifier_id		string	32	Clear card number generated by FI system. If it was not provided, CMS will generate it
		card_expiry_date		string	4	Format YYMM. If it was not provided, CMS will generate it
		cardholder_name* required		string	21	Cardholder name
		product_code* required		string	32	Product code, this code is generated by CMS after creating the product, this code is FI spesific code 982_AED_002_P is just used as an example in Sandbox"
		card_date_open		string	10	Date of card contract creation
		currency* required		string	3	Informative value to the request, does not have any functional impact, the currency will be taken from the product
		card_virtual_indicator* required		string	1	V - Virtual P - Physical
		limit	type	string	32	Credit limit, applicable only for credit cards, Type of limit: FIN_LIMIT, CR_LIMIT_PCNT (Supplementary card only)
			currency	string	3	Credit limit currency
			value	string	20	Credit limit value
		custom_fields	key	string	20	Custom Tag. Example: contract_idt_scheme
		custom_fields	value	string	128	Tag value. Example: CONTRACT_NUMBER

Node Type					Type	Length	Description
NISrvResponse	response_card_create	header	msg_id* required		string	12	Message ID, this field should be unique id for each Api call. This will be generated from client side. If the same message ID is used the system will decline the API call with Error Description “Duplicate Message ID”
			msg_type* required		string	12	Message Type – This can have either “TRANSACTION” or “ENQUIRY” As for this API the value expected is “TRANSACTION”
			msg_function* required		string	50	Message functions: Should be “REP_CARD_CREATE”
			src_application* required		string	10	Source Application: This is a free Text and the client can populate the source system from where the API is Initiated Example: IVR, IB, MB No Validations of these are kept at Network Systems
			target_application* required		string	10	The target_application can hold any value from FI side, this can be used by FI to check the target system of the API call
			timestamp* required		string	15	Timestamp of the response - Format YYYY-MM-DDtHH:MM:SS.SSS+04:00
			bank_id* required		string	4	Bank Id is Unique Id 4 digit code for each client and the same will be provided once the client setup is completed in our core system. For sandbox testing – Please use “NIC”
		exception_details	application_name* required		string	20	Application Name
			date_time* required		string	30	Timestamp of the response Format “YYYY-MM-DD HH:MM:SS”
			status* required		string	1	Status of the request (S/F)
			error_code* required		string	4	EAI Internal Error Code (Check error codes section for the complete list of error codes and error code descriptions)
			error_description* required		string	100	Error Description (Check error codes section for the complete list of error codes and error code descriptions)
			transaction_ref_id		string	20	The tracking_id sent in the request will be sent back in response in this field.
		body	card_identifier_id* required		string	32	CardValue of card number, Token number, Ext_number
			card_identifier_type* required		string	20	CONTRACT_NUMBER is used for clear card number or EXID which is a unique identifier for the card generated by CMS
			masked_pan* required		string	16	Masked PAN
			card_virtual_indicator* required		string	1	P- Physical V- Virtual
			custom_fields	key	string	32	Custom Tag e.g. contract_idt_scheme
			custom_fields	value	string	128	Custom Tag value

Code	Description
200	Sample Description
400	Bad Request
401	Unauthorized
403	Forbidden
500	Internal Server Error
502	Bad gateway
503	Scheduled Maintenance
504	Gateway Timeout
596	Service Not Found

Card Services

Card Services

Overview

Client Create(Post)

Card Create(Post)

Card Activate(Post)

Lookup Card Identifier(Post)

Cards List(Post)

Card Details Enquiry(Post)

Card Statement Summary(Post)

Card Status Change(Post)

Card Replacement(Post)

Client Update(Post)

Card Update(Post)

Card Balance Enquiry(Post)

SMS Webhook(Post)

Bulk Card Create(Post)

Bulk List Of Cards(Post)

Bulk Card Summary(Post)

Bulk Move Cards(Post)

OnlineEmbossing(Post)

Card Activation(Post)

Card Replacement(Post)

Card Renewal(Post)

Pin Action(Post)

Card Direct Debit(Post)

Card Direct Debit Update(Post)

P2P Transfer(Post)

Account Transaction(Post)

Account Status Change(Post)

Switch MCC(Post)

Release Pending Authorization(Post)

Get MCC Controls(Post)

Account Balance Enquiry(Post)

Account Hierarchy Enquiry(Post)

Get Account Transactions(Post)

Get Dictionaries MCC(Post)

Set FXRates(Post)

Get FXRates(Post)

Card Contact Details(Post)

Card Create

Status:

Production

Version:

V2

Category:

Card Services

Card Create

Overview

Efficient Card Creation

Customizable Features

Virtual Card Option

How It Works

Card Create

Status:

Production

Version:

V2

Category:

Card Services

Header Request Parameters

Request Parameters

Sample Request

Header Response parameters

Response parameters

Sample Response

Error Code

How It Works

1- Process 1

2- Process 1

3- Process 1

4- Process 1

5- Process 1