For AI agents and LLMs: a structured documentation index is available at /llms.txt. Every page has a Markdown sibling — append .md to any URL.

Skip to content
Paddle Docs home

Transaction can't be updated

The transaction has a status other than `draft` or `ready`, so it can no longer be changed.

Example response
{
"error": {
"type": "request_error",
"code": "transaction_immutable",
"detail": "Cannot update immutable transaction",
"documentation_url": "https://developer.paddle.com/errors/transactions/transaction_immutable"
},
"meta": {
"request_id": "00000000-0000-0000-0000-000000000000"
}
}

Details

Status code
400
Error code
transaction_immutable
Error message
Cannot update immutable transaction

Common causes

  • The transaction has a status of billed, past_due, paid, completed, or canceled. Only transactions that are draft or ready can be updated.

Troubleshooting

  • Check the transaction's status before updating it. Only draft and ready transactions can be changed.
  • To correct a billed or completed transaction, create an adjustment against it instead.

Was this page helpful?