Detach the payment method from a subscription
Detaches the payment method from a subscription. The payment method stays available on the customer, so you can attach it again later. Only subscriptions with collection_method set to send_invoice can detach their payment method, because a subscription that collects automatically needs a payment method to charge. Fintoc also clears the default_payment_method of the subscription’s draft and open invoices, so a later payment must name the payment method explicitly. This stops the automatic retries of an open invoice that Fintoc was still collecting. Paid and voided invoices keep their default_payment_method as a record of how Fintoc charged them. Fintoc sends a subscription.payment_method_updated event with payment_method set to null. Detaching a subscription that has no payment method does nothing, sends no event, and returns the subscription unchanged.
Authorizations
Path Parameters
The id of the subscription to detach the payment method from.
Response
The subscription, with payment_method set to null.
Unique identifier of the subscription.
"sub_2c4mDcMaVxDx7nT3o5GbPMQbS2v"
Type of the object. Always subscription.
ISO 8601 timestamp that anchors the billing cycle. Fintoc sets this anchor to the subscription's creation time, or to trial_end when a trial applies. Fintoc measures every billing period from this anchor.
"2026-06-01T15:00:00Z"
Method Fintoc uses to collect the invoices the subscription generates. One of charge_automatically (Fintoc charges the saved payment method) or send_invoice (Fintoc leaves each invoice open for you to collect).
charge_automatically, send_invoice "charge_automatically"
ISO 8601 timestamp of when the subscription was created.
"2026-06-01T15:00:00Z"
ID of the customer the subscription bills.
"cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu"
Items the subscription bills for on every billing cycle.
Set of key-value pairs attached to the subscription.
Mode of the object. One of live or test. test subscriptions use fake data for integration testing and do not collect real money.
live, test "live"
ID of the payment method associated with the subscription, or null if it has none. Fintoc charges it on every billing cycle when collection_method is charge_automatically.
"pm_2c4mDhAbCdEfGhIjKlMnOpQrStu"
Current status of the subscription. One of active, incomplete (the first invoice payment has not yet succeeded), trialing (the trial period has not ended), or canceled (the subscription stopped generating invoices).
active, canceled, incomplete, trialing "active"
ISO 8601 timestamp at which the trial period ends, or null if the subscription has no trial.
null