Atualizar cobrança existente

put

https://api-sandbox.asaas.com/v3/payments/{id}

Atualiza os dados de uma cobrança existente pelo ID.

Em geral, a atualização é permitida enquanto a cobrança está aguardando pagamento ou vencida. O cliente vinculado à cobrança não pode ser alterado após a criação.

A atualização de split possui exceções após a confirmação da cobrança. Para cobranças de cartão de crédito ou débito com status CONFIRMED, o split pode ser alterado quando não houver antecipação e a alteração ocorrer até 1 dia útil antes da data prevista de pagamento.

Durante um bloqueio por divergência de Split, a alteração também pode ser permitida para cobranças CONFIRMED ou RECEIVED, inclusive quando houver antecipação. Nesse cenário, somente o split pode ser alterado.

📘
Alterações de valor ou vencimento
Alterações no valor ou na data de vencimento geram o evento PAYMENT_UPDATED e podem acionar a notificação de cobrança atualizada, conforme a configuração de notificações do cliente.
Consulte os eventos de Webhook para cobranças.

Conteúdos relacionados

Guides

Path Params

id

string

required

Identificador único da cobrança no Asaas

Body Params

billingType

string

enum

required

Forma de pagamento

Allowed:

value

number

required

Valor da cobrança

dueDate

date

required

Data de vencimento da cobrança

description

string

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

daysAfterDueDateToRegistrationCancellation

int32

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

externalReference

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

postalService

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

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json