Update existing payment

Endpoint responsible for updating a charge already created in Asaas.

Updates are only allowed for charges that are still awaiting payment or are already overdue. After creation, it is not possible to change the customer to whom the charge belongs.


Request parameter

  • id — Unique identifier of the charge in Asaas

Main request parameters

Fields that can be updated include:

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

Important rule regarding the charge customer

Once created, the charge remains linked to the original customer.

If the payer needs to be changed, the correct strategy is to create a new charge for the correct customer instead of trying to reuse the previous one.


Split update after charge confirmation

Updating split follows specific rules when the charge has already been confirmed.

This change is only allowed for charges made with credit card or debit card, provided that:

  • the charge has the CONFIRMED status
  • the charge has not been anticipated
  • the change occurs up to 1 business day before the expected payment date

There is an exception when there is a block due to split mismatch at the time of receipt. In that case, updating the split will be allowed for charges with CONFIRMED or RECEIVED status, including when anticipation exists.

However, in this scenario, no field other than split may be changed.


Automatic anticipation with fixed split

In cases of automatic anticipation with split configured by fixed amount when the charge is issued, the split calculation will consider the highest fee applicable to the card used.

This behavior must be taken into account in integrations that reconcile net amounts between multiple recipients.

Path Params
string
required

Unique payment identifier in Asaas

Body Params
string
enum
required

Payment billing type

Allowed:
number
required

Payment amount

date
required

Payment due date

string

Payment description (max. 500 characters)

int32

Days after registration cancellation deadline (only for bank slip)

string

Free search field

discount
object

Discount information

interest
object

Interest information for payment after due date

fine
object

Fine information for payment after due date

boolean

Define whether the payment will be sent via post

split
array of objects

Split Settings

split
callback
object

Automatic redirection information after the payment of the link payment

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