IUiugu

Editar Subconta

Atualiza os parâmetros de uma conta de pagamentos.<div class="magic-block-callout type-warning"><h3><i title="Danger" class="fa fa-exclamation-triangle"></i> IMPORTANTE!</h3><div class="callout-body"><p>Para executar esta chamada é necessário que a conta esteja <a href="https://dev.iugu.com/reference/enviar-verifica%C3%A7%C3%A3o-de-subconta">verificada</a>. Atenção: Para a Autenticação, no lugar do token de API da conta (api_token), deve-se utilizar o token de usuário (user_token), gerado no retorno da <a href="https://dev.iugu.com/reference/criar-subconta">chamada de criação de subconta</a>.

put/accounts/{id}

Request

  • Base URL
    https://api.iugu.com/v1
  • URL
    https://api.iugu.com/v1/accounts/{id}
  • Auth
    API key in query parameter api_token

Path parameters

idstring required

ID da conta a ser atualizada.

Request body

subscriptions_billing_daysinteger

Número de dias antes do vencimento da assinatura para criação da fatura referente ao próximo ciclo.

subscriptions_trial_periodinteger

Duração (em dias) do período de testes de uma assinatura.

default_return_urlstring

URL padrão para a qual direcionar o cliente após o pagamento de uma fatura via web.

owner_emails_to_notifystring

Lista de emails, separados por vígula, que devem receber notificações específicas para usuários com permissão de "dono".

reply_tostring

E-mail para resposta dos clientes

websitestring required

Deve começar com http:// ou https://. <br>Exemplo: http://www.exemplo.com/</br>

auto_withdraw_typestring

Periodicidade da agenda: daily, weekly, biweekly ou monthly.<br> Quando presente, ativa a agenda. Ausente ou vazio, desativa.

auto_withdraw_optioninteger

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_datestring

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.

Response

200

idstring
namestring
created_atstring
updated_atstring
can_receive?boolean
is_verified?boolean
last_verification_request_statusstring
last_verification_request_dataunknown
last_verification_request_feedbackunknown
change_plan_typeinteger
subscriptions_trial_periodinteger
subscriptions_billing_daysinteger
disable_emailsboolean
last_withdrawunknown
reply_tostring
webapp_on_test_modeboolean
marketplaceboolean
default_return_urlunknown
credit_card_verifiedboolean
finesunknown
late_payment_fineunknown
per_day_interestunknown
old_advancementunknown
early_payment_discountunknown
early_payment_discount_daysunknown
early_payment_discount_percentunknown
sac_phoneunknown
sac_emailunknown
informationsunknown
configurationunknown
auto_withdrawboolean
disabled_withdrawboolean
payment_email_notificationboolean
payment_email_notification_receiverunknown
auto_advanceboolean
auto_advance_typeunknown
auto_advance_optionunknown
balancestring
balance_in_proteststring
balance_available_for_withdrawstring
protected_balancestring
customer_minimum_balance_centsinteger
payable_balancestring
receivable_balancestring
commission_balancestring
volume_last_monthstring
volume_this_monthstring
total_subscriptionsinteger
total_active_subscriptionsinteger
taxes_paid_last_monthstring
taxes_paid_this_monthstring
has_bank_address?boolean
permissionsstring[]
custom_logo_urlunknown
custom_logo_small_urlunknown
early_payment_discountsobject[]
commissionsunknown
splitsobject[]

Example response

{
  "id": "0C1FAA736E13411696C3A2E8FF519033",
  "name": "Subconta E",
  "created_at": "2024-08-03T17:07:01-03:00",
  "updated_at": "2024-08-20T11:49:11-03:00",
  "can_receive?": true,
  "is_verified?": true,
  "last_verification_request_status": "accepted",
  "change_plan_type": 1,
  "subscriptions_billing_days": 5,
  "reply_to": "no-reply@iugu.com",
  "credit_card_verified": true,
  "bank_accounts": [
    {
      "branch": "0002",
      "number": "4421692",
      "digit": "0"
    }
  ],
  "balance": "R$ 0,00",
  "balance_in_protest": "R$ 0,00",
  "balance_available_for_withdraw": "R$ 0,00",
  "protected_balance": "R$ 0,00",
  "payable_balance": "R$ 0,00",
  "receivable_balance": "R$ 0,00",
  "commission_balance": "R$ 0,00",
  "volume_last_month": "R$ 0,00",
  "volume_this_month": "R$ 0,00",
  "taxes_paid_last_month": "R$ 0,00",
  "taxes_paid_this_month": "R$ 0,00",
  "has_bank_address?": true,
  "permissions": [
    "owner"
  ],
  "contact_data": {
    "name": "Subconta E",
    "document_number": "11343675030",
    "full_address": "Rua, Bairro, Cidade/SP, 13056344"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.