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
- API Security
- Falcon Services
- Card Services
- BETA
- Version 1.0
- Card Balance Enquiry
- Card Activation
- Card Set Pin
- Card Change PIN
- Card PIN Verification
- Card Status Update
- Card Limit Update
- Card Details
- Customer Details
- List Of Cards
- Customer Demographic Update
- Card Used Limits
- Card Statement Summary
- Card Transaction
- Utility Payments
- Account Create
- Account Update
- Account Closure
- Card Create
- Card Update
- Card Replacement
- Client Create
- Client Update
- Transaction Details
- PIN Retries Counter Reset
- Digital Status Chnage
- Get CVV2 Service
- Card Link Delink
- Card Insurance Products
- Card Change Insurance Product Status
- Card Direct Debit
- Update Card Direct Debit
- Card Balance Conversion Enquiry
- Card Balance Conversion
- Card Transaction Eligibility
- Card Transaction EPP Conversion
- Card Replacement Embossing
- Card NMON Transactions
- Retail Banking Transactions
- Appendix 1
- Appendix 2
- Appendix 3
- Appendix 4
- HTTP Codes
- Error Codes
- Version 2.0
- Lookup Card Identifier
- List Of Cards
- Card Activation
- Card Set PIN
- Card Change PIN
- Card Status Update
- Client Create
- Account Create
- Card Create
- Customer Demographic Update
- Account Update
- Card Update
- Card Replacement
- Customer Details
- Card Details
- Client Update
- Card Balance Enquiry
- Card Transaction
- Card Limit Update
- Card PIN Verification
- PIN Retried Counter Reset
- Get CVV2 Service
- Card Verification
- Card Transaction Details
- Get Encryption Certificate
- Get Dictionaries MCC
- Get Account Balance
- Card Insurance Product
- Card Insurance Product Update
- Card Direct Debit Update
- Card Direct Debit
- P2P Transfer
- Account Transaction
- Account Status Change
- Card Statement Summary
- Account Transaction Details
- Card Contact Details
- List of Accounts
- Account Hierarchy
- Notification Service
- Appendix 1
- Appendix 2
- Appendix 3
- Appendix 4
- HTTP Codes
- Error Codes
- Buy Now Pay Later
- Card Limits
- Insurance Services
- Webhook Services
- Switch Services
- Card Control Services
- Merchant Digital Onboarding
- Notification Service
- SMS Security Services
- Terms and Condition
0 Comments
Please sign in to post a comment.