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. perTransactionLimit	Numeric(18)	Optional	Per transaction limit for the program
limits[].program.kycProfile	Numeric	Optional	KYC profile of the customer
limits[].program. maxWalletBalanceLimit	Numeric(18)	Optional	MaxWallet wallet balance limit for the program
limits[].program. dailyUnloadTransactionCount	Numeric(10)	Optional	Daily unload transaction count limit for the program
limits[].program. dailyLoadTransactionCount	Numeric(10)	Optional	Daily load transaction count limit for the program
limits[].program. monthlyUnloadTransactionCount	Numeric(10)	Optional	Monthly unload transaction count limit for the program
limits[].program. monthlyLoadTransactionCount	Numeric(10)	Optional	Monthly load transaction count limit for the program
limits[].program. annualUnloadTransactionCount	Numeric(10)	Optional	Annual unload transaction count limit for the program
limits[].program. annualLoadTransactionCount	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. maxWalletBalanceLimit	Numeric(18)	Optional	Available balance limit for the wallet
limits[].wallet. dailyUnloadTransactionCount	Numeric(10)	Optional	Daily unload transaction count limit for the wallet
limits[].wallet. dailyLoadTransactionCount	Numeric(10)	Optional	Daily load transaction count limit for the wallet
limits[].wallet. monthlyUnloadTransactionCount	Numeric(10)	Optional	Monthly unload transaction count limit for the wallet
limits[].wallet. monthlyLoadTransactionCount	Numeric(10)	Optional	Monthly load transaction count limit for the wallet
limits[].wallet. annualUnloadTransactionCount	Numeric(10)	Optional	Annual unload transaction count limit for the wallet
limits[].wallet. annualLoadTransactionCount	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

Request parameters