Update Usage Limits

This endpoint allows you to adjust your usage limit, either by lowering it or requesting an increase. Each usage limit has two values: the defined amount and the maximum amount. The maximum amount is updated whenever your usage limit is raised. The defined amount can be freely adjusted within the range of the maximum amount. However, any requests to exceed the established maximum will require a review and analysis before they are applied.

Headers

Name	Description
x-delbank-api-key	Required. API key
x-delfinance-account-id	Required. The Delfinance bank account number

Body

Name	Type	Description
serviceType	enum	Required. The type of transaction you want to change, Domains: PIX - Pix transfer limits TRANSFER_EXTERNAL - External transfer TED limits TRANSFER_INTERNAL - Internal transfer limits PAYMENT - Bankslip payment limits DEBIT - Monthly debit limit
limits	object	Object containing the type of limits you want to change and the amount
limitType	enum	The type of limit you want to change, Domains: DAYTIME_TOTAL - Total amount that can be debited from 06:00 to 20:00 NIGHTTIME_TOTAL - Total amount that can be debited from 20:00 to 06:00 DAYTIME_TRANSACTIONAL - Amount that can be debited per transaction from 06:00 to 20:00 NIGHTTIME_TRANSACTION - Amount that can be debited per transaction from 20:00 to 06:00
definedAmount	number	The amount you want to change the limit to.

Request

URL

PUT 'https://apisandbox.delbank.com.br/baas/api/v1/usage-limits'

cURL

curl --location --request PUT 'https://apisandbox.delbank.com.br/baas/api/v1/usage-limits' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--header 'Content-Type: application/json' \
--data '{
    "serviceType": "PIX",
    "limits": [
        {
        "limitType": "NIGHTTIME_TRANSACTION",
        "definedAmount": 2000.00
        }
    ]
}
'

Response

On a succesful response here's what you'll receive:

{
    "serviceType": {
        "name": "PIX",
        "description": "Limite de transferências PIX para outras contas"
    },
    "limits": [
        {
            "limitType": {
                "name": "DAYTIME_TOTAL",
                "description": "Limite diurno total"
            },
            "maximunAmount": 696969696969.69,
            "definedAmount": 696969696969.69
        },
        {
            "limitType": {
                "name": "NIGHTTIME_TOTAL",
                "description": "Limite noturno total"
            },
            "maximunAmount": 1000.00,
            "definedAmount": 1000.00
        },
        {
            "limitType": {
                "name": "DAYTIME_TRANSACTIONAL",
                "description": "Limite diurno por transação"
            },
            "maximunAmount": 696969696969.69,
            "definedAmount": 696969696969.69
        },
        {
            "limitType": {
                "name": "NIGHTTIME_TRANSACTION",
                "description": "Limite noturno por transação"
            },
            "maximunAmount": 1000.00,
            "definedAmount": 999.00,
            "raiseRequest": {
                "status": "PENDING_ANALYSIS",
                "amount": 2000.00
            }
        }
    ]
}