Augmenter ou réduire la quantité d’une ligne, et ce qu’il advient du prorata.
C’est la seule modification possible sur un abonnement existant. Il n’y a pas de changement
de prix, ni d’ajout ou de retrait de ligne : pour cela, annulez et recréez.
PUT /v1/subscriptions/{id}/quantity
Champ
Obligatoire
Description
itemId
Oui
La ligne (si_…), lue dans items[] de l’abonnement.
La quantité est mise à jour immédiatement : le prochain cycle est facturé sur la nouvelle
quantité. Ce qui se passe pour le cycle en cours dépend de l’état :
État
En cours de période ?
Effet sur le cycle en cours
trialing
—
Aucun. Rien n’est facturé pendant l’essai.
active
Non (à la borne exacte)
Aucun.
active, hausse
Oui
Un prorata est calculé au temps restant, et une facture de prorata (billingReason: "proration") est créée en open.
active, baisse
Oui
Un prorata négatif est calculé et rendu dans la réponse, mais aucun avoir n’est écrit — rien ne sera déduit du prochain cycle.
La facture de prorata n’est jamais prélevée automatiquement. Elle est créée open, sans
numéro, sans envoi d’e-mail et sans lien de paiement, et aucune demande de paiement ne part.
Elle apparaît dans GET /v1/subscriptions/{id}/invoices. Si vous voulez encaisser le prorata,
c’est à vous de le facturer par un autre moyen ; si vous ne le voulez pas, ignorez-la.
Une baisse en cours de période ne crédite rien. Le message de réponse annonce un crédit
« sur la prochaine facture » ; ce crédit n’est pas implémenté. Le client paie le cycle en cours
sur l’ancienne quantité, et le suivant sur la nouvelle.
prorationAmount et prorationInvoice sont absents quand aucun prorata ne s’applique.
prorationAmount est négatif sur une baisse (sans prorationInvoice).
Ce changement n’émet aucun webhook — ni subscription.updated, ni invoice.*. Il est
consigné dans l’historique interne de l’abonnement (events[] du détail, type
quantity_updated).
Statut autre que active/trialing, ou itemId qui n’appartient pas à cet abonnement. Le message est générique.
404
E_SUBSCRIPTION_NOT_FOUND
Inconnu ou d’un autre compte.
Cette page vous a-t-elle été utile ?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Yabetoo Docs","colors":{"primary":"#001C6B","light":"#FF5224","dark":"#001C6B"},"logo":{"light":"https://mintcdn.com/yabetoo/GKcRe5bQmORW4fP9/logo/yb_light.svg?fit=max\u0026auto=format\u0026n=GKcRe5bQmORW4fP9\u0026q=85\u0026s=ed73909855c175c18b2f36363a0e38d6","dark":"https://mintcdn.com/yabetoo/GKcRe5bQmORW4fP9/logo/yb_dark.svg?fit=max\u0026auto=format\u0026n=GKcRe5bQmORW4fP9\u0026q=85\u0026s=0ce17978eb927838c0b7e968857d9851"},"favicon":"https://mintcdn.com/yabetoo/GKcRe5bQmORW4fP9/fav.svg?fit=max\u0026auto=format\u0026n=GKcRe5bQmORW4fP9\u0026q=85\u0026s=e33b5183d8f41aed0d54edd9bb73bb7c","navbar":{"links":[{"href":"mailto:support@yabetoopay.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.yabetoo.com"}},"footer":{"socials":{"website":"https://yabetoopay.com/","facebook":"https://www.facebook.com/Yabetoopay","linkedin":"https://www.linkedin.com/company/yabetoopay"}},"search":{"prompt":"Search documentation..."},"fonts":{"heading":{"family":"Inter","weight":600},"body":{"family":"Inter","weight":400}},"styling":{"latex":false},"navigation":{"global":{"anchors":[]},"languages":[{"language":"fr","href":"fr/introduction"},{"language":"en","href":"en/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"yabetoo","hasAudioNarration":false,"actualSubdomain":"yabetoo","customDomains":["docs.yabetoopay.com"],"gitSource":{"type":"github","owner":"yabetoo","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adcdf01ae25711913672988","collectionId":"7caa16f3-a461-4361-881c-2ca13529d0f4","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adcdf01ae25711913672988"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6adcdf01ae25711913672988","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"en","tag":"API Reference","count":25},{"language":"fr","tag":"Référence API","count":25},{"language":"en","tag":"Subscriptions","count":19},{"language":"fr","tag":"Abonnements","count":19},{"language":"en","tag":"Connect","count":17},{"language":"fr","tag":"Connect","count":17},{"language":"en","tag":"Guides","count":15},{"language":"en","tag":"Payments","count":15},{"language":"fr","tag":"Guides","count":15},{"language":"fr","tag":"Paiements","count":15},{"language":"en","tag":"Get started","count":10},{"language":"en","tag":"Platforms \u0026 Marketplaces","count":10},{"language":"fr","tag":"Pour commencer","count":10},{"language":"fr","tag":"Plateformes \u0026 Marchés","count":10},{"language":"en","tag":"Resources","count":9},{"language":"en","tag":"Developer tools","count":9},{"language":"fr","tag":"Ressources","count":9},{"language":"fr","tag":"Outils développeur","count":9},{"language":"en","tag":"Case Studies","count":7},{"language":"fr","tag":"Études de cas","count":7}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"fr/subscriptions/manage/quantity","slug":"/fr/subscriptions/manage/quantity","pageMetadata":{"title":"Modifier la quantité","description":"Augmenter ou réduire la quantité d'une ligne, et ce qu'il advient du prorata.","icon":"sliders","href":"/fr/subscriptions/manage/quantity"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Augmenter ou réduire la quantité d’une ligne, et ce qu’il advient du prorata.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`C’est la `,_jsx(_components.strong,{children:`seule modification`}),` possible sur un abonnement existant. Il n’y a pas de changement\nde prix, ni d’ajout ou de retrait de ligne : pour cela, annulez et recréez.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`PUT`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` /v1/subscriptions/{id}/quantity`})]}),`\n`]})})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Champ`}),_jsx(_components.th,{children:`Obligatoire`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`itemId`})}),_jsx(_components.td,{children:`Oui`}),_jsxs(_components.td,{children:[`La ligne (`,_jsx(_components.code,{children:`si_…`}),`), lue dans `,_jsx(_components.code,{children:`items[]`}),` de l’abonnement.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`quantity`})}),_jsx(_components.td,{children:`Oui`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`1 à 1 000.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`reason`})}),_jsx(_components.td,{children:`Non`}),_jsx(_components.td,{children:`Texte libre, conservé dans l’historique.`})]})]})]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` PUT`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://buy.api.yabetoopay.com/v1/subscriptions/sub_.../quantity`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer sk_test_...\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{ \"itemId\": \"si_...\", \"quantity\": 3, \"reason\": \"two more seats\" }'`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Autorisé sur un abonnement `,_jsx(_components.code,{children:`active`}),` ou `,_jsx(_components.code,{children:`trialing`}),` seulement.`]}),`\n`,_jsx(Heading,{level:`2`,id:`ce-qui-se-passe`,children:`Ce qui se passe`}),`\n`,_jsxs(_components.p,{children:[`La quantité est mise à jour `,_jsx(_components.strong,{children:`immédiatement`}),` : le prochain cycle est facturé sur la nouvelle\nquantité. Ce qui se passe pour le cycle `,_jsx(_components.strong,{children:`en cours`}),` dépend de l’état :`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`État`}),_jsx(_components.th,{children:`En cours de période ?`}),_jsx(_components.th,{children:`Effet sur le cycle en cours`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`trialing`})}),_jsx(_components.td,{children:`—`}),_jsx(_components.td,{children:`Aucun. Rien n’est facturé pendant l’essai.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`active`})}),_jsx(_components.td,{children:`Non (à la borne exacte)`}),_jsx(_components.td,{children:`Aucun.`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`active`}),`, `,_jsx(_components.strong,{children:`hausse`})]}),_jsx(_components.td,{children:`Oui`}),_jsxs(_components.td,{children:[`Un prorata est calculé au temps restant, et une `,_jsx(_components.strong,{children:`facture de prorata`}),` (`,_jsx(_components.code,{children:`billingReason: \"proration\"`}),`) est créée en `,_jsx(_components.code,{children:`open`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`active`}),`, `,_jsx(_components.strong,{children:`baisse`})]}),_jsx(_components.td,{children:`Oui`}),_jsxs(_components.td,{children:[`Un prorata négatif est calculé et `,_jsx(_components.strong,{children:`rendu`}),` dans la réponse, mais `,_jsx(_components.strong,{children:`aucun avoir n’est écrit`}),` — rien ne sera déduit du prochain cycle.`]})]})]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`La facture de prorata n’est jamais prélevée automatiquement.`}),` Elle est créée `,_jsx(_components.code,{children:`open`}),`, sans\nnuméro, sans envoi d’e-mail et sans lien de paiement, et aucune demande de paiement ne part.\nElle apparaît dans `,_jsx(_components.code,{children:`GET /v1/subscriptions/{id}/invoices`}),`. Si vous voulez encaisser le prorata,\nc’est à vous de le facturer par un autre moyen ; si vous ne le voulez pas, ignorez-la.`]})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Une baisse en cours de période ne crédite rien.`}),` Le message de réponse annonce un crédit\n« sur la prochaine facture » ; ce crédit n’est pas implémenté. Le client paie le cycle en cours\nsur l’ancienne quantité, et le suivant sur la nouvelle.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`la-réponse`,children:`La réponse`}),`\n`,_jsx(CodeBlock,{filename:`200`,numberOfLines:`6`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"subscription\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"sub_...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"active\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"items\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [{ `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"si_...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"quantity\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }] },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"prorationAmount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3333`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"prorationInvoice\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"inv_...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"open\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"billingReason\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"proration\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"total\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3333`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Quantity updated. Proration charge of 3333 will be applied.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`prorationAmount`}),` et `,_jsx(_components.code,{children:`prorationInvoice`}),` sont absents quand aucun prorata ne s’applique.\n`,_jsx(_components.code,{children:`prorationAmount`}),` est négatif sur une baisse (sans `,_jsx(_components.code,{children:`prorationInvoice`}),`).`]}),`\n`,_jsx(Heading,{level:`2`,id:`simuler-avant-de-modifier`,children:`Simuler avant de modifier`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`GET /v1/subscriptions/{id}/upcoming-invoice?subscription_item_id=si_...\u0026quantity=3`}),` rend\nl’aperçu du prorata `,_jsx(_components.strong,{children:`sans rien écrire`}),`. Voir `,_jsx(_components.a,{href:`/fr/subscriptions/billing/invoices`,children:`Factures`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`aucun-événement`,children:`Aucun événement`}),`\n`,_jsxs(_components.p,{children:[`Ce changement n’émet `,_jsx(_components.strong,{children:`aucun webhook`}),` — ni `,_jsx(_components.code,{children:`subscription.updated`}),`, ni `,_jsx(_components.code,{children:`invoice.*`}),`. Il est\nconsigné dans l’historique interne de l’abonnement (`,_jsx(_components.code,{children:`events[]`}),` du détail, type\n`,_jsx(_components.code,{children:`quantity_updated`}),`).`]}),`\n`,_jsx(Heading,{level:`2`,id:`erreurs`,children:`Erreurs`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Statut`}),_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`Cause`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`422`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`E_VALIDATION_ERROR`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`itemId`}),` manquant, `,_jsx(_components.code,{children:`quantity`}),` hors bornes.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`500`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`E_INTERNAL_SERVER_ERROR`})}),_jsxs(_components.td,{children:[`Statut autre que `,_jsx(_components.code,{children:`active`}),`/`,_jsx(_components.code,{children:`trialing`}),`, ou `,_jsx(_components.code,{children:`itemId`}),` qui n’appartient pas à cet abonnement. Le message est générique.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`E_SUBSCRIPTION_NOT_FOUND`})}),_jsx(_components.td,{children:`Inconnu ou d’un autre compte.`})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Modifier la quantité","description":"Augmenter ou réduire la quantité d'une ligne, et ce qu'il advient du prorata.","icon":"sliders","href":"/fr/subscriptions/manage/quantity"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Ce qui se passe","slug":"ce-qui-se-passe","depth":2,"children":[]},{"title":"La réponse","slug":"la-réponse","depth":2,"children":[]},{"title":"Simuler avant de modifier","slug":"simuler-avant-de-modifier","depth":2,"children":[]},{"title":"Aucun événement","slug":"aucun-événement","depth":2,"children":[]},{"title":"Erreurs","slug":"erreurs","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"yabetoo","siteName":"Yabetoo Docs","title":"Modifier la quantité - Yabetoo Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"fr":{"href":"/fr/subscriptions/manage/quantity","matchLevel":0},"en":{"href":"/en/subscriptions/manage/quantity","matchLevel":1}}},"lastModified":"2026-09-17T08:16:50.006Z","originalFileLocation":"fr/subscriptions/manage/quantity.mdx","locale":"fr"},"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=\"Augmenter ou réduire la quantité d\u0026#x27;une ligne, et ce qu\u0026#x27;il advient du prorata.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Yabetoo 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/yabetoo/ajEpyO68_wTBcMDu/_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/yabetoo/ajEpyO68_wTBcMDu/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/yabetoo/ajEpyO68_wTBcMDu/_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/yabetoo/ajEpyO68_wTBcMDu/_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/yabetoo/ajEpyO68_wTBcMDu/_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/yabetoo/ajEpyO68_wTBcMDu/_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/yabetoo/ajEpyO68_wTBcMDu/_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/yabetoo/ajEpyO68_wTBcMDu/_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/yabetoo/ajEpyO68_wTBcMDu/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Modifier la quantité - Yabetoo Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Augmenter ou réduire la quantité d\u0026#x27;une ligne, et ce qu\u0026#x27;il advient du prorata.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Yabetoo Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.yabetoopay.com/fr/subscriptions/manage/quantity\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://yabetoo.mintlify.app/_mintlify/api/og/v2?division=G%C3%A9rer\u0026amp;title=Modifier+la+quantit%C3%A9\u0026amp;description=Augmenter+ou+r%C3%A9duire+la+quantit%C3%A9+d%27une+ligne%2C+et+ce+qu%27il+advient+du+prorata.\u0026amp;theme=cc943183d070a4d55d57307f\u0026amp;signature=d1da5c43f62fb4125b488af7b8ff009f03da560473d12252c6a629d6dc67728f\">\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=\"Modifier la quantité - Yabetoo Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Augmenter ou réduire la quantité d\u0026#x27;une ligne, et ce qu\u0026#x27;il advient du prorata.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://yabetoo.mintlify.app/_mintlify/api/og/v2?division=G%C3%A9rer\u0026amp;title=Modifier+la+quantit%C3%A9\u0026amp;description=Augmenter+ou+r%C3%A9duire+la+quantit%C3%A9+d%27une+ligne%2C+et+ce+qu%27il+advient+du+prorata.\u0026amp;theme=cc943183d070a4d55d57307f\u0026amp;signature=d1da5c43f62fb4125b488af7b8ff009f03da560473d12252c6a629d6dc67728f\">\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/yabetoo/ajEpyO68_wTBcMDu/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Yabetoo Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#001C6B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.yabetoopay.com/fr/subscriptions/manage/quantity\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/fr/subscriptions/manage/quantity.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.yabetoopay.com/fr/subscriptions/manage/quantity\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.yabetoopay.com/en/subscriptions/manage/quantity\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.yabetoopay.com/fr/subscriptions/manage/quantity\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.yabetoopay.com/#organization\",\"name\":\"Yabetoo Docs\",\"url\":\"https://docs.yabetoopay.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/yabetoo/GKcRe5bQmORW4fP9/logo/yb_light.svg?fit=max\u0026auto=format\u0026n=GKcRe5bQmORW4fP9\u0026q=85\u0026s=ed73909855c175c18b2f36363a0e38d6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.yabetoopay.com#website\",\"name\":\"Yabetoo Docs\",\"url\":\"https://docs.yabetoopay.com\",\"publisher\":{\"@id\":\"https://docs.yabetoopay.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.yabetoopay.com/fr/subscriptions/manage/quantity#webpage\",\"url\":\"https://docs.yabetoopay.com/fr/subscriptions/manage/quantity\",\"name\":\"Modifier la quantité\",\"description\":\"Augmenter ou réduire la quantité d'une ligne, et ce qu'il advient du prorata.\",\"dateModified\":\"2026-09-17T08:16:50.006Z\",\"isPartOf\":{\"@id\":\"https://docs.yabetoopay.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.yabetoopay.com/fr/subscriptions/manage/quantity#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.yabetoopay.com/fr/subscriptions/manage/quantity#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Gérer\",\"item\":\"https://docs.yabetoopay.com/fr/subscriptions/manage/cancel\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Modifier la quantité\",\"item\":\"https://docs.yabetoopay.com/fr/subscriptions/manage/quantity\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.yabetoopay.com/fr/subscriptions/manage/quantity#article\",\"headline\":\"Modifier la quantité\",\"name\":\"Modifier la quantité\",\"description\":\"Augmenter ou réduire la quantité d'une ligne, et ce qu'il advient du prorata.\",\"url\":\"https://docs.yabetoopay.com/fr/subscriptions/manage/quantity\",\"mainEntityOfPage\":{\"@id\":\"https://docs.yabetoopay.com/fr/subscriptions/manage/quantity#webpage\"},\"dateModified\":\"2026-09-17T08:16:50.006Z\",\"publisher\":{\"@id\":\"https://docs.yabetoopay.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.yabetoopay.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Yabetoo Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Yabetoo Docs","nav":{"global":{"anchors":[]},"languages":[{"language":"fr","tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/fr/introduction"}]},{"tab":"Paiements","pages":[{"title":"Paiements","href":"/fr/payments/overview"}]},{"tab":"Abonnements","groups":[{"group":"Pour commencer","icon":"arrows-rotate","pages":[{"title":"Vue d'ensemble","icon":"arrows-rotate","href":"/fr/subscriptions/overview"},{"title":"Démarrage rapide","icon":"rocket","href":"/fr/subscriptions/quickstart"},{"title":"Cycle de vie","icon":"diagram-project","href":"/fr/subscriptions/lifecycle"}]},{"group":"Créer un abonnement","icon":"plus","pages":[{"title":"Créer par l'API","icon":"code","href":"/fr/subscriptions/create/api"},{"title":"Créer par la page hébergée","icon":"window","href":"/fr/subscriptions/create/hosted"},{"title":"Essais gratuits","icon":"hourglass-half","href":"/fr/subscriptions/create/trials"}]},{"group":"Gérer","icon":"sliders","pages":[{"title":"Annuler","icon":"ban","href":"/fr/subscriptions/manage/cancel"},{"title":"Suspendre et reprendre","description":"Geler la facturation d'un abonnement actif, puis la relancer.","icon":"pause","href":"/fr/subscriptions/manage/pause"},{"title":"Modifier la quantité","icon":"sliders","href":"/fr/subscriptions/manage/quantity"},{"title":"Relancer un paiement","description":"Régulariser un abonnement unpaid ou past_due à la demande.","icon":"rotate-right","href":"/fr/subscriptions/manage/retry-payment"}]},{"group":"Facturation","icon":"file-invoice","pages":[{"title":"Cycle de facturation","icon":"calendar-days","href":"/fr/subscriptions/billing/cycle"},{"title":"Factures","icon":"file-invoice","href":"/fr/subscriptions/billing/invoices"},{"title":"Paiements échoués","icon":"triangle-exclamation","href":"/fr/subscriptions/billing/failed-payments"},{"title":"Clients et méthodes de paiement","icon":"user","href":"/fr/subscriptions/customers"}]},{"group":"Ressources","icon":"book","pages":[{"title":"Webhooks","icon":"bolt","href":"/fr/subscriptions/webhooks"},{"title":"Tester","icon":"flask","href":"/fr/subscriptions/testing"},{"title":"Erreurs","icon":"circle-exclamation","href":"/fr/subscriptions/errors"}]}]},{"tab":"Connect","pages":[{"title":"Connect","href":"/fr/connect/overview"}]},{"tab":"Outils développeur","pages":[{"title":"Outils développeur","href":"/fr/developer-tools/test/overview"}]},{"tab":"Plateformes \u0026 Marchés","pages":[{"title":"Plateformes \u0026 Marchés","href":"/fr/platforms/overview"}]},{"tab":"Référence API","pages":[{"title":"Référence API","href":"/fr/api-reference/introduction"}]}]},{"language":"en","pages":[{"title":"en","href":"/en/subscriptions/manage/quantity"}]}]},"basePath":"","title":"Modifier la quantité - Yabetoo Docs","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":[],"chunks":[]}