Fetch Wallet Level Limits API

The Fetch Wallet Level Limits API is used to fetch the wallet level limits.

Environment

Sample request
curl --request POST \
     --url https://payusandbox-kong.pc.enstage-sas.com/uat/sbx/limitService/limitmanagement/api/v1/fetchWalletLimit \
     --header 'X-Consumer-Custom-ID: F42BC4E7B801C834B630DE498473533F' \
     --header 'bankId: 6060' \
     --header 'clientId: 1060' \
     --header 'content-type: application/json' \
     --header 'entityId: 100' \
     --header 'secureCode: pu8gSMLNE7pNv36IlUmstU' \
     --header 'x-api-key: 4A02C4267C9A97A1488AB3259FD1A725' \
     --data '
{
  "token": "dS7qDwXJW9kuGpcuLxvwXGX9v+uAID/NhAXSWpSXLm7AwlKlGDkVxNs/f0nqBQzyAK1L/yDON9V1SxdcuUcU7Q=="
}
'
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:

AttributeTypeParameter RequirementDescription
descriptionStringOptionalDescribes the result of the fetch operation
responseCodeString(4)MandatoryStatus of the transaction. 00 indicates success.
clientIdString(10)OptionalUnique ID for the client
bankIdNumeric (4)OptionalBank ID related to the client
customerIdStringOptionalUnique ID for the customer
responseDateTimeNumeric (14)MandatoryResponse date-time in the format YYYYMMDDHHMMSS
responseMessageString(100)MandatoryResponse message based on the response code
limits[].programSubWalletIdStringOptionalUnique ID of the wallet category while onboarding a client
limits[].subwalletNameStringOptionalName of the wallet category while onboarding a client
limits[].program.
perTransactionLimit
Numeric(18)OptionalPer transaction limit for the program
limits[].program.kycProfileNumericOptionalKYC profile of the customer
limits[].program.
maxWalletBalanceLimit
Numeric(18)OptionalMaxWallet wallet balance limit for the program
limits[].program.
dailyUnloadTransactionCount
Numeric(10)OptionalDaily unload transaction count limit for the program
limits[].program.
dailyLoadTransactionCount
Numeric(10)OptionalDaily load transaction count limit for the program
limits[].program.
monthlyUnloadTransactionCount
Numeric(10)OptionalMonthly unload transaction count limit for the program
limits[].program.
monthlyLoadTransactionCount
Numeric(10)OptionalMonthly load transaction count limit for the program
limits[].program.
annualUnloadTransactionCount
Numeric(10)OptionalAnnual unload transaction count limit for the program
limits[].program.
annualLoadTransactionCount
Numeric(10)OptionalAnnual load transaction count limit for the program
limits[].program.dailyLoadLimitNumeric(18)OptionalDaily load limit for the program
limits[].program.dailyUnloadLimitNumeric(18)OptionalDaily unload limit for the program
limits[].program.monthlyLoadLimitNumeric(18)OptionalMonthly load limit for the program
limits[].program.monthlyUnloadLimitNumeric(18)OptionalMonthly unload limit for the program
limits[].program.annualLoadLimitNumeric(18)OptionalAnnual load limit for the program
limits[].program.annualUnloadLimitNumeric(18)OptionalAnnual unload limit for the program
limits[].wallet.accountNumberStringOptionalAccount number for the wallet
limits[].wallet.kycProfileNumericOptionalKYC profile of the customer
limits[].wallet.perTransactionLimitNumeric(18)OptionalPer transaction limit for the wallet
limits[].wallet.
maxWalletBalanceLimit
Numeric(18)OptionalAvailable balance limit for the wallet
limits[].wallet.
dailyUnloadTransactionCount
Numeric(10)OptionalDaily unload transaction count limit for the wallet
limits[].wallet.
dailyLoadTransactionCount
Numeric(10)OptionalDaily load transaction count limit for the wallet
limits[].wallet.
monthlyUnloadTransactionCount
Numeric(10)OptionalMonthly unload transaction count limit for the wallet
limits[].wallet.
monthlyLoadTransactionCount
Numeric(10)OptionalMonthly load transaction count limit for the wallet
limits[].wallet.
annualUnloadTransactionCount
Numeric(10)OptionalAnnual unload transaction count limit for the wallet
limits[].wallet.
annualLoadTransactionCount
Numeric(10)OptionalAnnual load transaction count limit for the wallet
limits[].wallet.dailyLoadLimitNumeric(18)OptionalDaily load limit for the wallet
limits[].wallet.dailyUnloadLimitNumeric(18)OptionalDaily unload limit for the wallet
limits[].wallet.monthlyLoadLimitNumeric(18)OptionalMonthly load limit for the wallet
limits[].wallet.monthlyUnloadLimitNumeric(18)OptionalMonthly unload limit for the wallet
limits[].wallet.annualLoadLimitNumeric(18)OptionalAnnual load limit for the wallet
limits[].wallet.annualUnloadLimitNumeric(18)OptionalAnnual unload limit for the wallet
Sample response (Decrypted)
{
    "description": "Fetch Wallet Limit Success",
    "responseCode": "00",
    "clientId": "2",
    "bankId": 7040,
    "responseDateTime": "20240919183528",
    "responseMessage": "SUCCESS",
    "limits": [
        {
            "programSubWalletId": "2051792e155_3",
            "subwalletName": "Wallet_1",
            "program": {
                "kycProfile": 30,
                "perTransactionLimit": 2100000,
                "maxWalletBalanceLimit": 3000000,
                "dailyUnloadTransactionCount": 30,
                "dailyLoadTransactionCount": 40,
                "monthlyUnloadTransactionCount": 300,
                "monthlyLoadTransactionCount": 400,
                "annualUnloadTransactionCount": 3000,
                "annualLoadTransactionCount": 4000,
                "dailyLoadLimit": 1300000,
                "dailyUnloadLimit": 1300000,
                "monthlyLoadLimit": 160000000,
                "monthlyUnloadLimit": 160000000,
                "annualLoadLimit": 260000000,
                "annualUnloadLimit": 260000000
            },
            "wallet": {
                "accountNumber": 704030003041202,
                "kycProfile": 30,
                "perTransactionLimit": 240000,
                "maxWalletBalanceLimit": 600000,
                "dailyUnloadTransactionCount": 15,
                "dailyLoadTransactionCount": 10,
                "monthlyUnloadTransactionCount": 10,
                "monthlyLoadTransactionCount": 25,
                "annualUnloadTransactionCount": 100,
                "annualLoadTransactionCount": 150,
                "dailyLoadLimit": 600000,
                "dailyUnloadLimit": 600000,
                "monthlyLoadLimit": 3500000,
                "monthlyUnloadLimit": 2600000,
                "annualLoadLimit": 40000000,
                "annualUnloadLimit": 250000000
            }
        },
        {
            "programSubWalletId": "2051792e155_4",
            "subwalletName": "Wallet_2",
            "program": {
                "kycProfile": 30,
                "perTransactionLimit": 2000000,
                "maxWalletBalanceLimit": 2000000,
                "dailyUnloadTransactionCount": 25,
                "dailyLoadTransactionCount": 35,
                "monthlyUnloadTransactionCount": 250,
                "monthlyLoadTransactionCount": 350,
                "annualUnloadTransactionCount": 2500,
                "annualLoadTransactionCount": 3500,
                "dailyLoadLimit": 1250000,
                "dailyUnloadLimit": 1250000,
                "monthlyLoadLimit": 155000000,
                "monthlyUnloadLimit": 155000000,
                "annualLoadLimit": 255000000,
                "annualUnloadLimit": 255000000
            },
            "wallet": {
                "accountNumber": 704030003041211,
                "kycProfile": 30,
                "perTransactionLimit": 100000,
                "maxWalletBalanceLimit": 500000,
                "dailyUnloadTransactionCount": 10,
                "dailyLoadTransactionCount": 15,
                "monthlyUnloadTransactionCount": -1,
                "monthlyLoadTransactionCount": -1,
                "annualUnloadTransactionCount": -1,
                "annualLoadTransactionCount": -1,
                "dailyLoadLimit": 500000,
                "dailyUnloadLimit": 500000,
                "monthlyLoadLimit": 3000000,
                "monthlyUnloadLimit": 2500000,
                "annualLoadLimit": 36000000,
                "annualUnloadLimit": 36000000
            }
        }
    ]
}
Error codes
Error CodeDescription
0SUCCESS
10086INVALID FIELD FORMAT IN REQUEST BODY
10108CUSTOMER ID MISSING
10107CLIENT ID MISSING IN HEADER
10700BANK ID MISSING IN HEADER
10701INVALID CLIENT ID
10702INVALID BANK ID
12010SECURE_CODE_IS_MISSING
12011INVALID_SECURE_CODE
10232CLIENT ID PROGRAM ID MISTMATCH
12013CUSTOMER NOT FOUND
10235CUSTOMER_ID_WALLET_ACCOUNT_NUMBER_MISMATCH

Request parameters

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