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

Address isn't valid for this collection mode

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

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

Details

Status code
400
Error code
transaction_address_not_suitable_for_collection_mode
Error message
Address entity must be suitable for the transactions current collection mode

Common causes

  • collection_mode is manual and the address you attached is missing fields required for a manually-collected transaction.

Troubleshooting

  • Make sure the address has a country_code, postal_code, region, city, and first_line, then attach the address_id again.

Was this page helpful?