The Fetch Wallet Level Limits API is used to fetch the wallet level limits.
Environment
| Sandbox | <https://kong-pp-hexappiuat.pc.enstage-sas.com/hexappiuat/api/v2/payuppi/api//limitmanagement/api/v1/fetchWalletLimit |
| Production | Contact your WIBMO KAM or support. |
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:
Attribute | Type | Parameter Requirement | Description |
|---|---|---|---|
description | String | Optional | Describes the result of the fetch operation |
responseCode | String(4) | Mandatory | Status of the transaction. 00 indicates success. |
clientId | String(10) | Optional | Unique ID for the client |
bankId | Numeric (4) | Optional | Bank ID related to the client |
customerId | String | Optional | Unique ID for the customer |
responseDateTime | Numeric (14) | Mandatory | Response date-time in the format YYYYMMDDHHMMSS |
responseMessage | String(100) | Mandatory | Response message based on the response code |
limits[].programSubWalletId | String | Optional | Unique ID of the wallet category while onboarding a client |
limits[].subwalletName | String | Optional | Name of the wallet category while onboarding a client |
limits[].program. | Numeric(18) | Optional | Per transaction limit for the program |
limits[].program.kycProfile | Numeric | Optional | KYC profile of the customer |
limits[].program. | Numeric(18) | Optional | MaxWallet wallet balance limit for the program |
limits[].program. | Numeric(10) | Optional | Daily unload transaction count limit for the program |
limits[].program. | Numeric(10) | Optional | Daily load transaction count limit for the program |
limits[].program. | Numeric(10) | Optional | Monthly unload transaction count limit for the program |
limits[].program. | Numeric(10) | Optional | Monthly load transaction count limit for the program |
limits[].program. | Numeric(10) | Optional | Annual unload transaction count limit for the program |
limits[].program. | Numeric(10) | Optional | Annual load transaction count limit for the program |
limits[].program.dailyLoadLimit | Numeric(18) | Optional | Daily load limit for the program |
limits[].program.dailyUnloadLimit | Numeric(18) | Optional | Daily unload limit for the program |
limits[].program.monthlyLoadLimit | Numeric(18) | Optional | Monthly load limit for the program |
limits[].program.monthlyUnloadLimit | Numeric(18) | Optional | Monthly unload limit for the program |
limits[].program.annualLoadLimit | Numeric(18) | Optional | Annual load limit for the program |
limits[].program.annualUnloadLimit | Numeric(18) | Optional | Annual unload limit for the program |
limits[].wallet.accountNumber | String | Optional | Account number for the wallet |
limits[].wallet.kycProfile | Numeric | Optional | KYC profile of the customer |
limits[].wallet.perTransactionLimit | Numeric(18) | Optional | Per transaction limit for the wallet |
limits[].wallet. | Numeric(18) | Optional | Available balance limit for the wallet |
limits[].wallet. | Numeric(10) | Optional | Daily unload transaction count limit for the wallet |
limits[].wallet. | Numeric(10) | Optional | Daily load transaction count limit for the wallet |
limits[].wallet. | Numeric(10) | Optional | Monthly unload transaction count limit for the wallet |
limits[].wallet. | Numeric(10) | Optional | Monthly load transaction count limit for the wallet |
limits[].wallet. | Numeric(10) | Optional | Annual unload transaction count limit for the wallet |
limits[].wallet. | Numeric(10) | Optional | Annual load transaction count limit for the wallet |
limits[].wallet.dailyLoadLimit | Numeric(18) | Optional | Daily load limit for the wallet |
limits[].wallet.dailyUnloadLimit | Numeric(18) | Optional | Daily unload limit for the wallet |
limits[].wallet.monthlyLoadLimit | Numeric(18) | Optional | Monthly load limit for the wallet |
limits[].wallet.monthlyUnloadLimit | Numeric(18) | Optional | Monthly unload limit for the wallet |
limits[].wallet.annualLoadLimit | Numeric(18) | Optional | Annual load limit for the wallet |
limits[].wallet.annualUnloadLimit | Numeric(18) | Optional | Annual 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 Code | Description |
|---|---|
| 0 | SUCCESS |
| 10086 | INVALID FIELD FORMAT IN REQUEST BODY |
| 10108 | CUSTOMER ID MISSING |
| 10107 | CLIENT ID MISSING IN HEADER |
| 10700 | BANK ID MISSING IN HEADER |
| 10701 | INVALID CLIENT ID |
| 10702 | INVALID BANK ID |
| 12010 | SECURE_CODE_IS_MISSING |
| 12011 | INVALID_SECURE_CODE |
| 10232 | CLIENT ID PROGRAM ID MISTMATCH |
| 12013 | CUSTOMER NOT FOUND |
| 10235 | CUSTOMER_ID_WALLET_ACCOUNT_NUMBER_MISMATCH |