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

Billing details are required for manual collection

The transaction uses manual collection, so it must include billing details.

Example response
{
"error": {
"type": "request_error",
"code": "transaction_billing_details_object_required",
"detail": "billing_details must be non null if collection_mode=manual",
"documentation_url": "https://developer.paddle.com/errors/transactions/transaction_billing_details_object_required"
},
"meta": {
"request_id": "00000000-0000-0000-0000-000000000000"
}
}

Details

Status code
400
Error code
transaction_billing_details_object_required
Error message
billing_details must be non null if collection_mode=manual

Common causes

  • collection_mode is manual but no billing_details were provided. Manually-collected transactions need billing details.

Troubleshooting

  • Add billing_details to your request.
  • Set collection_mode to automatic if you don't need to send billing details.

Was this page helpful?