--- updatedAt: 2026-06-08T19:30:51.000Z agentTools: projectIndex: https://dev.iugu.com/llms.txt --- # Editar Subconta Atualiza os parâmetros de uma conta de pagamentos.

IMPORTANTE!

Para executar esta chamada é necessário que a conta esteja verificada. 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 chamada de criação de subconta. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "conta-de-pagamento-e-marketplace", "version": "1.0" }, "servers": [ { "url": "https://api.iugu.com/v1" } ], "components": { "securitySchemes": { "sec0": { "type": "apiKey", "name": "api_token", "in": "query" } } }, "security": [ { "sec0": [] } ], "paths": { "/accounts/{id}": { "put": { "summary": "Editar Subconta", "description": "Atualiza os parâmetros de uma conta de pagamentos.

IMPORTANTE!

Para executar esta chamada é necessário que a conta esteja verificada. 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 chamada de criação de subconta.", "operationId": "atualizar-subconta", "parameters": [ { "name": "id", "in": "path", "description": "ID da conta a ser atualizada.", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "subscriptions_billing_days": { "type": "integer", "description": "Número de dias antes do vencimento da assinatura para criação da fatura referente ao próximo ciclo.", "format": "int32" }, "subscriptions_trial_period": { "type": "integer", "description": "Duração (em dias) do período de testes de uma assinatura.", "format": "int32" }, "default_return_url": { "type": "string", "description": "URL padrão para a qual direcionar o cliente após o pagamento de uma fatura via web." }, "owner_emails_to_notify": { "type": "string", "description": "Lista de emails, separados por vígula, que devem receber notificações específicas para usuários com permissão de \"dono\"." }, "reply_to": { "type": "string", "description": "E-mail para resposta dos clientes" }, "website": { "type": "string", "description": "Deve começar com http:// ou https://.
**Exemplo:** http://www.exemplo.com/
" }, "auto_withdraw_type": { "type": "string", "description": "Periodicidade da agenda: `daily`, `weekly`, `biweekly` ou `monthly`.
\nQuando presente, ativa a agenda. Ausente ou vazio, desativa.\n" }, "auto_withdraw_option": { "type": "integer", "description": "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`.", "format": "int32" }, "auto_withdraw_anchor_date": { "type": "string", "description": "Apenas `biweekly`: data de referência (início do ciclo) que define quais semanas são ativas. (Formato: 'AAAA-MM-DD').
Obrigatória para `biweekly`; ignorada para os demais tipos." } }, "required": [ "website" ] } } } }, "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"id\": \"0C1FAA736E13411696C3A2E8FF519033\",\n \"name\": \"Subconta E\",\n \"created_at\": \"2024-08-03T17:07:01-03:00\",\n \"updated_at\": \"2024-08-20T11:49:11-03:00\",\n \"can_receive?\": true,\n \"is_verified?\": true,\n \"last_verification_request_status\": \"accepted\",\n \"last_verification_request_data\": null,\n \"last_verification_request_feedback\": null,\n \"change_plan_type\": 1,\n \"subscriptions_trial_period\": 0,\n \"subscriptions_billing_days\": 5,\n \"disable_emails\": false,\n \"last_withdraw\": null,\n \"reply_to\": \"no-reply@iugu.com\",\n \"webapp_on_test_mode\": false,\n \"marketplace\": false,\n \"default_return_url\": null,\n \"credit_card_verified\": true,\n \"fines\": null,\n \"late_payment_fine\": null,\n \"per_day_interest\": null,\n \"old_advancement\": null,\n \"early_payment_discount\": null,\n \"early_payment_discount_days\": null,\n \"early_payment_discount_percent\": null,\n \"sac_phone\": null,\n \"sac_email\": null,\n \"informations\": null,\n \"configuration\": null,\n \"bank_accounts\": [\n {\n \"branch\": \"0002\",\n \"number\": \"4421692\",\n \"digit\": \"0\"\n }\n ],\n \"auto_withdraw\": false,\n \"disabled_withdraw\": false,\n \"payment_email_notification\": false,\n \"payment_email_notification_receiver\": null,\n \"auto_advance\": false,\n \"auto_advance_type\": null,\n \"auto_advance_option\": null,\n \"balance\": \"R$ 0,00\",\n \"balance_in_protest\": \"R$ 0,00\",\n \"balance_available_for_withdraw\": \"R$ 0,00\",\n \"protected_balance\": \"R$ 0,00\",\n \"customer_minimum_balance_cents\": 0,\n \"payable_balance\": \"R$ 0,00\",\n \"receivable_balance\": \"R$ 0,00\",\n \"commission_balance\": \"R$ 0,00\",\n \"volume_last_month\": \"R$ 0,00\",\n \"volume_this_month\": \"R$ 0,00\",\n \"total_subscriptions\": 0,\n \"total_active_subscriptions\": 0,\n \"taxes_paid_last_month\": \"R$ 0,00\",\n \"taxes_paid_this_month\": \"R$ 0,00\",\n \"has_bank_address?\": true,\n \"permissions\": [\n \"owner\"\n ],\n \"custom_logo_url\": null,\n \"custom_logo_small_url\": null,\n \"early_payment_discounts\": [],\n \"commissions\": null,\n \"splits\": [],\n \"contact_data\": {\n \"name\": \"Subconta E\",\n \"document_number\": \"11343675030\",\n \"full_address\": \"Rua, Bairro, Cidade/SP, 13056344\"\n }\n}" } }, "schema": { "type": "object", "properties": { "id": { "type": "string", "example": "0C1FAA736E13411696C3A2E8FF519033" }, "name": { "type": "string", "example": "Subconta E" }, "created_at": { "type": "string", "example": "2024-08-03T17:07:01-03:00" }, "updated_at": { "type": "string", "example": "2024-08-20T11:49:11-03:00" }, "can_receive?": { "type": "boolean", "example": true, "default": true }, "is_verified?": { "type": "boolean", "example": true, "default": true }, "last_verification_request_status": { "type": "string", "example": "accepted" }, "last_verification_request_data": {}, "last_verification_request_feedback": {}, "change_plan_type": { "type": "integer", "example": 1, "default": 0 }, "subscriptions_trial_period": { "type": "integer", "example": 0, "default": 0 }, "subscriptions_billing_days": { "type": "integer", "example": 5, "default": 0 }, "disable_emails": { "type": "boolean", "example": false, "default": true }, "last_withdraw": {}, "reply_to": { "type": "string", "example": "no-reply@iugu.com" }, "webapp_on_test_mode": { "type": "boolean", "example": false, "default": true }, "marketplace": { "type": "boolean", "example": false, "default": true }, "default_return_url": {}, "credit_card_verified": { "type": "boolean", "example": true, "default": true }, "fines": {}, "late_payment_fine": {}, "per_day_interest": {}, "old_advancement": {}, "early_payment_discount": {}, "early_payment_discount_days": {}, "early_payment_discount_percent": {}, "sac_phone": {}, "sac_email": {}, "informations": {}, "configuration": {}, "bank_accounts": { "type": "array", "items": { "type": "object", "properties": { "branch": { "type": "string", "example": "0002" }, "number": { "type": "string", "example": "4421692" }, "digit": { "type": "string", "example": "0" } } } }, "auto_withdraw": { "type": "boolean", "example": false, "default": true }, "disabled_withdraw": { "type": "boolean", "example": false, "default": true }, "payment_email_notification": { "type": "boolean", "example": false, "default": true }, "payment_email_notification_receiver": {}, "auto_advance": { "type": "boolean", "example": false, "default": true }, "auto_advance_type": {}, "auto_advance_option": {}, "balance": { "type": "string", "example": "R$ 0,00" }, "balance_in_protest": { "type": "string", "example": "R$ 0,00" }, "balance_available_for_withdraw": { "type": "string", "example": "R$ 0,00" }, "protected_balance": { "type": "string", "example": "R$ 0,00" }, "customer_minimum_balance_cents": { "type": "integer", "example": 0, "default": 0 }, "payable_balance": { "type": "string", "example": "R$ 0,00" }, "receivable_balance": { "type": "string", "example": "R$ 0,00" }, "commission_balance": { "type": "string", "example": "R$ 0,00" }, "volume_last_month": { "type": "string", "example": "R$ 0,00" }, "volume_this_month": { "type": "string", "example": "R$ 0,00" }, "total_subscriptions": { "type": "integer", "example": 0, "default": 0 }, "total_active_subscriptions": { "type": "integer", "example": 0, "default": 0 }, "taxes_paid_last_month": { "type": "string", "example": "R$ 0,00" }, "taxes_paid_this_month": { "type": "string", "example": "R$ 0,00" }, "has_bank_address?": { "type": "boolean", "example": true, "default": true }, "permissions": { "type": "array", "items": { "type": "string", "example": "owner" } }, "custom_logo_url": {}, "custom_logo_small_url": {}, "early_payment_discounts": { "type": "array", "items": { "type": "object", "properties": {} } }, "commissions": {}, "splits": { "type": "array", "items": { "type": "object", "properties": {} } }, "contact_data": { "type": "object", "properties": { "name": { "type": "string", "example": "Subconta E" }, "document_number": { "type": "string", "example": "11343675030" }, "full_address": { "type": "string", "example": "Rua, Bairro, Cidade/SP, 13056344" } } } } } } } }, "404": { "description": "404", "content": { "application/json": { "examples": { "Account Not Found": { "value": "{\n \"errors\": \"Account Not Found\"\n}" } }, "schema": { "type": "object", "properties": { "errors": { "type": "string", "example": "Account Not Found" } } } } } } } } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```