Fetch Customer or Client Payment Limit API

The Fetch Customer or Client Payment Limit is used to fetch the customer or client payment limit. For the client payment, you need to pass only the program ID, where as for customer limit, you need to pass program ID, client ID, and bank ID.

Environment

  
Sandboxhttps://kong-pp-hexappiuat.pc.enstage-sas.com/api/v2/limitService/limitmanagement/
ProductionContact your WIBMO KAM or support.
Sample request

Client Limit

curl --request GET \
     --header 'x-api-key: 4A02C4267C9A97A1488AB3259FD1A725'

Customer Limit

curl --request GET \
     --url 'http://192.168.105.123:2084/api/v2/limitService/limitmanagement/api/v1/customerLimit?programId=1' \
     --header 'bankId: 6060' \
     --header 'clientId: 1020' \
     --header 'x-api-key: 4A02C4267C9A97A1488AB3259FD1A725'
Response parameters (Decrypted)

This API will provide a token in the response that must be decrypted using the Decrypt API. The decrypted response is similar to the following:

Client Limit

AttributeTypeParameter RequirementDescription
responseCodeString(4)MandatoryContains the status of the transaction. 00 indicates success.
responseDateTimeNumeric(14)MandatoryResponse date time in the format YYYYMMDDHHMMSS with time in 24 hr format
responseMessageString(100)OptionalResponse message based on response code will be sent
bankIdNumeric(4)MandatoryValue copied from request header
clientIdString(4)MandatoryUnique ID for the client
descriptionString(100)OptionalReserved field to send information to client
limits.categoryIdNumeric(10)OptionalUnique ID of the payment category
limits.categoryNameString(50)OptionalName of the transaction payment category
limits.program.perTransactionLimitNumeric(18)OptionalLimit allowed for the per transaction
limits.program.dailyAmountLimitNumeric(18)OptionalDaily amount limit allowed for the customer
limits.program.dailyCountLimitNumeric(10)OptionalDaily limit count allowed for the customer
limits.program.monthlyAmountLimitNumeric(18)OptionalMonthly amount limit allowed for the customer
limits.program.monthlyCountLimitNumeric(10)OptionalMonthly limit count allowed for the customer
limits.program.yearlyAmountLimitNumeric(18)OptionalYearly amount limit allowed for the customer
limits.program.yearlyCountLimitNumeric(10)OptionalYearly limit count allowed for the customer

Customer Limit

AttributeTypeParameter RequirementDescription
responseCodeString(4)MandatoryContains the status of the transaction. 00 indicates success.
responseDateTimeNumeric(14)MandatoryResponse date time in the format YYYYMMDDHHMMSS with time in 24 hr format
responseMessageString(100)OptionalResponse message based on response code will be sent
bankIdNumeric(4)MandatoryValue copied from request header
clientIdStringMandatoryUnique ID for the client
descriptionString(100)OptionalReserved field to send information to client
limits.categoryIdNumeric(10)OptionalUnique ID of the payment category
limits.categoryNameString(50)OptionalName of the transaction payment category
limits.program.perTransactionLimitNumeric(18)OptionalLimit allowed for the per transaction
limits.program.dailyAmountLimitNumeric(18)OptionalDaily amount limit allowed for the customer
limits.program.dailyCountLimitNumeric(10)OptionalDaily limit count allowed for the customer
limits.program.monthlyAmountLimitNumeric(18)OptionalMonthly amount limit allowed for the customer
limits.program.monthlyCountLimitNumeric(10)OptionalMonthly limit count allowed for the customer
limits.program.yearlyAmountLimitNumeric(18)OptionalYearly amount limit allowed for the customer
limits.program.yearlyCountLimitNumeric(10)OptionalYearly limit count allowed for the customer
limits.customer.perTransactionLimitNumeric(18)OptionalLimit allowed for the per transaction
limits.customer.dailyAmountLimitNumeric(18)OptionalDaily amount limit allowed for the customer
limits.customer.dailyCountLimitNumeric(10)OptionalDaily limit count allowed for the customer
limits.customer.monthlyCountLimitNumeric(10)OptionalMonthly limit count allowed for the customer
limits.customer.monthlyAmountLimitNumeric(18)OptionalMonthly amount limit allowed for the customer
limits.customer.yearlyAmountLimitNumeric(18)OptionalYearly amount limit allowed for the customer
limits.customer.yearlyCountLimitNumeric(10)OptionalYearly limit count allowed for the customer
Sample response (Decrypted)

