Card Activation and Set Pin by SMS

Card Activation and Set PIN service is used to activate the card as well as set the PIN by SMS. This service is applicable for Credit and Debit Cards. Below are detailed the specifications of this API.

Request Parameters:

Node	Child Node	Type	Max	Description	Remarks
header	msg_id	String	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_ACTIVATION_SET_PIN_BY_SMS"	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	N/A	Optional
	bank_id	String	4	Source Bank Id Ex: bankID	Mandatory
	instance_id	String	5	N/A	Optional
body	mobile_number	String	20	Mobile number with country code ex- 971552221123	Mandatory
body	enc_sms_text	String	150	Encrypt SMS full text by RSA algorithm using certificates shared by NI and encode sms text using Base64.Base64(Encrypt(<ACTP>+ 1 Space < > + <Last 4 digits of Card> + 1 Space < > + <4 digit PIN>))	Mandatory

Request Json

{
    "NISrvRequest": {
        "request_card_activation_set_pin_by_sms": {
            "header": {
                "msg_id": 1683102714,
                "msg_type": "TRANSACTION",
                "msg_function": "REQ_CARD_ACTIVATION_SET_PIN_BY_SMS",
                "src_application": "IVR",
                "target_application": "WAY4",
                "timestamp": "2023-05-03T12:05.33+04:00",
                "tracking_id": "959",
                "bank_id": "NIC"
            },
            "body": {
                "mobile_number": "121203",
                "enc_sms_text": "Wc+IFysZpF8a6Wg+znHos8HW8v7W2pSbvdB6VXleAnIZyLqAGCuSmPFa0W0p94RnfLwMv4JeVCYK5OxxDTHKnxjuc66A1NPsZJeipWgzWCIkcXHAs+XuDBEtHFjOUhRI2hxkKGa4sjOnLmxbk4Wpq7fe4zHQleTgWTje2lp/Rwp7VtdW/1txm5FDcZzqrDyJfWtvj5VaCnckTmXDyGNQ3cUveVAlncUdnhWbP9PZeGgtGLJRYIs0TsNhnmE4i+T5tD2XMnBQ/hVB2B6Av/XU+eF8aqYpjv+r314TOvNJZ/w1yg9JFOMrzJYU3Ih48g2YqUreVVSl+NFCxQwZS5mfxNPpo6pTsrCJjHScAxoXjnJ2bKDkBP3aE2vULNhcTqJ7HU7ayDa28F07UuvJ/urNxQkkdAtmOk5VPWiJzWwPNNlyzDz6CLAnIYZccfs98GDIvJjoAaDWa8RkOsjwNREmjne+xs0cZcuL4/ol5wH7+AvCS6gb67gqJaH1xsWhvb+6eujsZNmZIs40drDCXu+cfI6FBS/u/TUv+1p/RLjXPGfEAzLY12Cty+jqjwedBKkiDEalTKFMd4GNpc7tqES5UO/WvXIo4Ww6eaYC65BsYeHNhEmAC3pVrNY07+uu0QWE45V3GAJpfSrBEN46NaVIMsA79RSP9TVgwpcoTpmt/7k="
            }
        }
    }
}

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. 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_ACTIVATION_SET_PIN_BY_SMS”	Mandatory
	src_application	String	10	The src_application sent in the request will be sent back in response in this field. Source requesting channel Ex: “IVR”	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. N/A	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	Timestamp of the response 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
	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_activation_set_pin_by_sms": {
            "header": {
                "msg_id": "1683102714",
                "msg_type": "TRANSACTION",
                "msg_function": "REP_CARD_ACTIVATION_SET_PIN_BY_SMS",
                "src_application": "IVR",
                "target_application": "WAY4",
                "timestamp": "2023-05-03T12:31:04.225+04:00",
                "tracking_id": "959",
                "bank_id": "NIC"
            },
            "exception_details": {
                "application_name": "TCCADP",
                "date_time": "2023-05-03T12:31:04.225+04:00",
                "status": "S",
                "error_code": "000",
                "error_description": "Success",
                "transaction_ref_id": "959"
            }
        }
    }
}

version 4 as of 2 years ago by sumit ojha

0 Comments

Please sign in to post a comment.

Card Activation and Set Pin by SMS

0 Comments

Docs Navigation