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

Payment method change transactions can't be edited

For a transaction that updates a subscription's payment method, only customer, address, and business information can be changed.

Example response
{
"error": {
"type": "request_error",
"code": "transaction_payment_method_change_field_immutable",
"detail": "You can't make changes to a transaction where the `origin` is `subscription_payment_method_change`, except to update customer, address, or business information.",
"documentation_url": "https://developer.paddle.com/errors/transactions/transaction_payment_method_change_field_immutable"
},
"meta": {
"request_id": "00000000-0000-0000-0000-000000000000"
}
}

Details

Status code
400
Error code
transaction_payment_method_change_field_immutable
Error message
You can't make changes to a transaction where the `origin` is `subscription_payment_method_change`, except to update customer, address, or business information.

Common causes

  • You're updating a transaction where origin is subscription_payment_method_change. Only customer_id, address_id, and business_id can be changed on these transactions.

Troubleshooting

  • Payment method change transactions are zero-value transactions Paddle creates to update the payment method on a subscription. To change what's billed, update the related subscription or bill a one-time charge to it instead.
  • To keep the update, remove any fields other than customer_id, address_id, or business_id from your request.

Was this page helpful?