Client Limit

{
	"description": "Customer Limit Success",
	"responseCode": "00",
	"clientId": "1040",
	"bankId": "2040",
	"programId": 1,
	"responseDateTime": "20230203114910",
	"responseMessage": "SUCCESS",
	"limits": [
		{
			"categoryId": "1234",
			"categoryName": "Merchant Payments",
			"program": {
				"monthlyCountLimit": 1000,
				"monthlyAmountLimit": 200000,
				"yearlyCountLimit": 10000,
				"yearlyAmountLimit": 2400000
			}
		},
		{
			"categoryId": "1235",
			"categoryName": "Fund Transfer",
			"program": {
				"perTransactionLimit": 1000,
				"dailyCountLimit": 50,
				"dailyAmountLimit": 10000,
				"monthlyCountLimit": 1000,
				"monthlyAmountLimit": 200000,
				"yearlyCountLimit": 10000,
				"yearlyAmountLimit": 2400000
			}
		},
		{
			"categoryId": "5678",
			"categoryName": "Bill Pay and Recharge",
			"program": {
				"perTransactionLimit": 1000,
				"dailyCountLimit": 50,
				"dailyAmountLimit": 10000
			}
		}
	]
}

Customer Limit

{
	"description": "Customer Limit Success",
	"responseCode": "00",
	"clientId": "1040",
	"bankId": "2040",
	"programId": 1,
	"customerId": "000023",
	"responseDateTime": "20230203114910",
	"responseMessage": "SUCCESS",
	"limits": [
		{
			"categoryId": "1234",
			"categoryName": "Merchant Payments",
			"program": {
				"perTransactionLimit": 1000,
				"dailyCountLimit": 50,
				"dailyAmountLimit": 10000,
				"monthlyCountLimit": 1000,
				"monthlyAmountLimit": 200000,
				"yearlyCountLimit": 10000,
				"yearlyAmountLimit": 2400000
			},
			"customer": {
				"perTransactionLimit": 1000,
				"dailyCountLimit": 50,
				"dailyAmountLimit": 10000,
				"monthlyCountLimit": 1000,
				"monthlyAmountLimit": 200000,
				"yearlyCountLimit": 10000,
				"yearlyAmountLimit": 2400000
			}
		},
		{
			"categoryId": "1235",
			"categoryName": "Fund Transfer",
			"program": {
				"perTransactionLimit": 1000,
				"dailyCountLimit": 50,
				"dailyAmountLimit": 10000,
				"monthlyCountLimit": 1000,
				"monthlyAmountLimit": 200000,
				"yearlyCountLimit": 10000,
				"yearlyAmountLimit": 2400000
			},
			"customer": {
				"perTransactionLimit": 1000,
				"dailyCountLimit": 50,
				"dailyAmountLimit": 10000,
				"monthlyCountLimit": 1000,
				"monthlyAmountLimit": 200000,
				"yearlyCountLimit": 10000,
				"yearlyAmountLimit": 2400000
			}
		},
		{
			"categoryId": "5678",
			"categoryName": "Bill Pay and Recharge",
			"program": {
				"perTransactionLimit": 1000,
				"dailyCountLimit": 50,
				"dailyAmountLimit": 10000,
				"monthlyCountLimit": 1000,
				"monthlyAmountLimit": 200000,
				"yearlyCountLimit": 10000,
				"yearlyAmountLimit": 2400000
			},
			"customer": {
				"perTransactionLimit": 1000,
				"dailyCountLimit": 50,
				"dailyAmountLimit": 10000,
				"monthlyCountLimit": 1000,
				"monthlyAmountLimit": 200000,
				"yearlyCountLimit": 10000,
				"yearlyAmountLimit": 2400000
			}
		}
	]
}

Request parameters

Language
Click Try It! to start a request and see the response here!