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

Manual collection requires a payment method for trials

A manually-collected transaction has trialing prices that don't require a payment method, which isn't allowed.

Example response
{
"error": {
"type": "request_error",
"code": "transaction_manual_must_require_payment_method",
"detail": "This transaction is manually-collected and has items with a cardless trial, which isn't allowed. Manually-collected trials must require a payment method.",
"documentation_url": "https://developer.paddle.com/errors/transactions/transaction_manual_must_require_payment_method"
},
"meta": {
"request_id": "00000000-0000-0000-0000-000000000000"
}
}

Details

Status code
400
Error code
transaction_manual_must_require_payment_method
Error message
This transaction is manually-collected and has items with a cardless trial, which isn't allowed. Manually-collected trials must require a payment method.

Common causes

  • collection_mode is manual and the transaction has items where trial_period.requires_payment_method is false. Manually-collected trials must require a payment method.

Troubleshooting

  • Remove any prices where trial_period.requires_payment_method is false from the transaction.
  • Update the prices so trial_period.requires_payment_method is true, then try again.
  • Set collection_mode to automatic to bill using a checkout and renew automatically with a saved payment method.

Was this page helpful?