• Register

Card Used Limits

This service is used for retrieving card limit details. This service is only applicable for Debit card. Below are the detailed specifications for this API.

Download

Request Parameters:

Node

Child Node

Type 

Length

Description

Remarks

header

msg_id

String

12

Unique Source Message ID

Mandatory

msg_type

String

12

Request Type

Default: “ENQUIRY”

Mandatory

msg_function

String

50

Function name to be used

Default: "REQ_CARD_USED_LIMITS"

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

Mandatory

bank_id

String

4

Source Bank Id Ex: bankID

Mandatory

instance_id

String

5

N/A

Optional

body

card_number

String

Min – 16

Max - 19

16-digit card no

e.g: XXXXXXXXXXXX0833

First 6 digits will be BIN for cards

Mandatory 

Request JSON
{
  "NISrvRequest":{
    "request_card_used_limits":{
      "header":{
        "msg_id":"223001",
        "msg_type":"TRANSACTION",
        "msg_function":"REQ_CARD_USED_LIMITS",
        "src_application":"IVR",
        "target_application":"PCMS",
        "timestamp":"2020-07-19T12:59:21.609+04:00",
        "tracking_id":"223001",
        "bank_id":"bankID"
      },
      "body":{
        "card_number":"999841XX18869X2X"
      }
    }
  }
}

 

 

Response Parameter:

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 Default: “REP_CARD_USED_LIMITS” 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 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. 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
body daily_atm_limit Number 17 No Decimal place Mandatory
daily_pos_limit Number 17 No Decimal place Mandatory
daily_ecom_limit Number 17 No Decimal place Mandatory
used_atm_limit Number 17 2 Decimal place Mandatory
used_pos_limit Number 17 2 Decimal place Mandatory
used_ecom_limit Number 17 2 Decimal place Mandatory
transaction_date_atm Number 6 Format : YYMMDD Mandatory
transaction_date_pos Number 6 Format : YYMMDD Mandatory
transaction_date_ecom Number 6 Format : YYMMDD Mandatory
Response JSON
{
  "NISrvResponse":{
    "response_card_used_limits":{
       "header":{
        "msg_id":"56000",
        "msg_type":"ENQUIRY",
        "msg_function":"REP_CARD_USED_LIMITS",
        "src_application":"IVR",
        "target_application":"PCMS",
        "timestamp":"2020-06-14T11:06:36.588+04:00",
        "tracking_id":"56000",
        "bank_id":"SSP",
        "instance_id":"56000"
      },
      "exception_details":{
        "application_name":"NITIB_TCC_ADP_SSP_1",
        "date_time":"2020-07-16T10:33:47.934+04:00",
        "status":"S",
        "error_code":"000",
        "error_description":"Success",
        "transaction_ref_id":null
      },
      "body":{
		"daily_atm_limit": "1000",
		"daily_pos_limit": "1000",
		"daily_ecom_limit": "1000",
		"used_atm_limit": "1000",
		"used_pos_limit": "1000",
		"used_ecom_limit": "1000",
		"transaction_date_atm": "1000",
		"transaction_date_pos": "1000",
		"transaction_date_ecom": "1000"
      }
    }
  }
}


Docs Navigation