• Register

Card On-Boarding

This service is used to create a virtual card based on parent product code .

Request Parameters:

Node Child Node Type Max Description Remarks
header msg_id A/N 12 Unique Source Message ID Mandatory
msg_type String 12 Request Type Default: "ENQUIRY" Mandatory
msg_function String 50 Function name to be used Default: "REQ_CARD_ONBOARDING " Mandatory
src_application String _ Source requesting channel e.g. “SSP”. Might change. Mandatory
target_application String 10 Target application name Ex. : "WAY4" 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 e.g. “XXXX” Mandatory
instance_id String 10 N/A Optional
body parent_product_code String 10 Uniquely assign parent product code in PCMS.
Sample:
1001
Mandatory 
prepaid_card_number String 16 14/16-digit card no
e.g: XXXXXXXXXXXX0833
First 6 digits will be BIN for cards
Mandatory 
relationship_ID String 16

Sample Unique Identifier 

Passport No (P) "OR" 

National ID (N) "OR"

NULL

Mandatory 
passport_no String 16   Optional
national_ID String 16   Optional
title String 4 Sample:
Ms., Mr., Mrs., Miss
Optional
firstname String 20   Optional
 lastname String 20 Name of the customer Optional
dob String 8 DDMMYYYY Optional
gender  String 1 Sample:
M = Male, F = Female
Optional
marital_status String 1 Sample:
S: Single, M: Married, W: Widowed, D: Divorced
Optional
mobile_no String 20 Sample:
00923422781345 / 03422781345
Optional
nationality String 25 Sample:
UAE, UK, PAKISTANI, INDIAN
Optional
city String 20 Sample:
DXB, KHI, BANG
Optional
country String 19 Sample:
UAE, UK, PAKISTAN, INDIA
Optional
home_address String 100   Optional
office_address String 100   Optional
office_phone String 20   Optional
home_phone String 20   Optional
email_ID String 50   Optional
company String 30   Optional
occupation String 30   Optional





















Request Json
{
  "NISrvRequest":{
    "request_create_customer_virtual_card":{
      "header":{
        "msg_id":"223001",
        "msg_type":"TRANSACTION",
        "msg_function":"REQ_CARD_ONBOARDING",
        "src_application":"IVR",
        "target_application":"PCMS",
        "timestamp":"2020-07-19T12:59:21.609+04:00",
        "tracking_id":"223001",
        "bank_id":"bankID"
      },
      "body":{
		"parent_product_code":"XXX",
		"prepaid_card_number":"999841XX18869X2X",
                "relationship_ID":"P",
                "passport_no":"JoF2345XX",
		"national_ID":"12345",
		"title":"Ms.",
		"firstname":"BCVXXX",
		"lastname":"XXXXX",
		"dob":"12012021",
		"gender":"M",
		"marital_status":"S",
		"mobile_no":"100"
		}
    }
  }
}


Response Parameters:

Node Child Node Data Max Description Remarks
header msg_id String 12 The msg_id sent in the request will be sent back in response in this field.Unique Source Message ID e.g. “ada123456fdsf” Mandatory
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_ONBOARDING” Mandatory
src_application String 10 The src_application sent in the request will be sent back in response in this field. Mandatory
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 Date & time. Format  “DD/MM/YYYY HH:MM:SS” Mandatory
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. E.g. ‘ABCD Mandatory
instance_id String 10 N/A Optional
exception_details application_name String 20 Tibco Application Name Mandatory
date_time String 30 Timestamp of the response Date & time. Format  “DD/MM/YYYY HH:MM:SS” Mandatory
status String 1 Status of the request (S/F) Success- S,  Failure - 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
trace String 100   Optional
data String 100   Optional
type String 10   Optional
transaction_ref_id String 20 The tracking_id sent in the request will be sent back in response in this field. Optional
body parent_product_code String 10   Mandatory
product_code String 10   Mandatory
card_no String 16 14/16-digit card no
e.g: XXXXXXXXXXXX0833
First 6 digits will be BIN for cards
Mandatory
expiry_date String 8 CCYYMMDD Sample:20181231 Optional
unique_identifier String 30   Mandatory
mobile_no String 20   Optional
wallet_ID String 30   Optional
wallet_ID_currency String 3   Optional
wallet_balance String 11   Optional
title String 4   Optional
firstname String 20   Optional
 lastname String 20   Optional
dob String 8 DDMMYYYY Optional
gender  String 1 Sample:
M = Male, F = Female
Optional
city String 20   Optional
country String 19   Optional
home_address String 100   Optional
office _address String 100   Optional
office_phone String 20   Optional
home_phone String 20   Optional
email_ID String 50   Optional

 


Response Json
{
  "NISrvResponse":{
    "response_create_customer_virtual_card":{
      "header":{
        "msg_id":"223001",
        "msg_type":"TRANSACTION",
        "msg_function":"REP_CREATE_VIRTUAL_CARD",
        "src_application":"IVR",
        "target_application":"PCMS",
        "timestamp":"19/07/2020 12:59:23",
        "tracking_id":"223001",
        "bank_id":"bankID"
      },
      "exception_details":{
        "application_name":"NITIB_TCC_ADP_SANDBOX_1",
        "date_time":"2020-07-19T12:57:49.439+04:00",
        "status":"S",
        "error_code":"000",
        "error_description":"Success",
        "transaction_ref_id":null
      },
      "body":{
		  "parent_product_code":"AXCVXXX",
		  "product_code":"WEXXX",
                  "card_no": "999841XX18869X2X",
                  "expiry_date": "20181231",
		  "unique_identifier":"12345",
		  "mobile_no":"645767XXXX",
		  "wallet_ID":"1234",
		  "wallet_ID_currency":"AED",
		  "wallet_balance":"10000",
		  "title":"Mr.",
		  "first_name":"safdfdg",
		  "lastname":"dgfgfgg"		   
      }
    }
  }
}

Docs Navigation