• Register

Card Replacement Embossing

This service is for replacement and instant embossing. This service is applicable for only Debit Cards. Below are the detailed specifications of this API.

Download

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: "TRANSACTION" Mandatory
msg_function String 50 Function name to be used Default:  "REQ_CARD_REPLACEMENT_EMBOSS" Mandatory
src_application String 10 Source requesting channel e.g. “IB” or "IVR" etc. Might change. Mandatory
target_application String 10 Target application name Ex. : "WAY4" or "DCMS" or "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 e.g. “ALMR” Mandatory
body card_number String Min – 16       Max - 19 16/19-digit card no Mandatory 
e.g: 518522XXXXXX0833
First 6 digits will be BIN for cards
instant_embossing_flag String 1

Allowed Values: Y/N/E

If Y conditional1 fileds should be populated

If E conditional1 and Conditional2 field should be populated.

Mandatory
action_type   String 15 REPLACE, REISSUE, RENEW, CONVERT Mandatory
product_code   String 32 Product Code Conditional1
product_name String 30 Product Name Conditional1
channel   String 15 KIOSK or Branch Conditional1
request_id   String 18 Request ID Conditional1
kiosk_id   String 4 Kiosk ID Conditional1
branch_id   String 15 Branch ID Conditional1
cardholder_name   String 30 Cardholder embossing name  Conditional2
embossing_name_line4 String 30 Fourth line embossing name Conditional2
card_expiry_date String 4 Format YYMM Conditional2
service_code String 15 Service Code Conditional2
card_issue_date String 4 Format YYMM Conditional2
mobile_number String 15 Mobile Number Conditional2
email String 30 Email ID Conditional2
plastic_code String 4 Plastic Code Conditional2
card_role String 1 P (Primary) / S (Supplementary) Conditional2
pin_format String 2 PIN Format Conditional2
pin_block String 16 PIN Block Conditional2
sequence_number String 3 PAN Sequence Number Conditional2
language String 3 ISO Language code.Default: ENG Conditional2
address_line_1 String 30 Customer Addr Line1 Conditional2
address_line_2 String 30 Customer Addr Line2 Conditional2
address_line_3 String 30 Customer Addr Line3 Conditional2
Request JSON
{
  "NISrvRequest":{
    "request_card_replacement_emboss":{
      "header":{
        "msg_id":"4000",
        "msg_type":"TRANSACTION",
        "msg_function":"REQ_CARD_REPLACEMENT_EMBOSS",
        "src_application":"KIOSK",
        "target_application":"DCMS",
        "timestamp":"2022-05-06T16:03:35.019+04:00",
        "tracking_id":"4000",
        "bank_id":"ALMR"
      },
      "body":{
        "card_number":"517690XXXXXX1378",
        "instant_embossing_flag":"N",
        "action_type":"CONVERT",
        "product_code":"",
        "product_name":"",
        "channel":"",
        "request_id":"",
        "kiosk_id":"",
        "branch_id":"",
        "cardholder_name":"",
        "embossing_name_line4":"",
        "card_expiry_date":"",
        "service_code":"",
        "card_issue_date":"",
        "mobile_number":"",
        "email":"",
        "plastic_code":"",
        "card_role":"",
        "pin_format":"",
        "pin_block":"",
        "sequence_number":"",
        "language":"",
        "address_line_1":"",
        "address_line_2":"",
        "address_line_3":""
      }
    }
  }
}

Response Parameters:

Node Child Node Type Max 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 Function name to be used Default:  "REP_CARD_INSTANT_EMBOSS" 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 e.g. “IB” or "IVR" etc
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. 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 Mandatory
Format “DD/MM/YYYY HH:MM:SS”
status String 1 Status of the request (S/F) Mandatory
Success- S,  Failure - F
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
Response JSON
{
  "NISrvResponse":{
    "response_card_replacement_emboss":{
      "header":{
        "msg_id":"224001",
        "msg_type":"TRANSACTION",
        "msg_function":"REP_CARD_REPLACEMENT_EMBOSS",
        "src_application":"IVR",
        "target_application":"PCMS",
        "timestamp":"19/07/2020 13:04:31",
        "tracking_id":"224001",
        "bank_id":"bankID"
      },
      "exception_details":{
        "application_name":"",
        "date_time":"2020-07-19T12:57:49.439+04:00",
        "status":"S",
        "error_code":"000",
        "error_description":"Success",
        "transaction_ref_id":null
      }
    }
  }
}

 

<p><span style="font-size: large;"><strong>Response Parameters:</strong></span></p>

Docs Navigation