---
title: "Update account settings"
method: PATCH
path: "/v2/accounts/{account_id}/settings"
tags: ["Account management"]
---

# Update account settings

`PATCH /v2/accounts/{account_id}/settings`

## Request

- Base URL: `https://marketplace-api.dlocal.com`
- URL: `https://marketplace-api.dlocal.com/v2/accounts/{account_id}/settings`
- Auth: API key in header `X-Date` and API key in header `X-Login` and API key in header `X-Trans-Key` and API key in header `X-Version` and API key in header `User-Agent` and API key in header `Authorization`

This service is responsible for updating account settings like pricing level and settlement period.

## Path parameters

- `account_id` string, required

## Request body

- Settings
  - `pricing_level` string: Represents the pricing configurations set in dLocal. For default: `smbs_1`, `smbs_2`, `mid_market`.
  - `settlement_period` number: Days in which the balance is available to settle.
  - `installments_responsible` string: An option is provided for the merchant to select who is responsible for paying the installments fees. The mechant is the seller and customer is the payer. <br><br> Possible values: `MERCHANT` or `CUSTOMER`.
  - `settlements` object[]: Days in which the balance is available to settle for the country and payment method code or ID. <br><br>**Note**: Parameter combinations must be agreed with the Technical Account Manager previously and will be in accordance with the commercial agreement.
    - `config_delay_days` number, required: Settlement period for the country and payment method (type or ID) combination.
    - `country_code` string: Country associated with the settlement. ISO 3166-1 alpha-2 code.
    - `payment_method_type` 'CARD' | 'TICKET' | 'BANK_TRANSFER' | 'WALLET': Type of payment method.<br><br>Possible values: `CARD`, `TICKET`, `BANK_TRANSFER`, or `WALLET`.<br><br>Must not be sent with `payment_method_id`.
    - `payment_method_id` string: ID of the payment method. See all the information related to each [payment method by country](doc:payment-method).<br><br>Must not be sent with `payment_method_type`.

## Response `200`

OK

- ResponseUpdateSettings
  - `account_id` string: User’s dLocal account ID.
  - `settings` Settings
    - `pricing_level` string: Represents the pricing configurations set in dLocal. For default: `smbs_1`, `smbs_2`, `mid_market`.
    - `settlement_period` number: Days in which the balance is available to settle.
    - `installments_responsible` string: An option is provided for the merchant to select who is responsible for paying the installments fees. The mechant is the seller and customer is the payer. <br><br> Possible values: `MERCHANT` or `CUSTOMER`.
    - `settlements` object[]: Days in which the balance is available to settle for the country and payment method code or ID. <br><br>**Note**: Parameter combinations must be agreed with the Technical Account Manager previously and will be in accordance with the commercial agreement.
      - `config_delay_days` number, required: Settlement period for the country and payment method (type or ID) combination.
      - `country_code` string: Country associated with the settlement. ISO 3166-1 alpha-2 code.
      - `payment_method_type` 'CARD' | 'TICKET' | 'BANK_TRANSFER' | 'WALLET': Type of payment method.<br><br>Possible values: `CARD`, `TICKET`, `BANK_TRANSFER`, or `WALLET`.<br><br>Must not be sent with `payment_method_id`.
      - `payment_method_id` string: ID of the payment method. See all the information related to each [payment method by country](doc:payment-method).<br><br>Must not be sent with `payment_method_type`.

## Other responses

- `400`: Bad request

---

[API](https://skmtc.dev/dlocal/apis/platforms.md) - [All operations](https://skmtc.dev/dlocal/apis/platforms/llms.txt) - [OpenAPI document](https://skmtc.dev/dlocal/apis/platforms/revisions/4be9adbbfce5?raw)