The Create Card-Level Limit API is used to set the limits on the card transactions in terms of amount and the number of transactions on top of the transaction channels.

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/hexappiuat/api/v2/payuppi/api/limit/v2/cards
Production	Contact your WIBMO KAM or support.

Sample request

curl --request POST \
     --url https://payusandbox-kong.pc.enstage-sas.com/hexappiuat/api/v2/qa/payuppi/odrService/api/odr/v2/viewservicerequests \
     --header 'X-Consumer-Custom-ID: 8654891RYY57Q0C54329BAD9C7A2DU0G1' \
     --header 'bankId: 6060' \
     --header 'clientId: 2040' \
     --header 'content-type: application/json' \
     --header 'entityId: 100' \
     --header 'secureCode: FSeAh0yFMopKgU6UNuYLk6' \
     --header 'x-api-key: 4A02C4267C9A97A1488AB3259FD1A725' \
     --data '
{
  "token": "cbmybddd/blVjlCsFeyyva3WxJaMO0uxS+Mn/IsXi2zFi5W1M6tJYceQ4sUFJ8FZR0FmBklVbctfiSHBR4Yw/G0vFzJHby6O1CjVpYLRnMKnmDraLKcXxRqXmEc2x2fhsbhOe/9IDdnvTAnoeBizkygnUaMxWTh3mqrPBrhIR+jhbpLRATv+USKxccqmWXd7wW38KAql8uK4AbY6802/sw=="
}
'

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	Numeric (4)	Mandatory	API response code
responseMessage	String (100)	Mandatory	API response description based on the response code
responseDateTime	DD-MM-YYYY HH:MM:SS	Mandatory	Response timestamp
id	Numeric (10)	Mandatory	Unique ID generated for the limit created.
clientId	Numeric (10)	Mandatory	Client ID for the program
programId	Numeric (2)	Mandatory	Echoed from request.
kycProfileId	Numeric (3)	Mandatory	Echoed from the request.
urn	Numeric (20)	Mandatory	Unique reference number for the customer
customerId	String	Mandatory	Unique identifier for the customer.
fundFlowType	Numeric (2)	Mandatory	Echoed from the request.
channelId	Numeric (2)	Mandatory	Echoed from the request.
perTxnLimit	Numeric (10)	Mandatory	Per transaction limit
dailyLimit	Numeric (10)	Optional	Daily limit
yearlyLimit	Numeric (10)	Optional	yearly limit
monthlyLimit	Numeric (10)	Optional	Monthly limit
dailyCount	Numeric (10)	Optional	Daily txn count
yearlyCount	Numeric (10)	Optional	yearly txn count
monthlyCount	Numeric (10)	Optional	Monthly txn count
outstandingBalance	Numeric (10)	Optional	Overall limit of the card
status	Numeric (10)	Mandatory	Status of the request.
createdDateTime	DD-MM-YYYY HH:MM:SS	Mandatory	Created date time of the limit
lastModifiedDateTime	DD-MM-YYYY HH:MM:SS	Mandatory	modified date time of the limit

Sample response (Decrypted)

{
    "responseCode": 0,
    "responseMessage": "SUCCESS",
    "responseDateTime": "02-05-2024 12:37:56",
    "id": 8,
    "clientId": "2",
    "programId": "3",
    "customerId": "000000000225",
    "urn": "10000519",
    "kycProfileId": "150",
    "fundFlowType": "2",
    "channelId": "1",
    "perTxnLimit": "1000",
    "dailyCount": "10",
    "dailyLimit": "5000",
    "monthlyCount": "60",
    "monthlyLimit": "40000",
    "yearlyCount": "100",
    "yearlyLimit": "100000",
    "outstandingBalance": "5000",
    "status": 1,
    "createdDateTime": "02-05-2024 12:37:55",
    "lastModifiedDateTime": "02-05-2024 12:37:55"
}

Error codes

Error Code	Description
500	SYSTEM ERROR
400	BAD REQUEST
10701	INVALID CLIENT ID
10701	INVALID BANK ID
10617	PROGRAM ID SHOULD CONTAIN ONLY NUMBERS
10618	CUSTOMER ID SHOULD CONTAIN ONLY NUMBERS
10619	URN SHOULD CONTAIN ONLY NUMBERS
10620	KYC PROFILE ID SHOULD CONTAIN ONLY NUMBERS
10621	FUND FLOW TYPE SHOULD CONTAIN ONLY NUMBERS
10622	CHANNEL ID SHOULD CONTAIN ONLY NUMBERS"
10106	PROGRAM ID MISSING
10107	CLIENT ID MISSING IN HEADER
10108	CUSTOMER ID MISSING
10110	ATLEAST ONE FIELD IS REQUIRED FOR MODIFICATION
10111	INVALID CONTENT TYPE. NEED ARRAY
10112	RECORD ALREADY DELETED
10113	INVALID STATUS
10114	INVALID CUSTOMER-ID
10115	INVALID PROGRAM-ID
10116	INVALID FUND FLOW TYPE
10117	INVALID KYC PROFILE ID
10118	INVALID CHANNELID
10119	KYC PROFILE ID IS MISSING OR IS LESS THAN EQUAL TO ZERO
10120	FUND FLOW TYPE IS MISSING OR IS LESS THAN EQUAL TO ZERO
10121	CHANNELID IS MISSING OR IS LESS THAN EQUAL TO ZERO
10191	CARD LEVEL LIMIT ALREADY EXISTS
10193	CARD LIMIT OR COUNT CANNOT EXCEED CUSTOMER LIMIT
10194	CARD LIMIT OR COUNT CANNOT EXCEED PROGRAM LIMIT
10195	NO EXISTING PROGRAM FOR THIS CARD

Request parameters

200Client payment limit created or updated successfully

400Bad request

401Unauthorized

500Internal server error