Atualizar cobrança existente

Endpoint responsável por atualizar uma cobrança já criada no Asaas.

A atualização é permitida apenas para cobranças que ainda estejam aguardando pagamento ou que já estejam vencidas. Depois da criação, não é possível alterar o cliente ao qual a cobrança pertence.


Parâmetro da requisição

  • id — Identificador único da cobrança no Asaas

Parâmetros principais da requisição

Podem ser atualizados campos como:

  • billingType
  • value
  • dueDate
  • description
  • daysAfterDueDateToRegistrationCancellation
  • externalReference
  • discount
  • interest
  • fine
  • postalService
  • split
  • callback

Regra importante sobre o cliente da cobrança

Uma vez criada, a cobrança permanece vinculada ao cliente original.

Caso seja necessário alterar o pagador, a estratégia correta é criar uma nova cobrança para o cliente correto, em vez de tentar reaproveitar a anterior.


Atualização de split após confirmação da cobrança

A atualização de split possui regras específicas quando a cobrança já foi confirmada.

Essa alteração só é permitida para cobranças feitas com cartão de crédito ou débito, desde que:

  • a cobrança esteja com status CONFIRMED
  • a cobrança não possua antecipação
  • a alteração ocorra até 1 dia útil antes da data prevista de pagamento

Existe uma exceção quando há bloqueio por divergência de split no momento do recebimento. Nessa situação, será permitida a atualização do split para cobranças com status CONFIRMED ou RECEIVED, inclusive quando houver antecipação.

Porém, nesse cenário, nenhum outro campo além do split poderá ser alterado.


Antecipação automática com split fixo

Nos casos de antecipação automática com split configurado por valor fixo na emissão da cobrança, o cálculo do split considerará a taxa mais alta aplicável ao cartão utilizado.

Esse comportamento deve ser levado em conta em integrações que conciliam valores líquidos entre múltiplos recebedores.

Path Params
string
required

Identificador único da cobrança no Asaas

Body Params
string
enum
required

Forma de pagamento

Allowed:
number
required

Valor da cobrança

date
required

Data de vencimento da cobrança

string

Descrição da cobrança (máx. 500 caracteres)

int32

Dias após o vencimento para cancelamento do registro (somente para boleto bancário)

string

Campo livre para busca

discount
object

Informações de desconto

interest
object

Informações de juros para pagamento após o vencimento

fine
object

Informações de multa para pagamento após o vencimento

boolean

Define se a cobrança será enviada via Correios

split
array of objects

Configurações do split

split
callback
object

Informações de redirecionamento automático após pagamento do link de pagamento

Responses

404

Not found

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json