• Register

Card Create

Card Create service is used to create new cards. This service is applicable only for Credit and Debit Cards. Below are the detailed specifications of this API.

Download

Request Parameters:

Node Child Node Type Length Description Remarks
header msg_id A/N 12 Unique Source Message ID Mandatory
msg_type String 12 Request Type Default: "TRANSACTION" Mandatory
msg_function String 50 Function name to be used Default: "REQ_CARD_CREATE" Mandatory
src_application String 10 Source requesting channel Ex: IVR. Mandatory
target_application String 10 Target application name Ex. PCMS Mandatory
timestamp String 30 Timestamp of the request Format  “DD/MM/YYYY HH:MM:SS” Mandatory
tracking_id String 15 Transaction Tracking Id Optional
bank_id String 4 Source Bank Id Ex. bankID Mandatory
body customer_id String 20 CIF ID Mandatory
account_number String 64 Account contract Mandatory 
card_type String 7

Values are restricted

PREPAID

CREDIT

DEBIT

 Mandatory
  card customer_id String 20 CIF ID Mandatory
account_number String 64 Account contract Mandatory 
institution_id String 5 Bank code Optional
card_number String Min – 16 Max - 19 16 to 19-digit card no
e.g: XXXXXXXXXXXX0833
First 6 digits will be BIN for cards
 Mandatory
card_expiry_date String 4 Format YYMM Optional
cardholder_name String 50 Cardholder name Conditional(Mandatory for Credit Cards only)
bin_number String 8 BIN Number Conditional (mandatory for Debit Card)
product_code String 32 Product code Conditional (mandatory for Debit Card)
product_category String 4 Product Category (ISLAMIC,HNI,STAFF) Conditional (mandatory for Debit Card)
customer_category String 4 Customer Category (NOR, HNI) Conditional (mandatory for Debit Card)
card_role String 1 Card Role : Primary/Supplementary Mandatory
card_date_open String 10 Date of card contract creation Optional
currency String 3 Currency  Mandatory
card_virtual_indicator string 1

V - Virtual

P - Physical

 Mandatory
limit type String 32 Type of limit:FIN_LIMIT, CR_LIMIT_PCNT (Supplementary card only)
 Optional
currency String 3 Limit currency Optional
value String 20 Limit value Optional
custom_fields key String 32 Custom Tag Optional
value String 128 Tag value Optional


Response Parameters:

 Request JSON

{
    "NISrvRequest": {
        "request_card_create": {
            "header": {
                "msg_id": "220121184558",
                "msg_type": "TRANSACTION",
                "msg_function": "REQ_CARD_CREATE",
                "src_application": "SSP",
                "target_application": "WAY4",
                "timestamp": "2022-01-21 18:45:58.088+0530",
                "tracking_id": "20220121184558",
                "bank_id": "ALMR"
            },
            "body": {
                "customer_id": "XXXXXXXXX",
                "account_number": "XXXXXXXXXXXXXXXXXXX",
                "card_type": "CREDIT",
                "card": {
                    "customer_id": "XXXXXXXXX",
                    "account_number": "XXXXXXXXXXXXXXXXXXX",
                    "institution_id": "321",
                    "card_number": null,
                    "card_expiry_date": null,
                    "cardholder_name": "Rama",
                    "bin_number": null,
                    "product_code": "321_AED_001_S",
                    "product_category": null,
                    "customer_category": null,
                    "card_role": "Supplementary",
                    "card_date_open": "2021-12-20",
                    "currency": "AED",
                    "card_virtual_indicator": "V",
                    "custom_fields": [
                        {
                            "key": "CN-CARD_DESIGN_FLAG",
                            "value": "00"
                        },
                        {
                            "key": "CN-EMB_NAME_FIRST",
                            "value": "Rama"
                        },
                        {
                            "key": "CN-EMB_NAME_LAST",
                            "value": "Rajan"
                        },
                        {
                            "key": "CN-EMB_NAME_TITLE",
                            "value": "MR"
                        },
                        {
                            "key": "CN-NCONTROL_ENROLMENT",
                            "value": "Y"
                        },
                        {
                            "key": "CN-CL_PCNT",
                            "value": "50"
                        },
                        {
                            "key": "CN-CREDIT_LIMIT_AM",
                            "value": "17500"
                        },
                        {
                            "key": "CN-CREDIT_LIMIT_REASON",
                            "value": "Increase"
                        },
                        {
                            "key": "preemb",
                            "value": "Y"
                        }
                    ]
                }
            }
        }
    }
}
Node Child Node Type Length Description Remarks
header msg_id String 12 The msg_id sent in the request will be sent back in response in this field. Mandatory
Unique Source Message ID e.g. “ada123456fdsf”
msg_type String 12 msg_type sent in the request will be sent back in response in this field. Mandatory
msg_function String 50 Default: “REP_CARD_CREATE” Mandatory
src_application String 10 The src_application sent in the request will be sent back in response in this field. Mandatory
Source requesting channel 
target_application  String 10 The target_application sent in the request will be sent back in response in this field. Mandatory
timestamp String 30 Timestamp of the response Mandatory
Date & time. Format  “DD/MM/YYYY HH:MM:SS”
tracking_id String 15 The tracking_id sent in the request will be sent back in response in this field. Optional
bank_id String 4 The bank_id sent in the request will be sent back in response in this field. Mandatory
instance_id String 10 N/A Optional
Exception_details application_name String 20 Application Name Mandatory
date_time String 30 Format “DD/MM/YYYY HH:MM:SS” Mandatory
status String 1 Status of the request (S/F) Mandatory
error_code String 4 EAI Internal Error Code (Check error codes section for the complete list of error codes and error code descriptions) Mandatory
error_description String 100 Error Description (Check error codes section for the complete list of error codes and error code descriptions) Mandatory
transaction_ref_id String 20 The tracking_id sent in the request will be sent back in response in this field. Optional
body customer_id String 20 CIF ID Optional
institution_id String 5 Bank code Optional

