Skip to main content
DELETE
Detach the payment method from a subscription

Autorizaciones

Authorization
string
header
requerido

Parámetros de ruta

id
string
requerido

The id of the subscription to detach the payment method from.

Respuesta

The subscription, with payment_method set to null.

id
string
requerido

Unique identifier of the subscription.

Ejemplo:

"sub_2c4mDcMaVxDx7nT3o5GbPMQbS2v"

object
any
requerido

Type of the object. Always subscription.

billing_cycle_anchor
string<date-time>
requerido

ISO 8601 timestamp that anchors the billing cycle. Fintoc measures every billing period from this anchor. Unless you set the anchor when creating the subscription, Fintoc uses the creation time, or trial_end when a trial applies. Fintoc issues no invoice before the anchor.

Ejemplo:

"2026-06-01T15:00:00Z"

cancel_at
string<date-time> | null
requerido

ISO 8601 timestamp in UTC of the scheduled cancellation, or null if the subscription renews until you cancel it. Fintoc cancels the subscription at this timestamp and issues no invoice for a billing period that starts at or after it.

Ejemplo:

"2027-06-01T15:00:00Z"

collection_method
enum<string>
requerido

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).

Opciones disponibles:
charge_automatically,
send_invoice
Ejemplo:

"charge_automatically"

created_at
string<date-time>
requerido

ISO 8601 timestamp of when the subscription was created.

Ejemplo:

"2026-06-01T15:00:00Z"

customer
string
requerido

ID of the customer the subscription bills.

Ejemplo:

"cus_2c4mDe9NJyGmMzvCqLkXqAtjnRu"

items
object[]
requerido

Items the subscription bills for on every billing cycle.

metadata
object
requerido

Set of key-value pairs attached to the subscription.

Ejemplo:
mode
enum<string>
requerido

Mode of the object. One of live or test. test subscriptions use fake data for integration testing and do not collect real money.

Opciones disponibles:
live,
test
Ejemplo:

"live"

payment_method
string | null
requerido

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.

Ejemplo:

"pm_2c4mDhAbCdEfGhIjKlMnOpQrStu"

reason
enum<string> | null
requerido

Reason the subscription reports inconsistent. split_amount_mismatch means the flat split amounts do not add up to the total of the items, or a percentage split leaves an entity with no amount. Fintoc skips this check when an item is priced in a currency other than the subscription's. The invoice amount depends on the exchange rate of each billing cycle. null for every other status.

Opciones disponibles:
split_amount_mismatch,
null
Ejemplo:

null

split
object[] | null
requerido

Rules for dividing the payment of every invoice between entities. These rules match the split rules you provided when creating the subscription. null when the subscription was created without a split.

status
enum<string>
requerido

Current status of the subscription. One of active, incomplete, trialing, paused, inconsistent, or canceled. incomplete means the first invoice payment has not yet succeeded. trialing means the trial period has not ended. paused means Fintoc stops generating invoices while the organization cannot access subscriptions, but still charges invoices that are already open. inconsistent means the split can no longer be applied to the total of the items. Update the split or the items before the next invoice. Fintoc cannot finalize the invoice until the totals match, and reason explains the mismatch. canceled means the subscription stopped generating invoices.

Opciones disponibles:
active,
canceled,
incomplete,
paused,
trialing,
inconsistent
Ejemplo:

"active"

trial_end
string<date-time> | null
requerido

ISO 8601 timestamp at which the trial period ends, or null if the subscription has no trial.

Ejemplo:

null