Create Client Payment Limit API

The Create Client Payment Limit API is used to set the limits on the limits at client or customer-level.

This set of APIs is responsible for setting, fetching, and updating the payment limits for customers based on unique groups of IMPL IDs.
Refer to the IMPL IDs table for the details
Each group of IMPL IDs will have its limit bucket.
The grouping of IMPL IDs and assigning a default program-level limit to them shall be a client-level configuration that is done manually.
Each IMPL ID group will be uniquely identified by its categoryId

Possible limits that can be set are:

Per transaction amount
Daily amount
Monthly amount
Yearly amount
Daily no. of transactions (velocity)
Monthly no. of transactions (velocity)
Yearly no. of transactions (velocity)

The limit restoration shall happen at:

Daily limits will be restored at 11:59:59 HR every day.
Monthly limits will be restored at 11:59:59 HR on the last day of the calendar month.
Yearly limits will be restored at 11:59:59 HR on the last day of the calendar year.

Environment


Sandbox	<https://kong-pp-hexappiuat.pc.enstage-sas.com/api/v2/limitService/limitmanagement/
Production	Contact your WIBMO KAM or support.

Sample request

curl --request POST \
     --url http://192.168.105.123:2084/api/v2/limitService/limitmanagement/api/v1/customerLimit \
     --header 'bankId: 7020' \
     --header 'clientId: 1020' \
     --header 'content-type: application/json' \
     --header 'entityId: 100' \
     --header 'secureCode: uvHWhIQfqgzWP8WCfpkIct' \
     --header 'x-api-key: QAl1234fyeffi75642' \
     --data '
{
  "token": "uHJ8K+zQ+tkcQDXHk2JsaDL/WBiCXjwxCWaiTo4U2tdYKwa0unii2UlXbHAP3CP5YtzlGkm5sXANf2987q+7Pg=="
}
'

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:

Attribute	Type	Parameter Requirement	Description
responseCode	String(4)	Mandatory	Contains the status of the transaction. 00 indicates success.
customerId	String (15)	Mandatory	Contains the customer ID.
clientTxnId	String (50)	Mandatory	Contains the client transaction ID.
clientId	String	Mandatory	Unique ID for the client
bankId	Numeric(4)	Mandatory	Value copied from request header
responseMessage	String(100)	Optional	Response message based on response code will be sent
responseDateTime	Numeric(14)	Mandatory	Response date time in the format YYYYMMDDHHMMSS with time in 24 hr format

Sample response (Decrypted)

{
	"responseCode": "00",
	"customerId": "1027",
	"clientTxnID": "102727",
	"clientId": "1040",
	"bankId": "2040",
	"responseDateTime": "20230203114910",
	"responseMessage": "SUCCESS"
}

Request parameters