This endpoint is used to delete a document linked to a payment.

This call removes the file association from the payment, preventing it from remaining available within the invoice.

Main request parameters

• id: Unique identifier of the payment in Asaas.

• documentId: Unique identifier of the document.

Deletion behavior

Once deleted, the document is no longer associated with the payment and can no longer be accessed through that link.

This operation should be used with caution, especially in scenarios where the file has already been made available to the payer.

When to use

Use this endpoint when you need to:

• remove documents that were attached incorrectly
• delete outdated or invalid files
• keep only valid documents linked to the payment

Next step in the flow

After deleting the document, your application can:

• list the payment documents again
• upload a new file if needed
• continue the normal payment flow without the removed document