• Register

Card NMON Transactions

Download

Request Parameters:

Node

Child Node

Type

Max

Description

Remark

header

msg_id

String

20

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

Unique Source Message ID e.g. 123456

Mandatory

msg_type

String

11

Request Type

TRANSACTION

Mandatory

msg_function

String

50

Function name to be used REQ_CARD_NONMON

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. CRM

Mandatory

target_applocation

String

 

15

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

Mandatory

timestamp

String

19

Timestamp of the response

Date & time. Format DD/MM/YYYY HH:MM:SS

Mandatory

tracking_id

String

20

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.

Mandatory

body

workflow

String

20

Contains the name of the workflow to be executed by Falcon Fraud Manager.

 

Eg;

CREDIT/DEBIT

Mandatory

record_type

String

10

NMON

Mandatory

card_number

String

20

Card Number

eg:-

4561234561234569

Conditional

data_specification_version

String

4

Version for Data Specification

 

Eg:-2.0

Mandatory

clientid_from_header

String

15

Unique identifier for the client or subclient.

Mandatory

record_creation_date

String

10

Format: yyyymmdd

Date that this record was created. Time zone must be GMT.

Mandatory

record_creation_time

String

10

Format: hhmmss

Time that this record was created. Time zone must be GMT.

Mandatory

record_creation_milliseconds

String

5

Format: sss

Milliseconds portion of the time that this record was created. 

Mandatory

gmt_offset

String

10

Specifies the Greenwich Mean Time (GMT) offset associated with all date-time fields in the record body

 

For example, a GMT offset of 5 hours and 45 minutes (Nepal) is expressed as 5.75. Note that  changes during Daylight Saving Time if Daylight Saving Time is observed in the date-time fields in the record body.

Mandatory

customerid_from_header

String

20

customer for the PAN.

For nonmonCode values of 0002, 2000-2999, 4000-4999:

- Primary Customer Identifier. Financial institution's unique identifier for the primary customer for the account.

This field should be populated as indicated if the nonmonCode field has one of the following values:

[0001] = customer ID before profile change.

Mandatory

customer_acct_number

String

40

For nonmonCode values of 0001, 1000-1999, 4000-4999:

Filled with blanks.

For nonmonCode values of 0003-0004, 2000, 2002-2999, 3000-3999:

Financial institution's unique identifier for the account.

Otherwise, this field is populated as indicated if the nonmonCode field has one of the following values:

[0002] = account identifier prior to profile change.

[2001] = previous account identifier.

Conditional

external_transactionid

String

30

Client-generated unique transaction ID that is unique across all data feeds for a specific installation of Falcon Fraud Manager.

Mandatory

transaction_date

String

10

Format: yyyymmdd

Date on which the nonmonetary event took place.

Mandatory

transaction_time

String

10

Format: hhmmss

Time when the nonmonetary event took place.

Mandatory

nonmon_code

String

5

The code defining the nonmonetary event.

Mandatory

nonmon_codeinitiator

String

 

 

Optional

decision_code

String

 

 

Optional

contact_method

String

 

 

Optional

contact_methodid

String

 

 

Optional

service_representativeid

String

 

 

 

pan

String

 

Primary Account Number (PAN) of the payment instrument. This

is the number encoded or embossed on the payment instrument

used in the transaction. Do not include spaces or punctuation

between digits; Left-justify.

This field should be populated by the current PAN if the

nonmonCode is between 3000-3999. This field should be

populated as indicated if the nonmonCode is one of the following

values:

For Eg:-

[0003] = previous PAN.

[3000] = previous PAN.

Conditional

payment_instrumentid

String

 

 

Optional

new_customerid

String

 

 

Optional

new_customer_acctnumber

String

 

 

Optional

new_pan

String

 

 

Optional

new_payment_instrumentid

String

 

 

Optional

action_code

String

 

 

Optional

new_given_name

String

 

 

Optional

old_given_name

String

 

 

