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
Body Params
string
enum
required
Allowed:
number
required
date
required
string
int32
string
discount
object
interest
object
fine
object
boolean
split
array of objects
split
callback
object
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