• Register

Card Activation

The service Card Activation is used to activate the card for the provided card number. It receives card number, as an input parameter.

Request Parameters:

Node

Child Node

Type 

Max

Description

Remarks

header

msg_id

String

12

Unique Source Message ID

Mandatory

msg_type

String

13

Request Type

Default: “TRANSACTION”

Mandatory

msg_function

String

50

Function name to be used

Default: "REQ_CARD_ACTIVATION"

Mandatory

src_application

String

5

Source requesting channel e.g. “IVR”. Might change.

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

Transaction Tracking Id

Mandatory

bank_id

String

4

Source Bank Id e.g. “bankID”

Mandatory

instance_id

String

10

N/A

Optional

body

card_no

String

Min – 16

Max - 19

16-digit card no

e.g: XXXXXXXXXXXX0833

First 6 digits will be BIN for cards

Mandatory 

pin String 25 Pin Mandatory 
request_type
String 2 Request Type EX: A Mandatory 

card_type

String

7

Values are restricted

PREPAID

CREDIT

DEBIT

Mandatory 

FIID String 10 Institution ID Mandatory 
Request Json
{
  "NISrvRequest":{
    "request_card_activation":{
      "header":{
        "msg_id":"223001",
        "msg_type":"TRANSACTION",
        "msg_function":"REQ_CARD_ACTIVATION",
        "src_application":"IVR",
        "target_application":"PCMS",
        "timestamp":"2020-07-19T12:59:21.609+04:00",
        "tracking_id":"223001",
        "bank_id":"bankID"
      },
      "body":{
        "card_no":"XXXXXXXXXXXXXXXX",
        "pin": "XXXX",
        "request_type":"A",
        "card_type":"PREPAID",
        "FIID":"XXXX"
      }
    }
  }
}

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

13

msg_type sent in the request will be sent back in response in this field.

Mandatory

msg_function

String

50

Default: “REP_CARD_ACTIVATION”

Mandatory

src_application

 

String

 

5

The src_application sent in the request will be sent back in response in this field.

Source requesting channel e.g. “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.

Mandatory

bank_id

 

String

4

The bank_id sent in the request will be sent back in response in this field. E.g. bankID

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

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 10 NA Optional
data String 10 NA Optional
type String 10 NA Optional

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":{
      "header":{
        "msg_id":"223001",
        "msg_type":"TRANSACTION",
        "msg_function":"REP_CARD_ACTIVATION",
        "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_SSP_1",
        "date_time":"2020-07-19T12:57:49.439+04:00",
        "status":"S",
        "error_code":"000",
        "error_description":"Success",
        "transaction_ref_id":null
      }
    }
  }
}

Docs Navigation