Create a subscription

Creates a subscription that bills a customer on a recurring cadence, in the live or test mode of the API key used. Each item defines its price through price_data, referencing an existing product (product) or defining one inline (product_data). All items must share the same currency and the same recurring interval and interval_count, and a subscription can have up to 10 items. Fintoc sets the billing_cycle_anchor to the creation time, and the collection_method is always send_invoice. Fintoc generates and finalizes an initial invoice for the first billing period immediately, and marks zero-amount invoices as paid automatically.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

ID of the customer to bill.

items
array of objects
required
length ≤ 10

Items the subscription bills for on every billing cycle. All items must share the same currency and recurring cadence. Up to 10 items.

items*
metadata
object

Set of key-value pairs to attach to the subscription. Nested objects and arrays are not allowed as values.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json