card_number

 String
16 to 19-digit card no
 Mandatory 
Min – 16 
 e.g: XXXXXXXXXXXX0833
 Max - 19 First 6 digits will be BIN for cards

 


 
card_expiry_date String 4 Card Expiry Date Optional
cardholder_name String 50 Cardholder name Optional
account_number String 50 Account number Optional
product_code String 32 Product code Optional
card_role String 1 Card Role : Primary/Supplementary Optional
last_statement_date String 10 Last billing date Optional
next_statement_date String 10 Next billing date Optional
due_date String 10 Due date Optional
card_date_open Date   Date of card contract creation Optional
card_activation_date String 10 Date of plastic creation Optional
currency String 3 Currency Optional
card_virtual_indicator
 String 1

V - Virtual

P - Physical

 Optional
statuses type String 32 Code of status Optional
value String 32 Status value Optional
changed_date String 10 Date of change Optional
limits type String 32 Limit type Optional
currency String 3 Limit currency Optional
value String 20 Limit value Optional
balances type String 32 Type of the balance Optional
currency String 3 Currency Optional
amount String 20 Amount Optional
custom_fields key String 32 Custom Tag Optional
value String 128 Tag value Optional
Response JSON
{
    "NISrvResponse": {
        ":response_card_create": {
            ":header": {
                ":msg_id": "220121185313",
                ":msg_type": "TRANSACTION",
                ":msg_function": "REP_CARD_CREATE",
                ":src_application": "SSP",
                ":target_application": "WAY4",
                ":timestamp": "2022-01-21 18:53:13.553+0530",
                ":tracking_id": "20220121185313",
                ":bank_id": "ALMR"
            },
            ":exception_details": {
                ":application_name": "NITIB_TCC_ADP_STD_1",
                ":date_time": "2022-01-21T17:21:41.967+04:00",
                ":status": "S",
                ":error_code": "000",
                ":error_description": "Success",
                ":transaction_ref_id": "20220121185313"
            },
            ":body": {
                ":card_number": "XXXXXXXXXXXXXXXX",
                ":card_virtual_indicator": "V",
                ":custom_fields": [
                    {
                        ":key": "CN-AMF_WAIVER_C",
                        ":value": "N"
                    },
                    {
                        ":key": "CN-BC_C1",
                        ":value": "N"
                    },
                    {
                        ":key": "CN-CARD_DESIGN_FLAG",
                        ":value": "00"
                    },
                    {
                        ":key": "CN-CL_PCNT",
                        ":value": "10"
                    },
                    {
                        ":key": "CN-CONTRACT_NAME",
                        ":value": "Raja"
                    },
                    {
                        ":key": "CN-CREDIT_LIMIT_AM",
                        ":value": "3500"
                    },
                    {
                        ":key": "CN-DATE_OPEN",
                        ":value": "2021-12-20"
                    },
                    {
                        ":key": "CN-EMB_NAME_FIRST",
                        ":value": "RAMA"
                    },
                    {
                        ":key": "CN-EMB_NAME_LAST",
                        ":value": "RAJAN"
                    },
                    {
                        ":key": "CN-EMB_NAME_TITLE",
                        ":value": "MR"
                    },
                    {
                        ":key": "CN-MMF_WAIVER_C",
                        ":value": "N"
                    },
                    {
                        ":key": "CN-NCONTROL_ENROLMENT",
                        ":value": "Y"
                    }
                ]
            }
        }
    }
}




version 3 as of 3 years ago by sumit ojha

0 Comments

Please sign in to post a comment.

Docs Navigation