Optional

new_middle_name

String

 

 

Optional

old_middle_name

String

 

 

Optional

new_surname

String

 

 

Optional

old_surname

String

 

 

Optional

new_suffix

String

 

 

Optional

old_suffix

String

 

 

Optional

new_entity_name

String

 

 

Optional

old_entity_name

String

 

 

Optional

new_streetline1

String

 

 

Optional

old_streetline1

String

 

 

Optional

new_streetline2

String

 

 

Optional

old_streetline2

String

 

 

Optional

new_streetline3

String

 

 

Optional

old_streetline3

String

 

 

Optional

new_streetline4

String

 

 

Optional

old_streetline4

String

 

 

Optional

new_city

String

 

 

Optional

old_city

String

 

 

Optional

new_state_province

String

 

 

Optional

old_state_province

String

 

 

Optional

new_postal_code

String

 

 

Optional

old_postal_code

String

 

 

Optional

new_country_code

String

 

 

Optional

old_country_code

String

 

 

Optional

new_phone1

String

 

 

Optional

old_phone1

String

 

 

Optional

new_phone2

String

 

 

Optional

old_phone2

String

 

 

Optional

new_email_address

String

 

 

Optional

old_email_address

String

 

 

Optional

new_date1

String

10

This field is populated as indicated if the nonmonCode field has one of the following values:

[1000] = customer's corrected birthday.

[1106] = customer's new passport expiration date.

[1150] = customer's start date at new address.

[1152] = customer's new employment start date.

[1300] = customer's new bank relationship start date.

[1319] = customer's start date for vacation/travel.

[1400] = customer's new credit score date.

[2011] = account's new open date.

[2030] = account's new status date.

[2600] = account's new annual fee date.

[3000] = payment instrument's new last issue date.

[3010] = PAN's new member since date.

[3020] = payment instrument's new PIN set date.

[3102] = PAN's new status date.

[3400] = new token's provision date.

[3401] = token's new status date.

[4000] = business's new registration date.

[4400] = business's new credit score date.

Conditional

old_date1

String

10

This field is populated as indicated if the nonmonCode field has one of the following values:

[1000] = customer's previous incorrect birthday.

[1106] = customer's previous passport expiration date.

[1150] = customer's start date at previous address.

[1152] = customer's previous employment start date.

[1300] = customer's previous bank relationship start date.

[1400] = customer's previous credit score date.

[2011] = account's old open date.

[2030] = account's previous status date.

[2600] = account's previous annual fee date.

[3000] = payment instrument's previous last issue date.

[3010] = PAN's previous member since date.

[3020] = payment instrument's previous PIN set date.

[3102] = PAN's previous status date.

[3400] = previous token's provision date.

[3401] = token's previous status date.

[4000] = business's previous registration date.

[4400] = business's previous credit score date.

Conditional

new_date2

String

 

 

Optional

old_date2

String

 

 

Optional

new_id1

String

 

 

Optional

old_id1

String

 

 

Optional

new_id2

String

 

 

Optional

old_id2

String

 

 

Optional

new_code1

String

10

New Value to update card Status

Mandatory for Card Status 

Conditional

old_code1

String

10

Old Value to update card status

Mandatory for Card Status

Conditional

new_code2

String

 

 

Optional

old_code2

String

 

 

Optional

new_code3

String

 

 

Optional

old_code3

String

 

 

Optional

new_indicator1

String

 

 

Optional

old_indicator1

String

 

 

Optional

new_indicator2

String

 

 

Optional

old_indicator2

String

 

 

Optional

new_indicator3

String

 

 

Optional

old_indicator3

String

 

 

Optional

new_indicator4

String

 

 

Optional

old_indicator4

String

 

 

Optional

new_monetary_value

String

 

 

Optional

old_monetary_value

String

 

 

Optional

currency_code

String

 

 

Optional

currency_conversion_rate

String

 

 

Optional

new_numeric_value1

String

 

 

