Skip to content

Update the payment method on a subscription

PUT
/api/subscriptions/{id}/payment-method

Switches the subscription’s payment method to one of the customer’s existing Shopify payment methods. The new payment method must already exist on the customer in Shopify (use the available list returned by GET /payment-method).

id
string
object
payment_method_id
required

ID of the customer’s Shopify payment method to switch to

string

Payment method updated

object
success
required
boolean

Invalid request — missing payment_method_id, no Shopify contract, or update failed

Example
{
"error": "Payment method ID is required"
}