Update existing payment

Updates the data of an existing payment by ID.

In general, updates are allowed while the payment is pending or overdue. The customer linked to the payment cannot be changed after creation.

Updating split has exceptions after the payment is confirmed. For credit or debit card payments with CONFIRMED status, the split can be changed when there is no anticipation and the change occurs up to 1 business day before the expected payment date.

During a Payment Split divergence block, the change may also be allowed for CONFIRMED or RECEIVED payments, including when there is anticipation. In this scenario, only the split can be changed.

📘

Changes to value or due date

Changes to the value or due date generate the PAYMENT_UPDATED event and may trigger the updated payment notification, according to the customer's notification settings.

See the Webhook events for payments.

Related content

Guides

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