---
title: "Configurar Conta"
method: POST
path: "/accounts/configuration"
---

# Configurar Conta

`POST /accounts/configuration`

Configura parâmetros de uma conta de pagamentos.

## Headers

- `Request-Time` string, date-time, required
- `Signature` string, required

## Request body

- object
  - `splits` object[] — Lista de splits que será utilizado nesse conta.
    - `recipient_account_id` string — ID Da conta que irá receber o split
    - `cents` integer — Centavos a serem cobrados.
    - `percent` number, float — Porcentagem a ser cobrada.
    - `bank_slip_cents` integer — Valor em centavos a ser cobrado apenas em transações no boleto.
    - `bank_slip_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações no boleto.
    - `credit_card_cents` integer — Valor em centavos a ser cobrado apenas em transações no cartão de crédito.
    - `credit_card_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações no cartão de crédito.
    - `pix_cents` integer — Valor em centavos a ser cobrado apenas em transações no pix.
    - `pix_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações no pix.
    - `permit_aggregated` boolean — Permite agregar comissionamento percentual + fixo.
    - `credit_card_1x_cents` integer — Valor em centavos a ser cobrado apenas em transações em 1x no cartão de crédito.
    - `credit_card_2x_cents` integer — Valor em centavos a ser cobrado apenas em transações em 2x no cartão de crédito.
    - `credit_card_3x_cents` integer — Valor em centavos a ser cobrado apenas em transações em 3x no cartão de crédito.
    - `credit_card_4x_cents` integer — Valor em centavos a ser cobrado apenas em transações em 4x no cartão de crédito.
    - `credit_card_5x_cents` integer — Valor em centavos a ser cobrado apenas em transações em 5x no cartão de crédito.
    - `credit_card_6x_cents` integer — Valor em centavos a ser cobrado apenas em transações em 6x no cartão de crédito.
    - `credit_card_7x_cents` integer — Valor em centavos a ser cobrado apenas em transações em 7x no cartão de crédito.
    - `credit_card_8x_cents` integer — Valor em centavos a ser cobrado apenas em transações em 8x no cartão de crédito.
    - `credit_card_9x_cents` integer — Valor em centavos a ser cobrado apenas em transações em 9x no cartão de crédito.
    - `credit_card_10x_cents` integer — Valor em centavos a ser cobrado apenas em transações em 10x no cartão de crédito.
    - `credit_card_11x_cents` integer — Valor em centavos a ser cobrado apenas em transações em 11x no cartão de crédito.
    - `credit_card_12x_cents` integer — Valor em centavos a ser cobrado apenas em transações em 12x no cartão de crédito.
    - `credit_card_1x_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações em 1x no cartão de crédito.
    - `credit_card_2x_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações em 2x no cartão de crédito.
    - `credit_card_3x_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações em 3x no cartão de crédito.
    - `credit_card_4x_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações em 4x no cartão de crédito.
    - `credit_card_5x_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações em 5x no cartão de crédito.
    - `credit_card_6x_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações em 6x no cartão de crédito.
    - `credit_card_7x_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações em 7x no cartão de crédito.
    - `credit_card_8x_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações em 8x no cartão de crédito.
    - `credit_card_9x_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações em 9x no cartão de crédito.
    - `credit_card_10x_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações em 10x no cartão de crédito.
    - `credit_card_11x_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações em 11x no cartão de crédito.
    - `credit_card_12x_percent` number, float — Valor em porcentagem a ser cobrado apenas em transações em 12x no cartão de crédito.
  - `auto_withdraw` boolean — Saque automático?
  - `auto_withdraw_type` string — Periodicidade da agenda: `daily`, `weekly`, `biweekly` ou `monthly`.<br> Quando presente, ativa a agenda. Ausente ou vazio, desativa.
  - `auto_withdraw_option` integer — Depende do `auto_withdraw_type`. Para `weekly` e `biweekly`: dia da semana de `1` a `5` (1= Segunda, 2= Terça, 3= Quarta, 4= Quinta, 5= Sexta). Para `monthly`: dia do mês de `1` a `31`. Não se aplica a `daily`.
  - `auto_withdraw_anchor_date` string — Apenas `biweekly`: data de referência (início do ciclo) que define quais semanas são ativas. (Formato: 'AAAA-MM-DD'). <br> Obrigatória para `biweekly`; ignorada para os demais tipos.
  - `per_day_interest` boolean — Juros de mora?
  - `fines` boolean — Multas?
  - `late_payment_fine` integer — Valor da multa em % (Ex: 2)
  - `auto_advance` boolean — Antecipação Automática. Só pode ser atribuído caso a conta tenha a funcionalidade de Novo Adiantamento habilitado (entre em contato com o Suporte para habilitar). Caso o parâmetro não seja enviado, considera-se a mesma configuração de adiantamento automático da conta mestre.
  - `auto_advance_type` string — Opções de Antecipação Automática. Obrigatório caso auto_advance seja true. Recebe os valores 'daily' (Antecipação diária), 'weekly' (Antecipação semanal, que ocorre no dia da semana determinado pelo usuário), 'monthly' (Antecipação mensal, que ocorre no dia do mês determinado pelo usuário) e 'days_after_payment' (Antecipação que ocorre em um número de dias após o pagamento especificado pelo usuário)
  - `auto_advance_option` integer — Obrigatório caso auto_advance seja true e auto_advance_type diferente de 'daily'. Em caso de auto_advance_type = weekly, recebe valores de 0 a 6 (Número correspondente ao dia da semana que a antecipação será realizada, 0 para domingo, 1 para segunda e assim por diante). Em caso de auto_advance_type = monthly, recebe valores de 1 a 28 (Número correspondente ao dia do mês que a antecipação será realizada). Em caso de auto_advance_type = days_after_payment, recebe valores de 1 a 30 (Número de dias após o pagamento em que a antecipação será realizada)
  - `bank_slip` object — Configurações de boleto bancário
    - `active` boolean — Ativo?
    - `extra_due` integer — Dias de Vencimento Extras no Boleto (Ex: 2)
    - `reprint_extra_due` integer — Dias de Vencimento Extras na 2a Via do Boleto (Ex: 1)
  - `credit_card` object — Configurações de cartão de crédito
    - `active` boolean — Ativo?
    - `soft_descriptor` string — Descrição que apareça na Fatura do Cartão do Cliente (Obs: Esse campo pode sofrer limitação de 12 ou 22 caracteres dependendo da adquirente utilizada pela iugu no momento da transação, a adquirente não permite a utilização de caracteres especiais)
    - `installments` boolean — Parcelamento ativo?
    - `max_installments` integer — Número máximo de parcelas (Nr entre 1 a 18)
    - `max_installments_without_interest` integer — Número de parcelas sem cobrança de juros ao cliente (Nr entre 1 a 18). *somente contas antigas
    - `two_step_transaction` boolean — Habilita o fluxo de pagamento em duas etapas (Autorização e Captura)
    - `installments_pass_interest` boolean — Repasse de Juros de Parcelamento ativo? *somente contas antigas
    - `two_credit_cards_payment` boolean — **(NOVO✨)** Ativar/desativar [Pagamento com 2 Cartões](https://dev.iugu.com/docs/cobranca-com-2-cartoes)
  - `payment_email_notification` boolean — boolean Ativa ou desativa a notificação de pagamento
  - `payment_email_notification_receiver` string — Email que deve receber as notificações de pagamento (Obrigatório caso payment_email_notification seja true)
  - `early_payment_discount` boolean — Ativa ou desativa o desconto por pagamento antecipado
  - `early_payment_discounts` object[] — Configuração do desconto a ser aplicado
    - `days` integer — Dias antecedentes ao vencimento da fatura em que o desconto será aplicado
    - `percent` number, float — Percentual de desconto a ser aplicado. Obs.: O percentual máximo que deve ser aplicado é de 80%.
    - `value_cents` integer — Valor em centavos de desconto a ser aplicado
  - `disabled_withdraw` boolean — Desabilita saque da conta
  - `customer_minimum_balance_cents` string — Configuração de valor para reserva de saque

## Response `200`

200

- object
  - `id` string
  - `name` string
  - `created_at` string
  - `updated_at` string
  - `can_receive?` boolean
  - `is_verified?` boolean
  - `last_verification_request_status` unknown
  - `last_verification_request_data` unknown
  - `last_verification_request_feedback` unknown
  - `change_plan_type` integer
  - `subscriptions_trial_period` integer
  - `subscriptions_billing_days` integer
  - `disable_emails` boolean
  - `last_withdraw` unknown
  - `reply_to` string
  - `webapp_on_test_mode` boolean
  - `marketplace` boolean
  - `default_return_url` string
  - `credit_card_verified` boolean
  - `fines` boolean
  - `late_payment_fine` integer
  - `per_day_interest` boolean
  - `old_advancement` boolean
  - `early_payment_discount` boolean
  - `early_payment_discount_days` unknown
  - `early_payment_discount_percent` unknown
  - `sac_phone` unknown
  - `sac_email` unknown
  - `informations` unknown
  - `configuration` object
    - `auto_withdraw` boolean
    - `disabled_withdraw` boolean
    - `payment_email_notification` boolean
    - `payment_email_notification_receiver` string
    - `auto_advance` boolean
    - `auto_advance_type` string
    - `auto_advance_option` unknown
    - `commission_percent` unknown
    - `owner_emails_to_notify` string
    - `fines` boolean
    - `late_payment_fine` integer
    - `per_day_interest` boolean
    - `bank_slip` object
      - `active` boolean
      - `extra_due` string
      - `reprint_extra_due` string
    - `credit_card` object
      - `active` boolean
      - `soft_descriptor` string
      - `installments` boolean
      - `installments_pass_interest` boolean
      - `max_installments` string
      - `max_installments_without_interest` string
      - `two_step_transaction` boolean
    - `pix` object
      - `active` boolean
    - `early_payment_discount` boolean
    - `early_payment_discount_days` unknown
    - `early_payment_discount_percent` unknown
  - `bank_accounts` object[]
    - `branch` string
    - `number` string
    - `digit` string
  - `auto_withdraw` boolean
  - `disabled_withdraw` boolean
  - `payment_email_notification` boolean
  - `payment_email_notification_receiver` string
  - `auto_advance` boolean
  - `auto_advance_type` string
  - `auto_advance_option` unknown
  - `balance` string
  - `balance_in_protest` string
  - `balance_available_for_withdraw` string
  - `protected_balance` string
  - `customer_minimum_balance_cents` integer
  - `payable_balance` string
  - `receivable_balance` string
  - `commission_balance` string
  - `volume_last_month` string
  - `volume_this_month` string
  - `total_subscriptions` integer
  - `total_active_subscriptions` integer
  - `taxes_paid_last_month` string
  - `taxes_paid_this_month` string
  - `has_bank_address?` boolean
  - `permissions` unknown
  - `custom_logo_url` string
  - `custom_logo_small_url` string
  - `early_payment_discounts` object[]
  - `commissions` unknown
  - `splits` object[]
    - `id` string
    - `split_id` string
    - `recipient_account_id` string
    - `cents` integer
    - `percent` integer
    - `credit_card_cents` unknown
    - `credit_card_percent` unknown
    - `bank_slip_cents` integer
    - `bank_slip_percent` unknown
    - `pix_cents` integer
    - `pix_percent` unknown
    - `permit_aggregated` boolean
    - `created_at` string
    - `updated_at` string
    - `credit_card_1x_cents` unknown
    - `credit_card_2x_cents` unknown
    - `credit_card_3x_cents` unknown
    - `credit_card_4x_cents` unknown
    - `credit_card_5x_cents` unknown
    - `credit_card_6x_cents` unknown
    - `credit_card_7x_cents` unknown
    - `credit_card_8x_cents` unknown
    - `credit_card_9x_cents` unknown
    - `credit_card_10x_cents` unknown
    - `credit_card_11x_cents` unknown
    - `credit_card_12x_cents` unknown
    - `credit_card_1x_percent` number
    - `credit_card_2x_percent` number
    - `credit_card_3x_percent` unknown
    - `credit_card_4x_percent` unknown
    - `credit_card_5x_percent` unknown
    - `credit_card_6x_percent` unknown
    - `credit_card_7x_percent` unknown
    - `credit_card_8x_percent` unknown
    - `credit_card_9x_percent` unknown
    - `credit_card_10x_percent` unknown
    - `credit_card_11x_percent` unknown
    - `credit_card_12x_percent` unknown
    - `credit_card_13x_cents` unknown
    - `credit_card_14x_cents` unknown
    - `credit_card_15x_cents` unknown
    - `credit_card_16x_cents` unknown
    - `credit_card_17x_cents` unknown
    - `credit_card_18x_cents` unknown
    - `credit_card_13x_percent` unknown
    - `credit_card_14x_percent` unknown
    - `credit_card_15x_percent` unknown
    - `credit_card_16x_percent` unknown
    - `credit_card_17x_percent` unknown
    - `credit_card_18x_percent` unknown
  - `contact_data` object
    - `name` string
    - `document_number` string
    - `full_address` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/iugu/apis/tokens-de-api.md) · [All operations](https://skmtc.net/iugu/apis/tokens-de-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/iugu/tokens-de-api/versions/4590fc729d1e/schema)