{
"status": 422,
"type": "PAYMENT_PLAN__SUM_MISMATCH",
"title": "An error occurred",
"detail": "The installments must sum to the open amount of the invoice."
}
{
"status": 422,
"type": "PAYMENT_PLAN__SUM_MISMATCH",
"title": "An error occurred",
"detail": "The installments must sum to the open amount of the invoice."
}
{
"status": 422,
"type": "https://tools.ietf.org/html/rfc2616#section-10",
"title": "Validation Failed",
"violations": [
{
"propertyPath": "installments[0].amount",
"message": "This value should be positive.",
"code": "<string>"
}
]
}
Zahlungsplan-Verwaltung
Create a payment plan
Split an open, finalized invoice into installments. Send EITHER an explicit installments array OR a split object, never both and never neither. The installment amounts (or the computed split) must sum to the current open amount of the invoice in cents. In split mode the rounding remainder is added to the last installment. The invoice must be finalized and open (not draft, paid, canceled or refunded) and must not already have an active plan. While the plan is active, dunning for the invoice is paused.
{
"status": 422,
"type": "PAYMENT_PLAN__SUM_MISMATCH",
"title": "An error occurred",
"detail": "The installments must sum to the open amount of the invoice."
}
{
"status": 422,
"type": "PAYMENT_PLAN__SUM_MISMATCH",
"title": "An error occurred",
"detail": "The installments must sum to the open amount of the invoice."
}
{
"status": 422,
"type": "https://tools.ietf.org/html/rfc2616#section-10",
"title": "Validation Failed",
"violations": [
{
"propertyPath": "installments[0].amount",
"message": "This value should be positive.",
"code": "<string>"
}
]
}
Organisation API token. Send it as Authorization: Bearer api_... The token is scoped to a single Organisation. Reading a plan needs the invoice read permission, creating, canceling and extending need the invoice write permission.
Body
application/json
Send EITHER installments OR split, never both and never neither.
Payment method used for direct-debit collection. Defaults to the invoice payment method, with the customer default as fallback. Must belong to the invoice customer.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Fynn Docs","colors":{"primary":"#000","light":"#fff","dark":"#000"},"logo":{"light":"https://mintcdn.com/fynnsubscriptionbilling/kPbBeWVEZfmEic9q/logo/logo-dark.svg?fit=max\u0026auto=format\u0026n=kPbBeWVEZfmEic9q\u0026q=85\u0026s=83e4b30a53d77c3809e0f22afa29335d","dark":"https://mintcdn.com/fynnsubscriptionbilling/kPbBeWVEZfmEic9q/logo/dark.svg?fit=max\u0026auto=format\u0026n=kPbBeWVEZfmEic9q\u0026q=85\u0026s=5798319f6c8632d79fe789f72eaa94e2"},"favicon":"https://mintcdn.com/fynnsubscriptionbilling/zDQkHT5wBBQ3jA-O/favicon.svg?fit=max\u0026auto=format\u0026n=zDQkHT5wBBQ3jA-O\u0026q=85\u0026s=410ff1f698a399faed9fbb877457bb43","api":{"openapi":["assets/openapi.json","assets/openapi-v2-plans.json","assets/openapi-v2-offers.json","assets/openapi-v2-commission.json","assets/openapi-v2-payment-plans.json","assets/openapi-v2-finance.json"],"playground":{"display":"interactive"},"examples":{"languages":["curl","python","javascript","php"]}},"navbar":{"links":[{"href":"https://cal.com/team/fynn/fynn-documentation","label":"Termin buchen"},{"href":"mailto:hi@fynn.eu","label":"Support"}],"primary":{"type":"button","label":"App Login","href":"https://app.fynn.eu"}},"footer":{"socials":{"x":"https://twitter.com/wearefynn","github":"https://github.com/fynn-digital","linkedin":"https://www.linkedin.com/company/wearefynn"}},"integrations":{"gtm":{"tagId":"GTM-NKGQ4TQ9"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":true},"navigation":{"languages":[{"language":"de","default":true,"href":"introduction"},{"language":"en","href":"en/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"fynnsubscriptionbilling","hasAudioNarration":false,"actualSubdomain":"fynnsubscriptionbilling","customDomains":["docs.fynn.eu"],"gitSource":{"type":"gitlab","owner":"fynn/core","repo":"core-api23","deployBranch":"main","contentDirectory":"public-docs","isPrivate":true,"projectId":396,"hostUrl":"https://git.netzfabrik.com","mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae39f66b1c2f4cb3302b8e4","collectionId":"9c0a84cf-d896-49ea-b27f-eaa89233a30b","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae39f66b1c2f4cb3302b8e4"},"feedback":{"thumbs":true,"edits":true,"issues":true,"agentFeedback":true},"entitlements":{"REMOVE_BRANDING":{"status":"ENABLED"}},"buildId":"6ae39f66b1c2f4cb3302b8e4","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"de","tag":"API Referenz","count":249},{"language":"de","tag":"Dokumentation","count":93},{"language":"de","tag":"API V2","count":71},{"language":"en","tag":"Documentation","count":59},{"language":"de","tag":"API","count":46},{"language":"de","tag":"Catalogue","count":42},{"language":"de","tag":"Angebote","count":36},{"language":"de","tag":"Subscription","count":30},{"language":"de","tag":"Customer","count":30},{"language":"de","tag":"Finanzberichte","count":29},{"language":"de","tag":"Payment","count":26},{"language":"default","tag":"API V2","count":18},{"language":"default","tag":"Dokumentation","count":15},{"language":"default","tag":"Pläne","count":15},{"language":"en","tag":"Integrations","count":15},{"language":"default","tag":"API","count":11},{"language":"default","tag":"API Referenz","count":10},{"language":"default","tag":"API documentation","count":10},{"language":"en","tag":"Products","count":9},{"language":"en","tag":"Settings","count":9},{"language":"en","tag":"Customers","count":7},{"language":"en","tag":"Subscriptions","count":7},{"language":"default","tag":"Guides","count":6},{"language":"default","tag":"Plan-Verwaltung","count":6},{"language":"en","tag":"Payment Providers","count":6},{"language":"default","tag":"Nutzungsbasierte Abrechnung","count":5},{"language":"en","tag":"Accounting","count":5},{"language":"en","tag":"Developers","count":5},{"language":"en","tag":"Invoices","count":5},{"language":"default","tag":"KI-Assistent","count":4}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".update-container{display:flex}.update-container>div{position:unset!important}@media (min-width: 1024px){.update-container{flex-direction:column!important}}[data-component-part=\"update-label\"]{background:none}[data-component-part=\"update-tag\"]{-webkit-text-size-adjust:100%;tab-size:4;font-variation-settings:normal;-webkit-tap-highlight-color:transparent;font-feature-settings:\"cv02\",\"cv03\",\"cv04\",\"cv11\";--scroll-mt: 9.5rem;--font-inter: '__Inter_86cd50', '__Inter_Fallback_86cd50';--font-jetbrains-mono: '__JetBrains_Mono_3c557b', '__JetBrains_Mono_Fallback_3c557b';--primary: 39 19 64;--primary-light: 255 255 255;--primary-dark: 0 0 0;--background-light: 255 255 255;--background-dark: 0 0 0;--gray-50: 244 243 244;--gray-100: 239 238 239;--gray-200: 223 223 224;--gray-300: 207 206 207;--gray-400: 159 159 160;--gray-500: 113 112 113;--gray-600: 81 80 81;--gray-700: 63 63 64;--gray-800: 38 37 39;--gray-900: 23 23 24;--gray-950: 11 10 12;font-family:Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\";-webkit-font-smoothing:antialiased;--tw-prose-body: #374151;--tw-prose-headings: #111827;--tw-prose-lead: #4b5563;--tw-prose-links: #111827;--tw-prose-bold: #111827;--tw-prose-counters: #6b7280;--tw-prose-bullets: #d1d5db;--tw-prose-hr: #e5e7eb;--tw-prose-quotes: #111827;--tw-prose-quote-borders: #e5e7eb;--tw-prose-captions: #6b7280;--tw-prose-kbd: #111827;--tw-prose-kbd-shadows: 17 24 39;--tw-prose-code: #111827;--tw-prose-pre-code: #e5e7eb;--tw-prose-pre-bg: #1f2937;--tw-prose-th-borders: #d1d5db;--tw-prose-td-borders: #e5e7eb;--tw-prose-invert-body: #d1d5db;--tw-prose-invert-headings: #fff;--tw-prose-invert-lead: #9ca3af;--tw-prose-invert-links: #fff;--tw-prose-invert-bold: #fff;--tw-prose-invert-counters: #9ca3af;--tw-prose-invert-bullets: #4b5563;--tw-prose-invert-hr: #374151;--tw-prose-invert-quotes: #f3f4f6;--tw-prose-invert-quote-borders: #374151;--tw-prose-invert-captions: #9ca3af;--tw-prose-invert-kbd: #fff;--tw-prose-invert-kbd-shadows: 255 255 255;--tw-prose-invert-code: #fff;--tw-prose-invert-pre-code: #d1d5db;--tw-prose-invert-pre-bg: rgba(0,0,0,.5);--tw-prose-invert-th-borders: #4b5563;--tw-prose-invert-td-borders: #374151;-webkit-user-modify:read-only;box-sizing:border-box;border-width:0;border-style:solid;border-color:rgb(var(--gray-200));--tw-border-spacing-x: 0;--tw-border-spacing-y: 0;--tw-translate-x: 0;--tw-translate-y: 0;--tw-rotate: 0;--tw-skew-x: 0;--tw-skew-y: 0;--tw-scale-x: 1;--tw-scale-y: 1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness: proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width: 0px;--tw-ring-offset-color: #fff;--tw-ring-color: rgba(59,130,246,.5);--tw-ring-offset-shadow: 0 0 #0000;--tw-ring-shadow: 0 0 #0000;--tw-shadow: 0 0 #0000;--tw-shadow-colored: 0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: ;display:flex;flex-grow:0;cursor:pointer;align-items:center;justify-content:center;border-radius:var(--rounded-lg,.5rem);background-color:rgb(var(--primary)/.1);padding-left:.5rem;padding-right:.5rem;padding-top:.25rem;padding-bottom:.25rem;font-size:.875rem;line-height:1.25rem;font-weight:500;--tw-text-opacity: 1;color:rgb(var(--primary)/var(--tw-text-opacity))}"}],"page":{"pagePath":"v2-payment-plans-api/payment-plans/create-payment-plan","slug":"/v2-payment-plans-api/payment-plans/create-payment-plan","pageMetadata":{"openapi":"assets/openapi-v2-payment-plans.json post /api/payment-plans","title":"Create a payment plan","description":"Split an open, finalized invoice into installments. Send EITHER an explicit `installments` array OR a `split` object, never both and never neither. The installment amounts (or the computed split) must sum to the current open amount of the invoice in cents. In split mode the rounding remainder is added to the last installment. The invoice must be finalized and open (not draft, paid, canceled or refunded) and must not already have an active plan. While the plan is active, dunning for the invoice is paused.","href":"/v2-payment-plans-api/payment-plans/create-payment-plan"},"description":{"compiledSource":"\"use strict\";\nconst {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(_components.p, {\n children: [\"Split an open, finalized invoice into installments. Send EITHER an explicit \", _jsx(_components.code, {\n children: \"installments\"\n }), \" array OR a \", _jsx(_components.code, {\n children: \"split\"\n }), \" object, never both and never neither. The installment amounts (or the computed split) must sum to the current open amount of the invoice in cents. In split mode the rounding remainder is added to the last installment. The invoice must be finalized and open (not draft, paid, canceled or refunded) and must not already have an active plan. While the plan is active, dunning for the invoice is paused.\"]\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":{"openapi":"assets/openapi-v2-payment-plans.json post /api/payment-plans","title":"Create a payment plan","description":"Split an open, finalized invoice into installments. Send EITHER an explicit `installments` array OR a `split` object, never both and never neither. The installment amounts (or the computed split) must sum to the current open amount of the invoice in cents. In split mode the rounding remainder is added to the last installment. The invoice must be finalized and open (not draft, paid, canceled or refunded) and must not already have an active plan. While the plan is active, dunning for the invoice is paused.","href":"/v2-payment-plans-api/payment-plans/create-payment-plan"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/fynnsubscriptionbilling/086131e1768d5953/changelog-sidebar.js"],"openApiReferenceData":{"operation":{"operationId":"createPaymentPlan","tags":["Payment Plans"],"summary":"Create a payment plan","description":"Split an open, finalized invoice into installments. Send EITHER an explicit `installments` array OR a `split` object, never both and never neither. The installment amounts (or the computed split) must sum to the current open amount of the invoice in cents. In split mode the rounding remainder is added to the last installment. The invoice must be finalized and open (not draft, paid, canceled or refunded) and must not already have an active plan. While the plan is active, dunning for the invoice is paused.","requestBody":"7f6fa031-b421-4730-86b4-477f665f29a2","responses":{"201":"b6297412-b0ca-4fc1-ae7f-9c70ece12da4","401":"77eaf985-b527-440a-b348-4d3b1122bf83","403":"327b0e59-2adb-4d52-bcac-b5d8c4af58cc","422":"c1b343af-adba-4d54-9964-6ff4b16664c8"},"method":"post","type":"path","servers":["a156f669-3682-47c8-9a38-4eed9fad3d1d","6b9b78d2-d2d0-4c3a-a14d-6ca2f837758d"],"security":["fef72ad2-c58f-489e-a143-1d8a70901848"],"path":"/api/payment-plans","baseUrlOptions":["https://coreapi.io","https://preview.coreapi.io"],"title":"Create a payment plan","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","php"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Send EITHER installments OR split, never both and never neither.","properties":{"invoiceId":{"type":"string","format":"uuid","description":"The open, finalized invoice to split.","example":"10000000-0000-0000-0003-000000000001","isRequired":true,"uniqueKey":"invoiceId","typeLabel":"string\u003cuuid>"},"paymentMethodId":{"oneOf":[{"type":"string","format":"uuid","description":"Payment method used for direct-debit collection. Defaults to the invoice payment method, with the customer default as fallback. Must belong to the invoice customer.","example":null,"uniqueKey":"paymentMethodId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"Payment method used for direct-debit collection. Defaults to the invoice payment method, with the customer default as fallback. Must belong to the invoice customer.","example":null,"uniqueKey":"paymentMethodId.oneOf.1","typeLabel":"null"}],"uniqueKey":"paymentMethodId","typeLabel":"string\u003cuuid> | null"},"installments":{"type":"array","description":"Manual mode. Explicit installments with due dates and amounts, in ascending order, summing to the open amount in cents.","items":{"type":"object","description":"One installment in manual mode.","properties":{"dueAt":{"type":"string","format":"date","description":"Due date of the installment (Y-m-d). Must lie in the future and be strictly after the previous installment.","example":"2026-08-05","isRequired":true,"uniqueKey":"installments.items.[INDEX].dueAt","typeLabel":"string\u003cdate>"},"amount":{"type":"integer","description":"Installment amount in the smallest currency unit (cents). Must be positive.","example":595,"isRequired":true,"uniqueKey":"installments.items.[INDEX].amount","typeLabel":"integer"}},"required":["dueAt","amount"],"uniqueKey":"installments.items.[INDEX]","typeLabel":"object"},"uniqueKey":"installments","typeLabel":"object[]"},"split":{"type":"object","description":"Even split of the open amount into a number of installments.","properties":{"count":{"type":"integer","minimum":2,"maximum":36,"description":"Number of installments to create.","example":3,"isRequired":true,"uniqueKey":"split.count","typeLabel":"integer"},"firstDueAt":{"type":"string","format":"date","description":"Due date of the first installment (Y-m-d). Must lie in the future.","example":"2026-08-05","isRequired":true,"uniqueKey":"split.firstDueAt","typeLabel":"string\u003cdate>"},"interval":{"type":"string","description":"Distance between due dates as {n}{D|W|M|Y}, for example 1M for one month. Defaults to 1M.","pattern":"^[0-9]+[DWMY]$","default":"1M","example":"1M","uniqueKey":"split.interval","typeLabel":"string"}},"required":["count","firstDueAt"],"uniqueKey":"split","typeLabel":"object"},"sendEmail":{"type":"boolean","default":true,"description":"Whether the customer receives the schedule-overview email when the plan is created. Set false to create the plan silently.","uniqueKey":"sendEmail","typeLabel":"boolean"}},"required":["invoiceId"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"invoiceId":"10000000-0000-0000-0003-000000000001","paymentMethodId":null,"installments":[{"dueAt":"2026-08-05","amount":595}],"sendEmail":true}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"b6297412-b0ca-4fc1-ae7f-9c70ece12da4":{"description":"The created payment plan.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"10000000-0000-0000-00e0-000000000001","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"invoiceId":{"type":"string","format":"uuid","example":"10000000-0000-0000-0003-000000000001","isRequired":true,"uniqueKey":"invoiceId","typeLabel":"string\u003cuuid>"},"status":{"type":"string","description":"Lifecycle status of a payment plan.","enum":["active","completed","broken","canceled"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"totalAmount":{"type":"integer","description":"Sum of all installments in cents. Equals the open amount at creation.","example":1190,"isRequired":true,"uniqueKey":"totalAmount","typeLabel":"integer"},"currencyCode":{"type":"string","example":"EUR","isRequired":true,"uniqueKey":"currencyCode","typeLabel":"string"},"paymentMethodId":{"oneOf":[{"type":"string","format":"uuid","example":"10000000-0000-0000-004f-000000000001","isRequired":true,"uniqueKey":"paymentMethodId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","example":"10000000-0000-0000-004f-000000000001","isRequired":true,"uniqueKey":"paymentMethodId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"paymentMethodId","typeLabel":"string\u003cuuid> | null"},"createdAt":{"type":"string","format":"date-time","example":"2026-07-05T16:20:00+00:00","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"completedAt":{"oneOf":[{"type":"string","format":"date-time","description":"Timestamp the plan completed (all installments paid), or null.","example":null,"isRequired":true,"uniqueKey":"completedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Timestamp the plan completed (all installments paid), or null.","example":null,"isRequired":true,"uniqueKey":"completedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"completedAt","typeLabel":"string\u003cdate-time> | null"},"brokenAt":{"oneOf":[{"type":"string","format":"date-time","description":"Timestamp the plan broke, or null.","example":null,"isRequired":true,"uniqueKey":"brokenAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Timestamp the plan broke, or null.","example":null,"isRequired":true,"uniqueKey":"brokenAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"brokenAt","typeLabel":"string\u003cdate-time> | null"},"canceledAt":{"oneOf":[{"type":"string","format":"date-time","description":"Timestamp the plan was canceled, or null.","example":null,"isRequired":true,"uniqueKey":"canceledAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Timestamp the plan was canceled, or null.","example":null,"isRequired":true,"uniqueKey":"canceledAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"canceledAt","typeLabel":"string\u003cdate-time> | null"},"brokenReason":{"oneOf":[{"type":"string","description":"Reason the plan broke, or null while active.","example":null,"isRequired":true,"uniqueKey":"brokenReason.oneOf.0","typeLabel":"string"},{"type":"null","description":"Reason the plan broke, or null while active.","example":null,"isRequired":true,"uniqueKey":"brokenReason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"brokenReason","typeLabel":"string | null"},"installments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"installments.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"position":{"type":"integer","description":"1-based position within the plan.","example":1,"isRequired":true,"uniqueKey":"installments.items.[INDEX].position","typeLabel":"integer"},"dueAt":{"type":"string","format":"date","description":"Due date (Y-m-d).","example":"2026-08-05","isRequired":true,"uniqueKey":"installments.items.[INDEX].dueAt","typeLabel":"string\u003cdate>"},"amount":{"type":"integer","description":"Installment amount in cents.","example":595,"isRequired":true,"uniqueKey":"installments.items.[INDEX].amount","typeLabel":"integer"},"status":{"type":"string","description":"Status of a single installment.","enum":["open","collecting","paid","failed"],"isRequired":true,"uniqueKey":"installments.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"paidAt":{"oneOf":[{"type":"string","format":"date-time","description":"Timestamp the installment was fully covered (ISO 8601), or null.","example":null,"isRequired":true,"uniqueKey":"installments.items.[INDEX].paidAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Timestamp the installment was fully covered (ISO 8601), or null.","example":null,"isRequired":true,"uniqueKey":"installments.items.[INDEX].paidAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"installments.items.[INDEX].paidAt","typeLabel":"string\u003cdate-time> | null"}},"required":["id","position","dueAt","amount","status","paidAt"],"uniqueKey":"installments.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"installments","typeLabel":"object[]"}},"required":["id","invoiceId","status","totalAmount","currencyCode","paymentMethodId","createdAt","completedAt","brokenAt","canceledAt","brokenReason","installments"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"10000000-0000-0000-00e0-000000000001","invoiceId":"10000000-0000-0000-0003-000000000001","status":"active","totalAmount":1190,"currencyCode":"EUR","paymentMethodId":"10000000-0000-0000-004f-000000000001","createdAt":"2026-07-05T16:20:00+00:00","completedAt":null,"brokenAt":null,"canceledAt":null,"brokenReason":null,"installments":[{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","position":1,"dueAt":"2026-08-05","amount":595,"status":"open","paidAt":null}]}}},"exampleType":"generated"}},"exampleType":"generated"},"77eaf985-b527-440a-b348-4d3b1122bf83":{"description":"Authentication is missing or the token is invalid.","content":{"application/problem+json":{"schema":{"type":"object","description":"Problem detail error body (application/problem+json). Additional members may be present depending on the error.","properties":{"status":{"type":"integer","example":422,"isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"type":{"type":"string","description":"Stable machine readable error key.","example":"PAYMENT_PLAN__SUM_MISMATCH","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"title":{"type":"string","example":"An error occurred","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"detail":{"type":"string","example":"The installments must sum to the open amount of the invoice.","isRequired":true,"uniqueKey":"detail","typeLabel":"string"}},"required":["status","type","title","detail"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":422,"type":"PAYMENT_PLAN__SUM_MISMATCH","title":"An error occurred","detail":"The installments must sum to the open amount of the invoice."}}},"exampleType":"generated"}},"exampleType":"generated"},"327b0e59-2adb-4d52-bcac-b5d8c4af58cc":{"description":"The token is valid but lacks the required permission.","content":{"application/problem+json":{"schema":{"type":"object","description":"Problem detail error body (application/problem+json). Additional members may be present depending on the error.","properties":{"status":{"type":"integer","example":422,"isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"type":{"type":"string","description":"Stable machine readable error key.","example":"PAYMENT_PLAN__SUM_MISMATCH","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"title":{"type":"string","example":"An error occurred","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"detail":{"type":"string","example":"The installments must sum to the open amount of the invoice.","isRequired":true,"uniqueKey":"detail","typeLabel":"string"}},"required":["status","type","title","detail"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":422,"type":"PAYMENT_PLAN__SUM_MISMATCH","title":"An error occurred","detail":"The installments must sum to the open amount of the invoice."}}},"exampleType":"generated"}},"exampleType":"generated"},"c1b343af-adba-4d54-9964-6ff4b16664c8":{"description":"The request failed validation or a business rule was violated.","content":{"application/problem+json":{"schema":{"oneOf":[{"type":"object","description":"Validation error body (application/problem+json) returned when input fails field level validation.","required":["status","type","title","violations"],"properties":{"status":{"type":"integer","example":422,"isRequired":true,"uniqueKey":"oneOf.0.status","typeLabel":"integer"},"type":{"type":"string","example":"https://tools.ietf.org/html/rfc2616#section-10","isRequired":true,"uniqueKey":"oneOf.0.type","typeLabel":"string"},"title":{"type":"string","example":"Validation Failed","isRequired":true,"uniqueKey":"oneOf.0.title","typeLabel":"string"},"violations":{"type":"array","items":{"type":"object","properties":{"propertyPath":{"type":"string","example":"installments[0].amount","uniqueKey":"oneOf.0.violations.items.[INDEX].propertyPath","typeLabel":"string"},"message":{"type":"string","example":"This value should be positive.","uniqueKey":"oneOf.0.violations.items.[INDEX].message","typeLabel":"string"},"code":{"oneOf":[{"type":"string","uniqueKey":"oneOf.0.violations.items.[INDEX].code.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"oneOf.0.violations.items.[INDEX].code.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.violations.items.[INDEX].code","typeLabel":"string | null"}},"uniqueKey":"oneOf.0.violations.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.0.violations","typeLabel":"object[]"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"Problem detail error body (application/problem+json). Additional members may be present depending on the error.","required":["status","type","title","detail"],"properties":{"status":{"type":"integer","example":422,"isRequired":true,"uniqueKey":"oneOf.1.status","typeLabel":"integer"},"type":{"type":"string","description":"Stable machine readable error key.","example":"PAYMENT_PLAN__SUM_MISMATCH","isRequired":true,"uniqueKey":"oneOf.1.type","typeLabel":"string"},"title":{"type":"string","example":"An error occurred","isRequired":true,"uniqueKey":"oneOf.1.title","typeLabel":"string"},"detail":{"type":"string","example":"The installments must sum to the open amount of the invoice.","isRequired":true,"uniqueKey":"oneOf.1.detail","typeLabel":"string"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":422,"type":"https://tools.ietf.org/html/rfc2616#section-10","title":"Validation Failed","violations":[{"propertyPath":"installments[0].amount","message":"This value should be positive.","code":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"fef72ad2-c58f-489e-a143-1d8a70901848":{"ApiToken":{"type":"http","scheme":"bearer","description":"Organisation API token. Send it as Authorization: Bearer api_... The token is scoped to a single Organisation. Reading a plan needs the invoice read permission, creating, canceling and extending need the invoice write permission.","scopes":[]}}},"servers":{"a156f669-3682-47c8-9a38-4eed9fad3d1d":{"url":"https://coreapi.io","description":"Production"},"6b9b78d2-d2d0-4c3a-a14d-6ca2f837758d":{"url":"https://preview.coreapi.io","description":"Sandbox"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Organisation API token. Send it as Authorization: Bearer api_... The token is scoped to a single Organisation. Reading a plan needs the invoice read permission, creating, canceling and extending need the invoice write permission.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Organisation API token. Send it as Authorization: Bearer api_... The token is scoped to a single Organisation. Reading a plan needs the invoice read permission, creating, canceling and extending need the invoice write permission.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiToken","name":"Authorization"}],"title":"ApiToken"}]},"originalFileLocation":"assets/openapi-v2-payment-plans.json"},"subdomain":"fynnsubscriptionbilling","siteName":"Fynn Docs","title":"Create a payment plan - Fynn Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"de":{"href":"/v2-payment-plans-api/payment-plans/create-payment-plan","matchLevel":0},"en":{"href":"/en/introduction","matchLevel":4}}},"lastModified":"2026-07-06T07:44:30.437Z","originalFileLocation":"v2-payment-plans-api/payment-plans/create-payment-plan.mdx","locale":"de"},"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=\"Split an open, finalized invoice into installments. Send EITHER an explicit installments array OR a split object, never both and never neither. The installment amounts (or the computed split) must sum to the current open amount of the invoice in cents. In split mode the rounding remainder is added to the last installment. The invoice must be finalized and open (not draft, paid, canceled or refunded) and must not already have an active plan. While the plan is active, dunning for the invoice is paused.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Fynn Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/fynnsubscriptionbilling/aEyoysRsbJwnVfa3/_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/fynnsubscriptionbilling/aEyoysRsbJwnVfa3/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fynnsubscriptionbilling/aEyoysRsbJwnVfa3/_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/fynnsubscriptionbilling/aEyoysRsbJwnVfa3/_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/fynnsubscriptionbilling/aEyoysRsbJwnVfa3/_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/fynnsubscriptionbilling/aEyoysRsbJwnVfa3/_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/fynnsubscriptionbilling/aEyoysRsbJwnVfa3/_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/fynnsubscriptionbilling/aEyoysRsbJwnVfa3/_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/fynnsubscriptionbilling/aEyoysRsbJwnVfa3/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a payment plan - Fynn Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Split an open, finalized invoice into installments. Send EITHER an explicit installments array OR a split object, never both and never neither. The installment amounts (or the computed split) must sum to the current open amount of the invoice in cents. In split mode the rounding remainder is added to the last installment. The invoice must be finalized and open (not draft, paid, canceled or refunded) and must not already have an active plan. While the plan is active, dunning for the invoice is paused.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Fynn Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.fynn.eu/v2-payment-plans-api/payment-plans/create-payment-plan\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://fynnsubscriptionbilling.mintlify.app/_mintlify/api/og/v2?division=Zahlungsplan-Verwaltung\u0026amp;title=Create+a+payment+plan\u0026amp;description=Split+an+open%2C+finalized+invoice+into+installments.+Send+EITHER+an+explicit+%60installments%60+array+OR+a+%60split%60+object%2C+never+both+and+never+neither.+The+installm\u0026amp;theme=4b76c1a49202070b198dd6e7\u0026amp;signature=d9022df81ffae083b78c510281bd5c15c64b53b949f67e6050ea34fbf0b57629\">\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 payment plan - Fynn Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Split an open, finalized invoice into installments. Send EITHER an explicit installments array OR a split object, never both and never neither. The installment amounts (or the computed split) must sum to the current open amount of the invoice in cents. In split mode the rounding remainder is added to the last installment. The invoice must be finalized and open (not draft, paid, canceled or refunded) and must not already have an active plan. While the plan is active, dunning for the invoice is paused.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://fynnsubscriptionbilling.mintlify.app/_mintlify/api/og/v2?division=Zahlungsplan-Verwaltung\u0026amp;title=Create+a+payment+plan\u0026amp;description=Split+an+open%2C+finalized+invoice+into+installments.+Send+EITHER+an+explicit+%60installments%60+array+OR+a+%60split%60+object%2C+never+both+and+never+neither.+The+installm\u0026amp;theme=4b76c1a49202070b198dd6e7\u0026amp;signature=d9022df81ffae083b78c510281bd5c15c64b53b949f67e6050ea34fbf0b57629\">\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/fynnsubscriptionbilling/aEyoysRsbJwnVfa3/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Fynn Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.fynn.eu/v2-payment-plans-api/payment-plans/create-payment-plan\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/v2-payment-plans-api/payment-plans/create-payment-plan.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.fynn.eu/#organization\",\"name\":\"Fynn Docs\",\"url\":\"https://docs.fynn.eu\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/fynnsubscriptionbilling/kPbBeWVEZfmEic9q/logo/logo-dark.svg?fit=max\u0026auto=format\u0026n=kPbBeWVEZfmEic9q\u0026q=85\u0026s=83e4b30a53d77c3809e0f22afa29335d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.fynn.eu#website\",\"name\":\"Fynn Docs\",\"url\":\"https://docs.fynn.eu\",\"publisher\":{\"@id\":\"https://docs.fynn.eu/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.fynn.eu/v2-payment-plans-api/payment-plans/create-payment-plan#webpage\",\"url\":\"https://docs.fynn.eu/v2-payment-plans-api/payment-plans/create-payment-plan\",\"name\":\"Create a payment plan\",\"description\":\"Split an open, finalized invoice into installments. Send EITHER an explicit installments array OR a split object, never both and never neither. The installment amounts (or the computed split) must sum to the current open amount of the invoice in cents. In split mode the rounding remainder is added to the last installment. The invoice must be finalized and open (not draft, paid, canceled or refunded) and must not already have an active plan. While the plan is active, dunning for the invoice is paused.\",\"dateModified\":\"2026-07-06T07:44:30.437Z\",\"isPartOf\":{\"@id\":\"https://docs.fynn.eu#website\"},\"breadcrumb\":{\"@id\":\"https://docs.fynn.eu/v2-payment-plans-api/payment-plans/create-payment-plan#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.fynn.eu/v2-payment-plans-api/payment-plans/create-payment-plan#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Zahlungspläne\",\"item\":\"https://docs.fynn.eu/v2-payment-plans-api/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a payment plan\",\"item\":\"https://docs.fynn.eu/v2-payment-plans-api/payment-plans/create-payment-plan\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.fynn.eu/v2-payment-plans-api/payment-plans/create-payment-plan#apireference\",\"headline\":\"Create a payment plan\",\"name\":\"Create a payment plan\",\"description\":\"Split an open, finalized invoice into installments. Send EITHER an explicit installments array OR a split object, never both and never neither. The installment amounts (or the computed split) must sum to the current open amount of the invoice in cents. In split mode the rounding remainder is added to the last installment. The invoice must be finalized and open (not draft, paid, canceled or refunded) and must not already have an active plan. While the plan is active, dunning for the invoice is paused.\",\"url\":\"https://docs.fynn.eu/v2-payment-plans-api/payment-plans/create-payment-plan\",\"mainEntityOfPage\":{\"@id\":\"https://docs.fynn.eu/v2-payment-plans-api/payment-plans/create-payment-plan#webpage\"},\"dateModified\":\"2026-07-06T07:44:30.437Z\",\"publisher\":{\"@id\":\"https://docs.fynn.eu/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.fynn.eu#website\"}}]}\u003c/script>","siteName":"Fynn Docs","nav":{"global":null,"languages":[{"language":"de","default":true,"tabs":[{"tab":"Dokumentation","pages":[{"title":"Dokumentation","href":"/introduction"}]},{"tab":"Integrationen","pages":[{"title":"Integrationen","href":"/integrations/overview"}]},{"tab":"API Referenz","pages":[{"title":"API Referenz","href":"/api-reference/introduction"}]},{"tab":"API V2","groups":[{"group":"Einführung","icon":"compass","pages":[{"title":"Fynn API V2","sidebarTitle":"Einführung","icon":"compass","href":"/v2-plans-api/introduction"}]},{"group":"Grundlagen","icon":"cube","pages":[{"title":"Authentifizierung","sidebarTitle":"Authentifizierung","icon":"key","href":"/v2-plans-api/authentication"},{"title":"Asynchrone Abrechnung","sidebarTitle":"Asynchrone Abrechnung","icon":"receipt","href":"/v2-plans-api/billing"}]},{"group":"Pläne","icon":"layer-group","pages":[{"title":"Schnellstart","sidebarTitle":"Schnellstart","icon":"rocket","href":"/v2-plans-api/quickstart"},{"title":"Kernkonzepte","sidebarTitle":"Kernkonzepte","icon":"book","href":"/v2-plans-api/concepts"},{"title":"Up- und Downgrades","sidebarTitle":"Up- und Downgrades","icon":"arrow-up-arrow-down","href":"/v2-plans-api/upgrades-downgrades"},{"title":"Checkout","sidebarTitle":"Checkout","icon":"cart-shopping","href":"/v2-plans-api/checkout-and-sales-channels"},{"group":"API","pages":[{"group":"Plan-Verwaltung","pages":[{"openapi":"get /api/plans","title":"List plans","href":"/v2-plans-api/plans/list-plans"},{"openapi":"post /api/plans","title":"Create a plan","href":"/v2-plans-api/plans/create-plan"},{"openapi":"get /api/plans/{id}","title":"Retrieve a plan","href":"/v2-plans-api/plans/get-plan"},{"openapi":"put /api/plans/{id}","title":"Update a plan","href":"/v2-plans-api/plans/update-plan"},{"openapi":"post /api/plans/{id}/activate","title":"Activate a plan","href":"/v2-plans-api/plans/activate-plan"},{"openapi":"delete /api/plans/{id}","title":"Delete or archive a plan","href":"/v2-plans-api/plans/delete-plan"}]},{"group":"Checkout-Links","pages":[{"openapi":"post /api/plans/{id}/checkout-links","title":"Create a checkout link","href":"/v2-plans-api/checkout-links/create-checkout-link"},{"openapi":"get /api/plans/{id}/checkout-links","title":"List checkout links of a plan","href":"/v2-plans-api/checkout-links/list-checkout-links"}]},{"group":"Tarifwechsel","pages":[{"openapi":"get /api/customer/subscriptions/{id}/plan-options","title":"Get plan switch options","href":"/v2-plans-api/customer/plan-options"},{"openapi":"post /api/customer/subscriptions/{id}/plan-tier-preview","title":"Preview a tier switch","href":"/v2-plans-api/customer/preview-plan-tier-switch"},{"openapi":"post /api/customer/subscriptions/{id}/switch-plan-tier","title":"Switch the plan tier","href":"/v2-plans-api/customer/switch-plan-tier"}]}]}]},{"group":"Angebote","icon":"file-signature","pages":[{"title":"Angebote","sidebarTitle":"Einführung","icon":"file-signature","href":"/v2-offers-api/introduction"},{"title":"Schnellstart","sidebarTitle":"Schnellstart","icon":"rocket","href":"/v2-offers-api/quickstart"},{"title":"Kernkonzepte","sidebarTitle":"Kernkonzepte","icon":"book","href":"/v2-offers-api/concepts"},{"title":"Der Angebots-Editor","sidebarTitle":"Der Editor","icon":"pen-ruler","href":"/v2-offers-api/editor"},{"title":"Die Angebots-Ansicht","sidebarTitle":"Angebots-Ansicht","icon":"eye","href":"/v2-offers-api/angebots-ansicht"},{"title":"Annahme und Signatur","sidebarTitle":"Annahme und Signatur","icon":"file-signature","href":"/v2-offers-api/acceptance-and-signing"},{"title":"Rechnungsdaten","sidebarTitle":"Rechnungsdaten","icon":"receipt","href":"/v2-offers-api/billing-details"},{"title":"Veröffentlichen und Empfänger","sidebarTitle":"Veröffentlichen","icon":"paper-plane","href":"/v2-offers-api/sending-and-recipients"},{"title":"Freigaben","sidebarTitle":"Freigaben","icon":"circle-check","href":"/v2-offers-api/freigaben"},{"title":"Einstellungen","sidebarTitle":"Einstellungen","icon":"gear","href":"/v2-offers-api/settings"},{"title":"Authentifizierung","sidebarTitle":"Authentifizierung","icon":"key","href":"/v2-offers-api/authentication"},{"title":"Webhooks","sidebarTitle":"Webhooks","icon":"bell","href":"/v2-offers-api/webhooks"},{"group":"API","pages":[{"group":"Angebote","pages":[{"openapi":"assets/openapi-v2-offers.json get /offers","title":"List offers","href":"/v2-offers-api/offers/list-offers"},{"openapi":"assets/openapi-v2-offers.json get /api/offers/{id}","title":"Get an offer","href":"/v2-offers-api/offers/get-offer"},{"openapi":"assets/openapi-v2-offers.json put /offers/{id}","title":"Update an offer","href":"/v2-offers-api/offers/update-offer"},{"openapi":"assets/openapi-v2-offers.json get /offers/{id}/document","title":"Download an offer as PDF","href":"/v2-offers-api/offers/download-offer"},{"openapi":"assets/openapi-v2-offers.json post /api/offers/{id}/publish","title":"Publish an offer","href":"/v2-offers-api/offers/publish-offer"},{"openapi":"assets/openapi-v2-offers.json post /api/offers/{id}/accept","title":"Accept an offer manually","href":"/v2-offers-api/offers/accept-offer"},{"openapi":"assets/openapi-v2-offers.json post /offers/{id}/cancel-signing","title":"Cancel a signing process","href":"/v2-offers-api/offers/cancel-signing"},{"openapi":"assets/openapi-v2-offers.json post /offers/{id}/recipients","title":"Add a recipient","href":"/v2-offers-api/offers/add-recipient"},{"openapi":"assets/openapi-v2-offers.json get /api/offers/{id}/activities","title":"List offer activity","href":"/v2-offers-api/offers/list-activities"},{"openapi":"assets/openapi-v2-offers.json delete /offers/{id}","title":"Archive an offer","href":"/v2-offers-api/offers/archive-offer"}]},{"group":"Freigabe","pages":[{"openapi":"assets/openapi-v2-offers.json get /api/offers/{id}/approval","title":"Get the approval state","href":"/v2-offers-api/approval/get-approval"},{"openapi":"assets/openapi-v2-offers.json post /api/offers/{id}/approval/approve","title":"Approve a pending request","href":"/v2-offers-api/approval/approve"},{"openapi":"assets/openapi-v2-offers.json post /api/offers/{id}/approval/reject","title":"Reject a pending request","href":"/v2-offers-api/approval/reject"},{"openapi":"assets/openapi-v2-offers.json post /api/offers/{id}/approval/cancel","title":"Cancel a pending request","href":"/v2-offers-api/approval/cancel-approval"}]}]}]},{"group":"Finanzberichte","icon":"chart-line","pages":[{"title":"Finanzberichte: Konzepte","sidebarTitle":"Konzepte","icon":"book","href":"/v2-finance-api/concepts"},{"title":"Datensätze","sidebarTitle":"Datensätze","icon":"table","href":"/v2-finance-api/datasets"},{"title":"Drill-downs","sidebarTitle":"Drill-downs","icon":"magnifying-glass","href":"/v2-finance-api/drill-downs"},{"title":"Snapshots","sidebarTitle":"Snapshots","icon":"lock","href":"/v2-finance-api/snapshots"},{"title":"Excel-Exporte","sidebarTitle":"Excel-Exporte","icon":"file-excel","href":"/v2-finance-api/excel"},{"title":"Fehler","sidebarTitle":"Fehler","icon":"triangle-exclamation","href":"/v2-finance-api/errors"},{"title":"Definitionen","sidebarTitle":"Definitionen","icon":"book-open","href":"/v2-finance-api/definitions"},{"group":"API","pages":[{"group":"Datensätze","pages":[{"openapi":"assets/openapi-v2-finance.json get /api/analytics/finance/recurring","title":"Recurring revenue page datasets","href":"/v2-finance-api/datasets/get-recurring"},{"openapi":"assets/openapi-v2-finance.json get /api/analytics/finance/customers","title":"Customer base page datasets","href":"/v2-finance-api/datasets/get-customers"},{"openapi":"assets/openapi-v2-finance.json get /api/analytics/finance/liquidity","title":"Liquidity page datasets","href":"/v2-finance-api/datasets/get-liquidity"},{"openapi":"assets/openapi-v2-finance.json get /api/analytics/finance/revenue","title":"Revenue page datasets","href":"/v2-finance-api/datasets/get-revenue"},{"openapi":"assets/openapi-v2-finance.json get /api/analytics/finance/revenue/customers","title":"Revenue per customer, paged","href":"/v2-finance-api/datasets/get-revenue-customers"},{"openapi":"assets/openapi-v2-finance.json get /api/analytics/finance/overview","title":"Finance overview datasets","href":"/v2-finance-api/datasets/get-overview"},{"openapi":"assets/openapi-v2-finance.json get /api/analytics/mrr-financials","title":"MRR financials table","href":"/v2-finance-api/datasets/get-mrr-table"}]},{"group":"Drill-downs und Hinweise","pages":[{"openapi":"assets/openapi-v2-finance.json get /api/analytics/mrr-financials/details","title":"Lines behind one cell of the finance tables","href":"/v2-finance-api/drill-downs/get-details"},{"openapi":"assets/openapi-v2-finance.json get /api/analytics/mrr-financials/findings","title":"Data-quality findings of the MRR calculation","href":"/v2-finance-api/drill-downs/list-findings"},{"openapi":"assets/openapi-v2-finance.json get /api/analytics/mrr-financials/findings/{id}","title":"One data-quality finding with its explanation","href":"/v2-finance-api/drill-downs/get-finding"}]},{"group":"Snapshots","pages":[{"openapi":"assets/openapi-v2-finance.json get /api/analytics/finance/snapshots","title":"Month-end MRR snapshots","href":"/v2-finance-api/snapshots/list-snapshots"},{"openapi":"assets/openapi-v2-finance.json post /api/analytics/finance/snapshots","title":"Take a month-end MRR snapshot again","href":"/v2-finance-api/snapshots/take-snapshot"},{"openapi":"assets/openapi-v2-finance.json get /api/analytics/finance/snapshots/{month}/{version}","title":"Frozen MRR figures of a snapshot","href":"/v2-finance-api/snapshots/get-snapshot"}]},{"group":"Excel-Exporte","pages":[{"openapi":"assets/openapi-v2-finance.json get /api/analytics/finance/recurring/excel","title":"Export the recurring revenue page as XLSX","href":"/v2-finance-api/excel/export-recurring"},{"openapi":"assets/openapi-v2-finance.json get /api/analytics/finance/customers/excel","title":"Export the customer base page as XLSX","href":"/v2-finance-api/excel/export-customers"},{"openapi":"assets/openapi-v2-finance.json get /api/analytics/finance/liquidity/excel","title":"Export the liquidity page as XLSX","href":"/v2-finance-api/excel/export-liquidity"},{"openapi":"assets/openapi-v2-finance.json get /api/analytics/finance/revenue/excel","title":"Export the revenue page as XLSX","href":"/v2-finance-api/excel/export-revenue"},{"openapi":"assets/openapi-v2-finance.json get /api/analytics/mrr-financials/export/excel","title":"Export the MRR financials as XLSX","href":"/v2-finance-api/excel/export-mrr-table"},{"openapi":"assets/openapi-v2-finance.json get /api/analytics/mrr-financials/findings/export/excel","title":"Export the data-quality findings as XLSX","href":"/v2-finance-api/excel/export-findings"}]},{"group":"Definitionen","pages":[{"openapi":"assets/openapi-v2-finance.json get /api/analytics/finance/definitions","title":"Read the finance definitions catalogue","href":"/v2-finance-api/definitions/get-definitions"}]},{"group":"Einstellungen","pages":[{"openapi":"assets/openapi-v2-finance.json get /api/analytics/mrr-financials/settings","title":"Read the finance settings","href":"/v2-finance-api/settings/get-settings"},{"openapi":"assets/openapi-v2-finance.json patch /api/analytics/mrr-financials/settings","title":"Update the finance settings","href":"/v2-finance-api/settings/update-settings"}]}]}]},{"group":"Provisionen","icon":"percent","pages":[{"title":"Provisionen API","sidebarTitle":"Einführung","icon":"percent","href":"/v2-commission-api/introduction"},{"title":"Kernkonzepte","sidebarTitle":"Kernkonzepte","icon":"book","href":"/v2-commission-api/concepts"},{"group":"API","pages":[{"group":"Provisionspläne","pages":[{"openapi":"assets/openapi-v2-commission.json get /api/commissions/plans","title":"List commission plans","href":"/v2-commission-api/plans/list-plans"},{"openapi":"assets/openapi-v2-commission.json post /api/commissions/plans","title":"Create a commission plan","href":"/v2-commission-api/plans/create-plan"},{"openapi":"assets/openapi-v2-commission.json get /api/commissions/plans/{id}","title":"Get a commission plan","href":"/v2-commission-api/plans/get-plan"},{"openapi":"assets/openapi-v2-commission.json put /api/commissions/plans/{id}","title":"Update a commission plan","href":"/v2-commission-api/plans/update-plan"},{"openapi":"assets/openapi-v2-commission.json delete /api/commissions/plans/{id}","title":"Delete a commission plan","href":"/v2-commission-api/plans/delete-plan"}]}]}]},{"group":"Zahlungspläne","icon":"calendar-days","pages":[{"title":"Zahlungsplan API","sidebarTitle":"Einführung","icon":"calendar-days","href":"/v2-payment-plans-api/introduction"},{"title":"Schnellstart","sidebarTitle":"Schnellstart","icon":"rocket","href":"/v2-payment-plans-api/quickstart"},{"title":"Kernkonzepte","sidebarTitle":"Kernkonzepte","icon":"book","href":"/v2-payment-plans-api/concepts"},{"title":"Webhooks","description":"Lass dein System in Echtzeit über den Lebenszyklus eines Zahlungsplans benachrichtigen. Aufbau des Envelopes, verfügbare Events und Beispiel-Payloads.","sidebarTitle":"Webhooks","icon":"bell","href":"/v2-payment-plans-api/webhooks"},{"group":"API","pages":[{"group":"Zahlungsplan-Verwaltung","pages":[{"openapi":"assets/openapi-v2-payment-plans.json post /api/payment-plans","title":"Create a payment plan","href":"/v2-payment-plans-api/payment-plans/create-payment-plan"},{"openapi":"assets/openapi-v2-payment-plans.json get /api/payment-plans/{id}","title":"Get a payment plan","description":"Return a single payment plan with its installments.","href":"/v2-payment-plans-api/payment-plans/get-payment-plan"},{"openapi":"assets/openapi-v2-payment-plans.json get /api/invoices/{id}/payment-plan","title":"Get the payment plan of an invoice","href":"/v2-payment-plans-api/payment-plans/get-invoice-payment-plan"},{"openapi":"assets/openapi-v2-payment-plans.json post /api/payment-plans/{id}/cancel","title":"Cancel a payment plan","href":"/v2-payment-plans-api/payment-plans/cancel-payment-plan"},{"openapi":"assets/openapi-v2-payment-plans.json post /api/payment-plans/{id}/extend","title":"Extend a payment plan","href":"/v2-payment-plans-api/payment-plans/extend-payment-plan"}]}]}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/2026-07"}]}]},{"language":"en","pages":[{"title":"en","href":"/en/introduction"}]}]},"basePath":"","title":"Create a payment plan - Fynn Docs","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DX1Meug0.js","utils-B_OMIQVC.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChxhRPMa.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CuKvD8Iv.js","snippetPresets-C5d7p2hp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","Page-BAvA99GL.js","getPastedJson-bz0M41mU.js","icon-CsmhpPrv.js","MethodPill-CNGsVE77.js","DuplicateIcon-DilfU_Z2.js","createIcon-BdsYzQck.js","DynamicMarkdown-CbqEDjbV.js","SectionHeading-O6hXpFCN.js","axios-vUo_bRtp.js","Markdown-nKm-uidQ.js","clsx-ClVdStUn.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CIQkMg3R.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ImrFS4Fy.js"]}