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 isn't ready

This action needs the transaction to be in the `ready` status first.

Example response
{
"error": {
"type": "request_error",
"code": "transaction_status_must_be_ready",
"detail": "Transaction status needs to be ready",
"documentation_url": "https://developer.paddle.com/errors/transactions/transaction_status_must_be_ready"
},
"meta": {
"request_id": "00000000-0000-0000-0000-000000000000"
}
}

Details

Status code
400
Error code
transaction_status_must_be_ready
Error message
Transaction status needs to be ready

Common causes

  • You're setting status to billed, but the transaction isn't in the ready status.

Troubleshooting

  • Make sure the transaction is ready before setting status to billed. A transaction becomes ready once it has all the information needed to bill, like a customer, an address, and items.

Was this page helpful?