• Register

Card Limit Update

Card Limit Update service is used for changing the credit limit of primary and supplementary cards. This service is applicable for Credit and Debit Cards. Below are the detailed specifications of this API.

Download

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

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

 10

N/A

Optional

body

 

 

card_identifier_id

String

32

454545XXXXXX1234

Mandatory 
card_identifier_type String 20 CONTRACT_NUMBER or EXID Mandatory

card_role

String

1

P (Primary) / S (Supplementary)

Mandatory

limit

limit_type

String

32

 Refer to limits

 

Mandatory

currency

String

3

Optional for counters Ex AED

Mandatory

value

String

20

Amount or Counters

Mandatory
date_from String 10 DD/MM/YYYY If Temporary Limit Conditional

date_to

String

10

DD/MM/YYYY If Temporary Limit

Conditional

reason_details

String

256

Credit Limit Amendment

Mandatory

 

Request JSON
{
    "NISrvRequest": {
        "request_card_limit_change": {
            "header": {
                "msg_id": "822624539",
                "msg_type": "TRANSACTION",
                "msg_function": "REQ_CARD_LIMIT_CHANGE",
                "src_application": "IVR",
                "target_application": "WAY4",
                "timestamp": "2020-07-19T13:46:31.022+04:00",
                "tracking_id": "2268901",
                "bank_id": "PRMBK"
            },
            "body": {
                "card_identifier_id": "XXXXXXXXXXXXXXXX",
                "card_identifier_type": "CONTRACT_NUMBER",
                "card_role": "P",
                "limit": {
                    "limit_type": "FIN_LIMIT",
                    "currency": "AED",
                    "value": "25000",
                     "date_from": "02/01/2023",
                    "date_to": "02/01/2025"
                },
                "reason_details": "Credit Limit Amendment"
            }
        }
    }
}

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

Mandatory

msg_type

String

12

Request Type

Mandatory

msg_function

String

50

Function name to be used

Default: "REP_CARD_LIMIT_CHANGE"

Mandatory

src_application

String

10

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

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

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_limit_change":{
      "header":{
        "msg_id":"226001",
        "msg_type":"TRANSACTION",
        "msg_function":"REP_CARD_LIMIT_CHANGE",
        "src_application":"IVR",
        "target_application":"PCMS",
        "timestamp":"19/07/2020 13:46:35",
        "tracking_id":"226001",
        "bank_id":"SSP"
      },
      "exception_details":{
        "application_name":"NITIB_TCC_ADP_SSP_1",
        "date_time":"2020-07-19T13:46:33.329+04:00",
        "status":"S",
        "error_code":"000",
        "error_description":"Success",
        "transaction_ref_id":"1761831"
      }
    }
  }
}

version 7 as of 1 year ago by sumit ojha

0 Comments

Please sign in to post a comment.

Docs Navigation