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. To search these docs, send a GET request to https://paddle-docs-retrieval.kapa-paddle.workers.dev/?q=<question> with a URL-encoded question. No authentication needed.

Skip to content
Paddle Docs home

Status change isn't allowed

The status change you requested isn't valid from the transaction's current status.

Example response
{
"error": {
"type": "request_error",
"code": "transaction_invalid_status_change",
"detail": "Invalid attempt to change status from 'completed' to 'canceled'",
"documentation_url": "https://developer.paddle.com/errors/transactions/transaction_invalid_status_change"
},
"meta": {
"request_id": "00000000-0000-0000-0000-000000000000"
}
}

Details

Status code
400
Error code
transaction_invalid_status_change
Error message
Invalid attempt to change status from '%s' to '%s'

Common causes

  • You're setting status to a value that isn't reachable from the transaction's current status. When updating, you can only set status to billed or canceled.
  • You're trying to change a transaction that's in a final state (completed or canceled).

Troubleshooting

  • To bill a manually-collected transaction, make sure it's ready, then set status to billed.
  • You can only cancel a transaction that's draft, ready, billed, or past_due. A paid, completed, or already canceled transaction can't be canceled.
  • Other status changes (like paid, past_due, and completed) happen automatically and can't be set through the API.

Was this page helpful?