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

Customer isn't valid for this collection mode

The customer on the transaction is missing information required by the transaction's collection mode.

Example response
{
"error": {
"type": "request_error",
"code": "transaction_customer_not_suitable_for_collection_mode",
"detail": "Customer entity must be suitable for the transactions current collection mode",
"documentation_url": "https://developer.paddle.com/errors/transactions/transaction_customer_not_suitable_for_collection_mode"
},
"meta": {
"request_id": "00000000-0000-0000-0000-000000000000"
}
}

Details

Status code
400
Error code
transaction_customer_not_suitable_for_collection_mode
Error message
Customer entity must be suitable for the transactions current collection mode

Common causes

  • collection_mode is manual and the customer_id you attached has no name. Manually-collected transactions need a named customer.

Troubleshooting

  • Add a name to the customer, then attach the customer_id again.

Was this page helpful?