• Register

Switch MCC

Request Parameters:

Node

Child Node

Type

Length

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_ENABLE_DISABLE_MCC"

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. “XXXX”

Mandatory

instance_id

String

10

N/A

Optional

body

card_identifier_id

String

32

454545XXXXXX1234

Mandatory 

card_identifier_type

String

20

CONTRACT_NUMBER  or EXID

Mandatory

mcc_allowed_group_list

code*

String

30

MCC Group  Codes.

MCCs group codes mentioned in this allowed and all others are blocked

 

Conditional

Either mcc_allowed_group_list  or mcc_blocked_group_list can be sent.

mcc_blocked_group_list

code*

String

30

MCC Group  Codes

MCCs group codes mentioned in this blocked and all others are allowed

mcc_allowed_code_list

code*

String

30

MCC Code

individual MCC codes to be allowed

Optional

mcc_block_code_list

code*

String

30

MCC Code

individual MCC codes to be blocked

Optional

 

Request Json

{
   "NISrvRequest":{
      "request_enable_disable_mcc":{
         "header":{
            "msg_id":"676587761",
            "msg_type":"TRANSACTION",
            "msg_function":"REQ_ENABLE_DISABLE_MCC",
            "src_application":"SRCAPP",
            "target_application":"WAY4",
            "timestamp":"2020-05-21T15:13:18.853+04:00",
            "tracking_id":"878712719",
            "bank_id":"QASH"
         },
         "body":{
            "card_identifier_id":"51829140129582424162",
            "card_identifier_type":"EXID",
            "mcc_blocked_group_list":[
               {
                  "code":"Tickets"
               }
            ],
            "mcc_allowed_code_list":[
               {
                  "code":"5523"
               },
               {
                  "code":"5599"
               }
            ],
            "mcc_blocked_code_list":[
               {
                  "code":"6623"
               },
               {
                  "code":"6699"
               }
            ]
         }
      }
   }
}

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 Function name to be used Default:  "REP_ENABLE_DISABLE_MCC" Mandatory
src_application String 10 The src_application sent in the request will be sent back in response in this field.
Source requesting channel e.g. “IB” or "IVR" etc
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
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_enable_disable_mcc":{
         "header":{
            "msg_id":"1686208332",
            "msg_type":"TRANSACTION",
            "msg_function":"REP_ENABLE_DISABLE_MCC",
            "src_application":"SRCAPP",
            "target_application":"WAY4",
            "timestamp":"2023-06-08T11:11:34.21+04:00",
            "tracking_id":"474",
            "bank_id":"QASH"
         },
         "exception_details":{
            "application_name":"TCC-ADP",
            "date_time":"2023-06-08T11:11:34.21+04:00",
            "status":"S",
            "error_code":"000",
            "error_description":"SUCCESS"
         }
      }
   }
}/code>

Docs Navigation