What the subscription bills, item by item. Each item has a kind: recurring_fee (a fixed fee, with timingadvance to bill at the start of the period or arrears to bill at the end; defaults to advance), credit_grant (credits granted each cycle) or metered_usage (metered usage, billed at the end of the period). Only recurring_fee takes timing. When omitted, items follow the product's pricing model: a prepaid product bills the fee up front and grants credits; any other bills the fee and usage at the end of the period.
One billing window of a subscription. Metered usage lands in the open period.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Infi","colors":{"primary":"#0A1430","light":"#E2B13C","dark":"#0A1430"},"logo":{"light":"https://mintcdn.com/beinfi/owBheEE6vXSyqXTj/logo/logo.svg?fit=max\u0026auto=format\u0026n=owBheEE6vXSyqXTj\u0026q=85\u0026s=b1b9ce09a8814e42032ef2bf2c08fb54","dark":"https://mintcdn.com/beinfi/owBheEE6vXSyqXTj/logo/logo.svg?fit=max\u0026auto=format\u0026n=owBheEE6vXSyqXTj\u0026q=85\u0026s=b1b9ce09a8814e42032ef2bf2c08fb54","href":"https://beinfi.com"},"favicon":"https://mintcdn.com/beinfi/owBheEE6vXSyqXTj/favicon.svg?fit=max\u0026auto=format\u0026n=owBheEE6vXSyqXTj\u0026q=85\u0026s=cbb3280c14965b007e9662521134e88c","api":{"playground":{"display":"interactive"}},"navbar":{"links":[{"href":"https://app-sandbox.beinfi.com","label":"Sandbox"}],"primary":{"type":"button","label":"Começar","href":"https://app.beinfi.com"}},"footer":{"socials":{"website":"https://beinfi.com"}},"styling":{"latex":true},"navigation":{"languages":[{"language":"pt-BR","default":true,"href":"introducao"},{"language":"en","href":"en/introducao"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"beinfi","hasAudioNarration":false,"actualSubdomain":"beinfi","customDomains":["docs.beinfi.com"],"gitSource":{"type":"github","owner":"be-infinitum","repo":"infi","deployBranch":"main","contentDirectory":"infi-docs","isPrivate":true,"mountPath":"","label":"","_id":"6adfafa06d56e5c194b62908"},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6ae91a58c27bfbde36d8601a","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"pt-BR","tag":"Referência da API","count":72},{"language":"en","tag":"API reference","count":72},{"language":"pt-BR","tag":"Catálogo","count":21},{"language":"en","tag":"Catalog","count":21},{"language":"pt-BR","tag":"Guias","count":17},{"language":"en","tag":"Guides","count":17},{"language":"pt-BR","tag":"Começar","count":13},{"language":"en","tag":"Get started","count":13},{"language":"pt-BR","tag":"Clientes","count":8},{"language":"pt-BR","tag":"Faturas","count":8},{"language":"en","tag":"Customers","count":8},{"language":"en","tag":"Invoices","count":8},{"language":"pt-BR","tag":"Webhooks","count":7},{"language":"en","tag":"Webhooks","count":7},{"language":"pt-BR","tag":"Conta","count":5},{"language":"pt-BR","tag":"Cupons","count":5},{"language":"pt-BR","tag":"Pagamentos","count":5},{"language":"en","tag":"Account","count":5},{"language":"en","tag":"Coupons","count":5},{"language":"en","tag":"Payments","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"en/api-reference/subscriptions/create-a-subscription","slug":"/en/api-reference/subscriptions/create-a-subscription","pageMetadata":{"title":"Create a subscription","description":"Subscribes the customer to the product and opens the first billing period. The response carries the subscription and that period.\n\n`customerId` is the customer's product enrollment id (from `POST /metering/products/{productID}/customers`), not the customer id.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /billing/products/{productID}/subscriptions","href":"/en/api-reference/subscriptions/create-a-subscription","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Subscribes the customer to the product and opens the first billing period. The response carries the subscription and that period.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.code, {\n children: \"customerId\"\n }), \" is the customer’s product enrollment id (from \", _jsx(_components.code, {\n children: \"POST /metering/products/{productID}/customers\"\n }), \"), not the customer id.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a subscription","description":"Subscribes the customer to the product and opens the first billing period. The response carries the subscription and that period.\n\n`customerId` is the customer's product enrollment id (from `POST /metering/products/{productID}/customers`), not the customer id.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /billing/products/{productID}/subscriptions","href":"/en/api-reference/subscriptions/create-a-subscription","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Subscriptions"],"operationId":"createSubscription","parameters":["81b6694d-38c7-46a8-b05d-c0c5f301cc37"],"requestBody":"dc085221-c14b-486c-839b-41c93eae2bda","responses":{"201":"d4467f0a-a9fb-4740-b0b3-2d964d118869","400":"a6e224b1-2dcc-4dcb-9620-0e76677394af","401":"100549c1-cb37-4567-beec-e7cb54184451","422":"f761c796-d477-4f64-b322-ed7c610a427f"},"summary":"Create a subscription","description":"Subscribes the customer to the product and opens the first billing period. The response carries the subscription and that period.\n\n`customerId` is the customer's product enrollment id (from `POST /metering/products/{productID}/customers`), not the customer id.\n","method":"post","type":"path","servers":["32764daa-a0ab-4e11-9cce-071a6d157f12","8926f6ec-3b25-4b18-916e-1427c5952655"],"security":["6ad9c29e-e93e-4c8b-8dc5-5621a2b1f9da"],"path":"/billing/products/{productID}/subscriptions","baseUrlOptions":["https://api-sandbox.beinfi.com","https://api.beinfi.com"],"title":"Create a subscription","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"81b6694d-38c7-46a8-b05d-c0c5f301cc37":{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","isRequired":false,"description":"A unique key per operation (a UUID works). Retrying with the same key returns the original response.","uniqueKey":"","typeLabel":"string"},"description":"A unique key per operation (a UUID works). Retrying with the same key returns the original response."},"32793638-bba3-4d14-a3cd-f1a4b618b181":{"name":"productID","in":"path","required":true,"schema":{"type":"string","pattern":"^prod_[0-9A-Za-z]{22}$","example":"prod_1d4YogBuw00jAySh5mbUpk","isRequired":true,"description":"Product ID.","uniqueKey":"","typeLabel":"string"},"description":"Product ID."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["customerId"],"properties":{"customerId":{"type":"string","format":"uuid","description":"The customer's enrollment id for this product.","isRequired":true,"uniqueKey":"customerId","typeLabel":"string\u003cuuid>"},"productVersionId":{"oneOf":[{"type":"string","format":"uuid","description":"The product version the subscription bills. Defaults to the latest published version.","uniqueKey":"productVersionId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"The product version the subscription bills. Defaults to the latest published version.","uniqueKey":"productVersionId.oneOf.1","typeLabel":"null"}],"uniqueKey":"productVersionId","typeLabel":"string\u003cuuid> | null"},"anchor":{"oneOf":[{"type":"string","format":"date-time","description":"When the billing cycle starts, which sets the day of later charges. Defaults to the time of creation.","uniqueKey":"anchor.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When the billing cycle starts, which sets the day of later charges. Defaults to the time of creation.","uniqueKey":"anchor.oneOf.1","typeLabel":"null"}],"uniqueKey":"anchor","typeLabel":"string\u003cdate-time> | null"},"items":{"type":"array","items":{"type":"object","required":["kind"],"properties":{"kind":{"type":"string","enum":["recurring_fee","credit_grant","metered_usage"],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"timing":{"oneOf":[{"type":"string","enum":["advance","arrears",null],"uniqueKey":"\\items.items.[INDEX].timing.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["advance","arrears",null],"uniqueKey":"\\items.items.[INDEX].timing.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].timing","typeLabel":"enum\u003cstring> | null"}},"uniqueKey":"\\items.items.[INDEX]","typeLabel":"object"},"description":"What the subscription bills, item by item. Each item has a `kind`: `recurring_fee` (a fixed fee, with `timing` `advance` to bill at the start of the period or `arrears` to bill at the end; defaults to `advance`), `credit_grant` (credits granted each cycle) or `metered_usage` (metered usage, billed at the end of the period). Only `recurring_fee` takes `timing`. When omitted, items follow the product's pricing model: a prepaid product bills the fee up front and grants credits; any other bills the fee and usage at the end of the period.\n","uniqueKey":"\\items","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"customerId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","productVersionId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","anchor":"2023-11-07T05:31:56Z","items":[{}]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"d4467f0a-a9fb-4740-b0b3-2d964d118869":{"content":{"application/json":{"schema":{"type":"object","required":["subscription","period"],"properties":{"subscription":{"type":"object","required":["id","customerId","productVersionId","status","billingCycle","billingMode","anchor","startedAt"],"properties":{"id":{"type":"string","pattern":"^sub_[0-9A-Za-z]{22}$","example":"sub_2Kp7rWqT0aLm4XcVb8NzJe","isRequired":true,"uniqueKey":"subscription.id","typeLabel":"string"},"customerId":{"type":"string","format":"uuid","description":"Enrollment ID.","isRequired":true,"uniqueKey":"subscription.customerId","typeLabel":"string\u003cuuid>"},"productVersionId":{"type":"string","format":"uuid","description":"The product version subscribed to. It sets the price billed, even if the product changes later.","isRequired":true,"uniqueKey":"subscription.productVersionId","typeLabel":"string\u003cuuid>"},"status":{"type":"string","enum":["trialing","active","past_due","paused","canceled"],"isRequired":true,"uniqueKey":"subscription.status","typeLabel":"enum\u003cstring>"},"billingCycle":{"type":"string","enum":["weekly","monthly","annual"],"isRequired":true,"uniqueKey":"subscription.billingCycle","typeLabel":"enum\u003cstring>"},"billingMode":{"type":"string","enum":["arrears","advance"],"description":"`advance` bills at the start of the period; `arrears`, at the end.","isRequired":true,"uniqueKey":"subscription.billingMode","typeLabel":"enum\u003cstring>"},"anchor":{"type":"string","format":"date-time","description":"Reference date the billing periods are counted from.","isRequired":true,"uniqueKey":"subscription.anchor","typeLabel":"string\u003cdate-time>"},"startedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"subscription.startedAt","typeLabel":"string\u003cdate-time>"},"collectionMethod":{"type":"string","enum":["charge_automatically","send_invoice"],"description":"`charge_automatically` charges on its own; `send_invoice` sends the invoice for the customer to pay.","uniqueKey":"subscription.collectionMethod","typeLabel":"enum\u003cstring>"},"nextBillingDate":{"oneOf":[{"type":"string","format":"date-time","description":"Next billing date.","uniqueKey":"subscription.nextBillingDate.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Next billing date.","uniqueKey":"subscription.nextBillingDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"subscription.nextBillingDate","typeLabel":"string\u003cdate-time> | null"},"canceledAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"subscription.canceledAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"subscription.canceledAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"subscription.canceledAt","typeLabel":"string\u003cdate-time> | null"},"cancelReason":{"type":"object","required":["code"],"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"subscription.cancelReason.code","typeLabel":"string"},"note":{"type":"string","uniqueKey":"subscription.cancelReason.note","typeLabel":"string"},"source":{"type":"string","enum":["buyer","merchant"],"uniqueKey":"subscription.cancelReason.source","typeLabel":"enum\u003cstring>"}},"uniqueKey":"subscription.cancelReason","typeLabel":"object"},"items":{"type":"array","items":{"type":"object","required":["id","kind","productVersionId","createdAt"],"properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"subscription.\\items.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"kind":{"type":"string","enum":["recurring_fee","credit_grant","metered_usage","prepaid_usage"],"description":"`recurring_fee` is the fixed recurring fee; `credit_grant`, credits granted each cycle; `metered_usage`, usage billed afterwards; `prepaid_usage`, usage paid upfront.","isRequired":true,"uniqueKey":"subscription.\\items.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"productVersionId":{"type":"string","format":"uuid","description":"The product version the item comes from.","isRequired":true,"uniqueKey":"subscription.\\items.items.[INDEX].productVersionId","typeLabel":"string\u003cuuid>"},"createdAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"subscription.\\items.items.[INDEX].createdAt","typeLabel":"string\u003cdate-time>"},"timing":{"oneOf":[{"type":"string","enum":["advance","arrears",null],"description":"`advance` bills at the start of the period; `arrears`, at the end.","uniqueKey":"subscription.\\items.items.[INDEX].timing.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["advance","arrears",null],"description":"`advance` bills at the start of the period; `arrears`, at the end.","uniqueKey":"subscription.\\items.items.[INDEX].timing.oneOf.1","typeLabel":"null"}],"uniqueKey":"subscription.\\items.items.[INDEX].timing","typeLabel":"enum\u003cstring> | null"},"canceledAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"subscription.\\items.items.[INDEX].canceledAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"subscription.\\items.items.[INDEX].canceledAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"subscription.\\items.items.[INDEX].canceledAt","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"subscription.\\items.items.[INDEX]","typeLabel":"object"},"description":"What the subscription bills or grants.","uniqueKey":"subscription.\\items","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"subscription","typeLabel":"object"},"period":{"type":"object","required":["id","subscriptionId","periodStart","periodEnd","status"],"properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"period.id","typeLabel":"string\u003cuuid>"},"subscriptionId":{"type":"string","pattern":"^sub_[0-9A-Za-z]{22}$","example":"sub_2Kp7rWqT0aLm4XcVb8NzJe","isRequired":true,"uniqueKey":"period.subscriptionId","typeLabel":"string"},"periodStart":{"type":"string","format":"date-time","description":"Start of the period (inclusive).","isRequired":true,"uniqueKey":"period.periodStart","typeLabel":"string\u003cdate-time>"},"periodEnd":{"type":"string","format":"date-time","description":"End of the period (exclusive).","isRequired":true,"uniqueKey":"period.periodEnd","typeLabel":"string\u003cdate-time>"},"status":{"type":"string","enum":["open","closed","invoiced"],"description":"`open` (collecting usage), `closed` (ended, invoice not generated yet) or `invoiced` (already billed).","isRequired":true,"uniqueKey":"period.status","typeLabel":"enum\u003cstring>"},"invoiceId":{"oneOf":[{"type":"string","description":"The invoice that billed this period","pattern":"^inv_[0-9A-Za-z]{22}$","example":"inv_6yi30EKotIwGHZdePSdsFc","uniqueKey":"period.invoiceId.oneOf.0","typeLabel":"string"},{"type":"null","description":"The invoice that billed this period","uniqueKey":"period.invoiceId.oneOf.1","typeLabel":"null"}],"uniqueKey":"period.invoiceId","typeLabel":"string | null"}},"description":"One billing window of a subscription. Metered usage lands in the open period.","isRequired":true,"uniqueKey":"period","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"subscription":{"id":"sub_2Kp7rWqT0aLm4XcVb8NzJe","customerId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","productVersionId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","status":"trialing","billingCycle":"weekly","billingMode":"arrears","anchor":"2023-11-07T05:31:56Z","startedAt":"2023-11-07T05:31:56Z","collectionMethod":"charge_automatically","nextBillingDate":"2023-11-07T05:31:56Z","canceledAt":"2023-11-07T05:31:56Z","cancelReason":{"code":"\u003cstring>","note":"\u003cstring>","source":"buyer"},"items":[{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","kind":"recurring_fee","productVersionId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","createdAt":"2023-11-07T05:31:56Z","timing":"advance","canceledAt":"2023-11-07T05:31:56Z"}]},"period":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","subscriptionId":"sub_2Kp7rWqT0aLm4XcVb8NzJe","periodStart":"2023-11-07T05:31:56Z","periodEnd":"2023-11-07T05:31:56Z","status":"open","invoiceId":"inv_6yi30EKotIwGHZdePSdsFc"}}}},"exampleType":"generated"}},"description":"Created.","exampleType":"generated"},"a6e224b1-2dcc-4dcb-9620-0e76677394af":{"content":{"application/json":{"schema":{"type":"object","required":["message","error_code","tracer_id"],"properties":{"message":{"type":"string","description":"Human-readable sentence.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error_code":{"type":"string","examples":["internal_error","validation_failed","bad_request","unauthorized","forbidden","not_found","conflict","rate_limited"],"description":"Stable error code. Branch on it.","isRequired":true,"uniqueKey":"error_code","typeLabel":"string"},"tracer_id":{"type":"string","description":"Request id. Include it when contacting support.","isRequired":true,"uniqueKey":"tracer_id","typeLabel":"string"}},"description":"The standard error body. It is flat (no `error` wrapper) and the trace id is `tracer_id`.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","error_code":"internal_error","tracer_id":"\u003cstring>"}}},"exampleType":"generated"}},"description":"Malformed request.","exampleType":"generated"},"100549c1-cb37-4567-beec-e7cb54184451":{"content":{"application/json":{"schema":{"type":"object","required":["message","error_code","tracer_id"],"properties":{"message":{"type":"string","description":"Human-readable sentence.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error_code":{"type":"string","examples":["internal_error","validation_failed","bad_request","unauthorized","forbidden","not_found","conflict","rate_limited"],"description":"Stable error code. Branch on it.","isRequired":true,"uniqueKey":"error_code","typeLabel":"string"},"tracer_id":{"type":"string","description":"Request id. Include it when contacting support.","isRequired":true,"uniqueKey":"tracer_id","typeLabel":"string"}},"description":"The standard error body. It is flat (no `error` wrapper) and the trace id is `tracer_id`.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","error_code":"internal_error","tracer_id":"\u003cstring>"}}},"exampleType":"generated"}},"description":"Missing or invalid API key.","exampleType":"generated"},"f761c796-d477-4f64-b322-ed7c610a427f":{"content":{"application/json":{"schema":{"type":"object","required":["message","error_code","tracer_id","errors"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"error_code":{"type":"string","examples":["internal_error","validation_failed","bad_request","unauthorized","forbidden","not_found","conflict","rate_limited"],"description":"Stable error code. The list is open: besides the generic codes, each area defines its own (`coupon_expired`, `insufficient_balance`, `version_not_draft`, `idempotency_key_reused`…). Handle a code you do not recognize by its HTTP status and show `message`; do not fail parsing the response.","isRequired":true,"uniqueKey":"error_code","typeLabel":"string"},"tracer_id":{"type":"string","isRequired":true,"uniqueKey":"tracer_id","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","required":["field","value","constraint","description"],"properties":{"field":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"value":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].value","typeLabel":"string"},"constraint":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].constraint","typeLabel":"string"},"description":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].description","typeLabel":"string"}},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"description":"Per-field detail (`field`, `description`). Always present on a `422`; may be empty.","isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"description":"Body of a `422`. Same shape as `Error`, plus `errors[]` with per-field detail. That is where the sentence telling you what to fix lives (for example, \"product has no published version\").","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","error_code":"internal_error","tracer_id":"\u003cstring>","errors":[{"field":"\u003cstring>","value":"\u003cstring>","constraint":"\u003cstring>","description":"\u003cstring>"}]}}},"exampleType":"generated"}},"description":"One or more fields are invalid. Per-field detail is in `errors[]`.","exampleType":"generated"}},"security":{"6ad9c29e-e93e-4c8b-8dc5-5621a2b1f9da":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Your account's secret key: `Authorization: Bearer sk_test_…` or `sk_live_…`. Server-side only.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"32764daa-a0ab-4e11-9cce-071a6d157f12":{"url":"https://api-sandbox.beinfi.com","description":"Sandbox"},"8926f6ec-3b25-4b18-916e-1427c5952655":{"url":"https://api.beinfi.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Your account's secret key: `Authorization: Bearer sk_test_…` or `sk_live_…`. Server-side only.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Your account's secret key: `Authorization: Bearer sk_test_…` or `sk_live_…`. Server-side only.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.en.json"},"subdomain":"beinfi","siteName":"Infi","title":"Create a subscription - Infi","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"pt-BR":{"href":"/introducao","matchLevel":4},"en":{"href":"/en/api-reference/subscriptions/create-a-subscription","matchLevel":0}}},"lastModified":"2026-11-02T23:19:07.312Z","originalFileLocation":"en/api-reference/subscriptions/create-a-subscription.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Subscribes the customer to the product and opens the first billing period. The response carries the subscription and that period. customerId is the customer\u0026#x27;s product enrollment id (from POST /metering/products/{productID}/customers), not the customer id.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Infi\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/beinfi/6L9ijlDVcq5aSfgL/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/beinfi/6L9ijlDVcq5aSfgL/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/beinfi/6L9ijlDVcq5aSfgL/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/beinfi/6L9ijlDVcq5aSfgL/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/beinfi/6L9ijlDVcq5aSfgL/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/beinfi/6L9ijlDVcq5aSfgL/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/beinfi/6L9ijlDVcq5aSfgL/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/beinfi/6L9ijlDVcq5aSfgL/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/beinfi/6L9ijlDVcq5aSfgL/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a subscription - Infi\">\u003cmeta data-mint-head property=\"og:description\" content=\"Subscribes the customer to the product and opens the first billing period. The response carries the subscription and that period. customerId is the customer\u0026#x27;s product enrollment id (from POST /metering/products/{productID}/customers), not the customer id.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Infi\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.beinfi.com/en/api-reference/subscriptions/create-a-subscription\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://beinfi.mintlify.site/_mintlify/api/og/v2?division=Subscriptions\u0026amp;title=Create+a+subscription\u0026amp;description=Subscribes+the+customer+to+the+product+and+opens+the+first+billing+period.+The+response+carries+the+subscription+and+that+period.%0A%0A%60customerId%60+is+the+customer%27\u0026amp;theme=0f1e10ebee4743982aba108c\u0026amp;signature=3c1699eedcc2ee07fbb42f9aca100997943fe7dec9bcb608c44a37a0badec8da\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a subscription - Infi\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Subscribes the customer to the product and opens the first billing period. The response carries the subscription and that period. customerId is the customer\u0026#x27;s product enrollment id (from POST /metering/products/{productID}/customers), not the customer id.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://beinfi.mintlify.site/_mintlify/api/og/v2?division=Subscriptions\u0026amp;title=Create+a+subscription\u0026amp;description=Subscribes+the+customer+to+the+product+and+opens+the+first+billing+period.+The+response+carries+the+subscription+and+that+period.%0A%0A%60customerId%60+is+the+customer%27\u0026amp;theme=0f1e10ebee4743982aba108c\u0026amp;signature=3c1699eedcc2ee07fbb42f9aca100997943fe7dec9bcb608c44a37a0badec8da\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/beinfi/6L9ijlDVcq5aSfgL/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Infi\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0A1430\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.beinfi.com/en/api-reference/subscriptions/create-a-subscription\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/api-reference/subscriptions/create-a-subscription.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.beinfi.com/#organization\",\"name\":\"Infi\",\"url\":\"https://docs.beinfi.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/beinfi/owBheEE6vXSyqXTj/logo/logo.svg?fit=max\u0026auto=format\u0026n=owBheEE6vXSyqXTj\u0026q=85\u0026s=b1b9ce09a8814e42032ef2bf2c08fb54\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.beinfi.com#website\",\"name\":\"Infi\",\"url\":\"https://docs.beinfi.com\",\"publisher\":{\"@id\":\"https://docs.beinfi.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.beinfi.com/en/api-reference/subscriptions/create-a-subscription#webpage\",\"url\":\"https://docs.beinfi.com/en/api-reference/subscriptions/create-a-subscription\",\"name\":\"Create a subscription\",\"description\":\"Subscribes the customer to the product and opens the first billing period. The response carries the subscription and that period. customerId is the customer's product enrollment id (from POST /metering/products/{productID}/customers), not the customer id.\",\"dateModified\":\"2026-11-02T23:19:07.312Z\",\"isPartOf\":{\"@id\":\"https://docs.beinfi.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.beinfi.com/en/api-reference/subscriptions/create-a-subscription#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.beinfi.com/en/api-reference/subscriptions/create-a-subscription#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Infi\",\"item\":\"https://docs.beinfi.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a subscription\",\"item\":\"https://docs.beinfi.com/en/api-reference/subscriptions/create-a-subscription\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.beinfi.com/en/api-reference/subscriptions/create-a-subscription#apireference\",\"headline\":\"Create a subscription\",\"name\":\"Create a subscription\",\"description\":\"Subscribes the customer to the product and opens the first billing period. The response carries the subscription and that period. customerId is the customer's product enrollment id (from POST /metering/products/{productID}/customers), not the customer id.\",\"url\":\"https://docs.beinfi.com/en/api-reference/subscriptions/create-a-subscription\",\"mainEntityOfPage\":{\"@id\":\"https://docs.beinfi.com/en/api-reference/subscriptions/create-a-subscription#webpage\"},\"dateModified\":\"2026-11-02T23:19:07.312Z\",\"publisher\":{\"@id\":\"https://docs.beinfi.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.beinfi.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Infi\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Infi","nav":{"global":null,"languages":[{"language":"pt-BR","default":true,"pages":[{"title":"pt-BR","href":"/introducao"}]},{"language":"en","tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/en/introducao"}]},{"tab":"API reference","groups":[{"group":"Checkout","pages":[{"title":"Read an invoice at checkout","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /pay/{slug}/invoices/{invoiceID}","href":"/en/api-reference/checkout/read-an-invoice-at-checkout"},{"title":"Pay an invoice at checkout","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /pay/{slug}/invoices/{invoiceID}/charge","href":"/en/api-reference/checkout/pay-an-invoice-at-checkout"},{"title":"Apply a coupon to an invoice","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /pay/{slug}/invoices/{invoiceID}/coupon","href":"/en/api-reference/checkout/apply-a-coupon-to-an-invoice"},{"title":"Download a digital product","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /pay/{slug}/download/{token}","href":"/en/api-reference/checkout/download-a-digital-product"}]},{"group":"Test account","pages":[{"title":"Create a test account","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /public/v1/claimables","href":"/en/api-reference/test-account/create-a-test-account"},{"title":"Get a test account","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /public/v1/claimables/{claimableID}","href":"/en/api-reference/test-account/get-a-test-account"}]},{"group":"Catalog","pages":[{"title":"Prepare an image upload","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /catalog/images/presign","href":"/en/api-reference/catalog/prepare-an-image-upload"},{"title":"List products","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /products","href":"/en/api-reference/catalog/list-products"},{"title":"Create a product","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /products","href":"/en/api-reference/catalog/create-a-product"},{"title":"Get a product","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /products/{productID}","href":"/en/api-reference/catalog/get-a-product"},{"title":"Update a product","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json patch /products/{productID}","href":"/en/api-reference/catalog/update-a-product"},{"title":"List product versions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /products/{productID}/versions","href":"/en/api-reference/catalog/list-product-versions"},{"title":"Create a new version","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /products/{productID}/versions","href":"/en/api-reference/catalog/create-a-new-version"},{"title":"Publish a version","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /products/{productID}/versions/{versionID}/publish","href":"/en/api-reference/catalog/publish-a-version"},{"title":"List a version's prices","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /products/{productID}/versions/{versionID}/prices","href":"/en/api-reference/catalog/list-a-versions-prices"},{"title":"Add a price to a version","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /products/{productID}/versions/{versionID}/prices","href":"/en/api-reference/catalog/add-a-price-to-a-version"},{"title":"List a product's meters","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /products/{productID}/meters","href":"/en/api-reference/catalog/list-a-products-meters"},{"title":"Create a meter","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /products/{productID}/meters","href":"/en/api-reference/catalog/create-a-meter"},{"title":"Create a link with a product","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /payment-links","href":"/en/api-reference/catalog/create-a-link-with-a-product"},{"title":"List a product's links","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /products/{productID}/payment-links","href":"/en/api-reference/catalog/list-a-products-links"},{"title":"Create a payment link","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /products/{productID}/payment-links","href":"/en/api-reference/catalog/create-a-payment-link"},{"title":"Revoke a payment link","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json delete /products/{productID}/payment-links/{linkID}","href":"/en/api-reference/catalog/revoke-a-payment-link"},{"title":"Update a meter","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json patch /products/{productID}/meters/{meterID}","href":"/en/api-reference/catalog/update-a-meter"},{"title":"Get a file upload URL","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /products/{productID}/deliverable/presign","href":"/en/api-reference/catalog/get-a-file-upload-url"},{"title":"Get the deliverable","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /products/{productID}/deliverable","href":"/en/api-reference/catalog/get-the-deliverable"},{"title":"Save the deliverable","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json put /products/{productID}/deliverable","href":"/en/api-reference/catalog/save-the-deliverable"},{"title":"Delete the deliverable","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json delete /products/{productID}/deliverable","href":"/en/api-reference/catalog/delete-the-deliverable"}]},{"group":"Customers","pages":[{"title":"Create a customer","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /customers","href":"/en/api-reference/customers/create-a-customer"},{"title":"Enroll a customer","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /products/{productID}/customers","href":"/en/api-reference/customers/enroll-a-customer"},{"title":"Get a customer","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /customers/{customerID}","href":"/en/api-reference/customers/get-a-customer"},{"title":"Get customer state","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /customers/{customerID}/state","href":"/en/api-reference/customers/get-customer-state"},{"title":"Get balances","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /customers/{customerID}/wallet","href":"/en/api-reference/customers/get-balances"},{"title":"List customer rate cards","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /customers/{customerID}/rate-cards","href":"/en/api-reference/customers/list-customer-rate-cards"},{"title":"Set a customer rate card","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /customers/{customerID}/rate-cards","href":"/en/api-reference/customers/set-a-customer-rate-card"},{"title":"Delete a customer rate card","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json delete /customers/{customerID}/rate-cards/{rateCardID}","href":"/en/api-reference/customers/delete-a-customer-rate-card"}]},{"group":"Metering","pages":[{"title":"Record a usage event","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /metering/events","href":"/en/api-reference/metering/record-a-usage-event"},{"title":"Record usage events in batch","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /metering/events/batch","href":"/en/api-reference/metering/record-usage-events-in-batch"},{"title":"Get customer usage","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /metering/usage","href":"/en/api-reference/metering/get-customer-usage"}]},{"group":"Invoices","pages":[{"title":"List invoices","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /billing/invoices","href":"/en/api-reference/invoices/list-invoices"},{"title":"Create a one-off invoice","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /billing/invoices","href":"/en/api-reference/invoices/create-a-one-off-invoice"},{"title":"Invoice accrued usage","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /billing/invoices/from-usage","href":"/en/api-reference/invoices/invoice-accrued-usage"},{"title":"Sell a product","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /billing/products/{productID}/invoices","href":"/en/api-reference/invoices/sell-a-product"},{"title":"Invoice the current period","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /billing/subscriptions/{subscriptionID}/invoices","href":"/en/api-reference/invoices/invoice-the-current-period"},{"title":"Get an invoice","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /billing/invoices/{invoiceID}","href":"/en/api-reference/invoices/get-an-invoice"},{"title":"Email an invoice","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /billing/invoices/{invoiceID}/send","href":"/en/api-reference/invoices/email-an-invoice"},{"title":"Void an invoice","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /billing/invoices/{invoiceID}/void","href":"/en/api-reference/invoices/void-an-invoice"}]},{"group":"Payments","pages":[{"title":"List payments","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /billing/payments","href":"/en/api-reference/payments/list-payments"},{"title":"List an invoice's payments","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /billing/invoices/{invoiceID}/payments","href":"/en/api-reference/payments/list-an-invoices-payments"},{"title":"Get a payment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /billing/payments/{paymentID}","href":"/en/api-reference/payments/get-a-payment"},{"title":"Refund a payment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /billing/payments/{paymentID}/refund","href":"/en/api-reference/payments/refund-a-payment"},{"title":"List a payment's refunds","description":"Every refund of a payment, oldest first. Since a payment can be refunded in parts, this is where you see what makes up the payment's `refundedAmount`.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /billing/payments/{paymentID}/refunds","href":"/en/api-reference/payments/list-a-payments-refunds"}]},{"group":"Subscriptions","pages":[{"title":"Create a subscription","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /billing/products/{productID}/subscriptions","href":"/en/api-reference/subscriptions/create-a-subscription"},{"title":"List an enrollment's subscriptions","description":"Lists an enrollment's subscriptions, newest first. `customerID` is the customer's product enrollment id, not the customer id.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /billing/customers/{customerID}/subscriptions","href":"/en/api-reference/subscriptions/list-an-enrollments-subscriptions"},{"title":"Get a subscription","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /billing/subscriptions/{subscriptionID}","href":"/en/api-reference/subscriptions/get-a-subscription"}]},{"group":"Billing","pages":[{"title":"List invoice download links","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /billing/invoices/{invoiceID}/deliverable","href":"/en/api-reference/billing/list-invoice-download-links"}]},{"group":"Coupons","pages":[{"title":"List coupons","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /billing/coupons","href":"/en/api-reference/coupons/list-coupons"},{"title":"Create a coupon","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /billing/coupons","href":"/en/api-reference/coupons/create-a-coupon"},{"title":"Get a coupon","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /billing/coupons/{couponID}","href":"/en/api-reference/coupons/get-a-coupon"},{"title":"Delete a coupon","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json delete /billing/coupons/{couponID}","href":"/en/api-reference/coupons/delete-a-coupon"},{"title":"Activate or archive a coupon","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json patch /billing/coupons/{couponID}","href":"/en/api-reference/coupons/activate-or-archive-a-coupon"}]},{"group":"Account","pages":[{"title":"Get your account","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /account/tenant","href":"/en/api-reference/account/get-your-account"},{"title":"Update your account","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json patch /account/tenant","href":"/en/api-reference/account/update-your-account"},{"title":"List API keys","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /account/api-keys","href":"/en/api-reference/account/list-api-keys"},{"title":"Create an API key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /account/api-keys","href":"/en/api-reference/account/create-an-api-key"},{"title":"Revoke an API key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json delete /account/api-keys/{keyID}","href":"/en/api-reference/account/revoke-an-api-key"}]},{"group":"Webhooks","pages":[{"title":"List webhook endpoints","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /account/webhooks","href":"/en/api-reference/webhooks/list-webhook-endpoints"},{"title":"Create a webhook endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /account/webhooks","href":"/en/api-reference/webhooks/create-a-webhook-endpoint"},{"title":"List webhook deliveries","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /account/webhooks/deliveries","href":"/en/api-reference/webhooks/list-webhook-deliveries"},{"title":"Get a webhook endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json get /account/webhooks/{endpointID}","href":"/en/api-reference/webhooks/get-a-webhook-endpoint"},{"title":"Delete a webhook endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json delete /account/webhooks/{endpointID}","href":"/en/api-reference/webhooks/delete-a-webhook-endpoint"},{"title":"Update a webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json patch /account/webhooks/{endpointID}","href":"/en/api-reference/webhooks/update-a-webhook"},{"title":"Rotate a webhook secret","deprecated":null,"version":null,"openapi":"/api-reference/openapi.en.json post /account/webhooks/{endpointID}/rotate-secret","href":"/en/api-reference/webhooks/rotate-a-webhook-secret"}]}]}]}]},"basePath":"","title":"Create a subscription - Infi","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}