Optional

old_numeric_value1

String

 

 

Optional

new_numeric_value2

String

 

 

Optional

old_numeric_value2

String

 

 

Optional

new_character_value

String

 

 

Optional

old_character_value

String

 

 

Optional

new_text

String

 

 

Optional

old_text

String

 

 

Optional

comment

String

 

 

Optional

user_indicator01

String

 

 

Optional

user_indicator02

String

 

 

Optional

user_indicator03

String

 

 

Optional

user_indicator04

String

 

 

Optional

user_indicator05

String

 

 

Optional

user_code1

String

 

 

Optional

user_code2

String

 

 

Optional

user_code3

String

 

 

Optional

user_code4

String

 

 

Optional

user_code5

String

 

 

Optional

user_data01

String

 

 

Optional

user_data02

String

 

 

Optional

user_data03

String

 

 

Optional

user_data04

String

 

 

Optional

user_data05

String

 

 

Optional

user_data06

String

 

 

Optional

user_data07

String

 

 

Optional

user_data08

String

 

 

Optional

user_data09

String

 

 

Optional

user_data10

String

 

 

Optional

user_data11

String

 

 

Optional

user_data12

String

 

 

Optional

user_data13

String

 

 

Optional

user_data14

String

 

 

Optional

user_data15

String

 

 

Optional

Request JSON
{
   "NISrvRequest":{
      "request_card_nonmon":{
         "header":{
            "msg_id":"1207202122",
            "msg_type":"TRANSACTION",
            "msg_function":"REQ_CARD_NONMON",
            "src_application":"CRM",
            "target_application":"FALCON",
            "timestamp":"2021-07-12T16:02:01.777+05:30",
            "tracking_id":"120720211",
            "bank_id":"NISA"
         },
         "body":{
            "workflow":"CREDIT",
            "record_type":"NMON20",
            "card_number":"528801XXXXXX0035",
            "data_specification_version":"2.0",
            "clientid_from_header":"CCCD",
            "record_creation_date":"20210503",
            "record_creation_time":"142020",
            "record_creation_milliseconds":"256",
            "gmt_offset":"+4.00",
            "customerid_from_header":"123456",
            "customer_acct_number":"528801XXXXXX0035",
            "external_transactionid":"VPSNMO123456105",
            "transaction_date":"20210712",
            "transaction_time":"112255",
            "nonmon_code":"N3102",
            "pan":"12345678",
            "new_date1":"20210503",
            "old_date1":"20210305",
            "new_code1":"00",
            "old_code1":"11"
         }
      }
   }
}

Response parameters:

Node

Child Node

Type

Max

Description

Remark

header

msg_id

String

20

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

Unique Source Message ID e.g. “123456”

Mandatory

msg_type

String

11

Request Type

“TRANSACTION”

Mandatory

msg_function

String

50

Function name to be used “REP_CARD_NONMON”

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

Mandatory

target_application 

String

 

15

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

Mandatory

timestamp

String

19

Timestamp of the response

Date & time. Format  “DD/MM/YYYY HH:MM:SS”

Mandatory

tracking_id

String

20

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.

Mandatory

exception_details

application_name

String

20

NITIB_TCC_ADP_SA

Mandatory

date_time 

String

19

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

3

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_nonmon": {
      "header": {
        "msg_id": "12345",
        "msg_type": "TRANSACTION",
        "msg_function": "REP_CARD_NONMON",
        "src_application": "CRM",
        "target_application": "FALCON",
        "timestamp": "2021-04-04T22:00:34.929+05:30",
        "tracking_id": "12345",
        "bank_id": "SA"
      },
      "exception_details": {
        "application_name": "NITIB_TCC_ADP_SA",
        "date_time": "2021-04-04T22:00:34.929+05:30",
        "status": "S",
        "error_code": "0",
        "error_description": "Success",
        "transaction_ref_id": "12345"
      }
    }
  }
}

msg_id

Docs Navigation