• Register

Card Activation by SMS

Card Activation service is used to activate the card of a customer 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_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 
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(Encrypt(<ACT>+ 1 Space < > + <Last 4 digits of Card>))) Mandatory
Request Json
{
    "NISrvRequest": {
        "request_card_activation_by_sms": {
            "header": {
                "msg_id": 1683102476,
                "msg_type": "TRANSACTION",
                "msg_function": "REQ_CARD_ACTIVATION_BY_SMS",
                "src_application": "IVR",
                "target_application": "WAY4",
                "timestamp": "2023-05-03T12:05.73+04:00",
                "tracking_id": "549",
                "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_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_by_sms": {
            "header": {
                "msg_id": "1683102476",
                "msg_type": "TRANSACTION",
                "msg_function": "REP_CARD_ACTIVATION_BY_SMS",
                "src_application": "IVR",
                "target_application": "WAY4",
                "timestamp": "2023-05-03T12:27:05.757+04:00",
                "tracking_id": "549",
                "bank_id": "NIC"
            },
            "exception_details": {
                "application_name": "TCCADP",
                "date_time": "2023-05-03T12:27:05.757+04:00",
                "status": "S",
                "error_code": "000",
                "error_description": "Success",
                "transaction_ref_id": "549"
            }
        }
    }
}

version 5 as of 2 years ago by sumit ojha

0 Comments

Please sign in to post a comment.

Docs Navigation