Top up your balance, pay in your currency, set up auto top-up, and manage invoices and billing history
Requesty bills from a prepaid USD balance: every request deducts its cost from your organization’s balance, and a request is rejected with a 402 error once the balance runs out. Manage everything from Billing settings in the Console.
Billing is admin only. See RBAC for the role breakdown.
Open Billing settings and choose Top up. Pick an amount in USD credits, a payment method, and a currency. A 5% service fee is added to every top-up, so a $100 top-up costs $105 and credits $100 to your balance.
Payment method
Currencies
Card
USD, GBP, EUR, JPY, CNY
iDEAL
EUR
Bancontact
EUR
EPS
EUR
Satispay
EUR
Billie (pay by invoice)
GBP
UPI
INR
Naver Pay
KRW
UPI top-ups are limited to ₹100,000 per payment, including the service fee.Your balance is always held in USD credits. When you pay in another currency, checkout shows the exchange rate (1 USD = the converted amount) and the converted base, fee, and total before you pay; the displayed rate already includes currency conversion costs.Cards are processed by Stripe. Requesty stores only a reference to the payment method, never the card details.
Auto top-up keeps your balance above a floor you choose. In the top-up dialog, enable Auto top-up and set:
Threshold: the USD balance that triggers a charge
Top-up amount: the USD amount charged each time
When your balance falls below the threshold, Requesty charges your saved payment method for the top-up amount plus the 5% service fee and credits the USD amount to your balance. The charge is made in your card’s currency when it is one of USD, GBP, EUR, JPY, or CNY; cards in other currencies are charged in USD.Only one top-up runs at a time, and repeated triggers within a short window do not double-charge. If the card keeps declining, auto top-up stops trying until a charge succeeds or you set it up again.Disable auto top-up at any time from the same dialog.
Your balance is also your in-flight request limit: the limit is your balance multiplied by your tier’s multiplier. An auto top-up threshold keeps that limit stable, so set the threshold so that threshold times your multiplier covers your peak concurrency.
Pair auto top-up with a low-balance alert if you want a notification when the balance still drops below a level you care about.
The billing page lists every payment for the organization: the USD credits added, any gift or promotion bonus, the service fee, the total charged, the charge currency, and the status. In-flight charges appear as Pending until the payment completes; completed charges show Paid.
Prepaid organizations manage the details printed on their invoices and receipts in the Billing details section of the billing page. Choose Add billing details (or Edit) and set:
Company or billing name
Invoice email: invoices and receipts are emailed to this address
Address: country, address lines, postal code, city, and optional state or region
VAT / Tax ID (optional): shown with its verification status, such as Verified or Verification pending. Clear the field to remove it.
The top-up dialog shows an Invoice to summary of these details with a shortcut to edit them. When details are saved, checkout uses them instead of asking again; without them, you can still enter them at checkout. Changes apply to future top-ups and auto top-ups; invoices already issued do not change.
Turn on Invoices in billing settings and each charge generates a Stripe invoice with your organization’s invoice name, address, and tax ID, taken from your billing details. For a past card payment that has no invoice, open its row in billing history and choose View or Download: Requesty creates the invoice retrospectively and downloads it.
By agreement with Requesty, an organization can run post-paid instead of prepaid: traffic keeps flowing while the balance is negative and usage is settled separately. Post-paid status is set by Requesty and cannot be enabled from the API. Contact [email protected] to switch.
Requests return 402 until you top up; see Error Codes
Auto top-up charge fails
The payment method is retried until it keeps failing, then auto top-up pauses; update the card or set auto top-up up again
Card currency is not USD, GBP, EUR, JPY, or CNY
The charge is made in USD
Last modified on October 19, 2026
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Requesty Docs","description":"Documentation for Requesty, a unified LLM gateway and OpenAI-compatible API for 600+ AI models.","colors":{"primary":"#C8956A","light":"#D4A574","dark":"#E0B88A"},"logo":{"light":"https://mintcdn.com/requesty/o8v2COiz3OtlSbqG/logo/light.svg?fit=max\u0026auto=format\u0026n=o8v2COiz3OtlSbqG\u0026q=85\u0026s=33d22576c8ec4d1e68f24969181684df","dark":"https://mintcdn.com/requesty/o8v2COiz3OtlSbqG/logo/dark.svg?fit=max\u0026auto=format\u0026n=o8v2COiz3OtlSbqG\u0026q=85\u0026s=c21a835e0692187f8c47df7ab6528af9","href":"https://docs.requesty.ai"},"favicon":"https://mintcdn.com/requesty/MM5cSf0NbVkrpoDF/favicon.svg?fit=max\u0026auto=format\u0026n=MM5cSf0NbVkrpoDF\u0026q=85\u0026s=706185ad27099920b149c4ad2f15a5ca","api":{"openapi":["api-reference/requesty_inference-openapi.json","api-reference/requesty_management-openapi.json"],"playground":{}},"appearance":{"default":"dark"},"navbar":{"links":[{"href":"https://docs.requesty.ai/changelog","label":"Changelog"},{"href":"https://docs.requesty.ai/api-reference/requesty_openapi.json","label":"OpenAPI"},{"href":"https://discord.com/invite/Td3rwAHgt4","label":"Discord"}],"primary":{"type":"button","label":"Get Started","href":"https://app.requesty.ai/sign-up"}},"footer":{"socials":{"x":"https://x.com/requestyAI","linkedin":"https://linkedin.com/company/requesty"}},"search":{"prompt":"Search..."},"seo":{"metatags":{"og:site_name":"Requesty Docs"},"indexing":"navigable"},"fonts":{"heading":{"family":"Inter","weight":600},"body":{"family":"Inter"}},"styling":{"eyebrows":"breadcrumbs","codeblocks":"dark","latex":true},"integrations":{"amplitude":{"apiKey":"ce02ec2dce31d2745bd8a3ffaedd53cc"}},"contextual":{"options":["copy","chatgpt","claude","perplexity"],"display":"header"},"metadata":{"timestamp":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"requesty","hasAudioNarration":false,"actualSubdomain":"requesty","customDomains":["docs.requesty.ai"],"gitSource":{"type":"github","owner":"requestyai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adb7acb1ada5501057a632e","collectionId":"a8e13621-4f5a-44ca-89f9-512c3c8421dc","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adb7acb1ada5501057a632e"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6adb7acb1ada5501057a632e","clientVersion":"0.0.3966","searchFilterCounts":[{"language":"default","tag":"Gateway","count":58},{"language":"default","tag":"Management API","count":37},{"language":"default","tag":"Integrations","count":26},{"language":"default","tag":"Inference API","count":21},{"language":"default","tag":"Inference APIs","count":21},{"language":"default","tag":"Organization","count":15},{"language":"default","tag":"LLM Gateway","count":14},{"language":"default","tag":"Analytics \u0026 Monitoring","count":12},{"language":"default","tag":"Coding Assistants","count":10},{"language":"default","tag":"API Keys","count":9}]},"assistantConfig":{"enableStarterQuestions":false,"deflection":{"enabled":true,"email":"[email protected]","showHelpButton":true}},"hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"editor-v7-file-tree","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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"editor-agent-model-picker","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":"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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"styles/custom.css","content":":root{--requesty-gold:#C8956A;--requesty-gold-light:#E0B88A;--requesty-gold-muted:rgba(200, 149, 106, 0.15)}::-webkit-scrollbar{width:5px;height:5px}::-webkit-scrollbar-track{background:0 0}::-webkit-scrollbar-thumb{background:rgba(128,128,128,.15);border-radius:3px}::-webkit-scrollbar-thumb:hover{background:rgba(128,128,128,.3)}#navbar{backdrop-filter:blur(12px);-webkit-backdrop-filter:blur(12px)}img.nav-logo{height:2.25rem!important;max-width:18rem!important;max-height:2.25rem!important}#sidebar{font-size:13.5px!important}#sidebar-content{padding-top:.5rem}sidebar-group-header{font-weight:600!important;letter-spacing:.01em;text-transform:none!important}#content-area{max-width:100%}#page-title{font-size:2rem!important;font-weight:600!important;letter-spacing:-.025em!important;line-height:1.2!important}mdx-content{font-size:15px!important;line-height:1.65!important}mdx-content h2{font-size:1.35rem!important;font-weight:600!important;letter-spacing:-.015em!important;margin-top:2rem!important;margin-bottom:.75rem!important}mdx-content h3{font-size:1.1rem!important;font-weight:600!important;margin-top:1.5rem!important;margin-bottom:.4rem!important}mdx-content p{margin-top:.6em!important;margin-bottom:.6em!important}mdx-content li{margin-top:.2rem!important;margin-bottom:.2rem!important}#request-example,#response-example,code-block{border-radius:12px!important;overflow:hidden}mdx-content code:not(pre code){border:0!important;border-radius:5px!important;padding:2px 6px!important;font-size:.9em!important}:root:not(.dark) mdx-content code:not(pre code){background:rgba(0,0,0,.05)!important}:root.dark mdx-content code:not(pre code){background:rgba(255,255,255,.08)!important}card{border-radius:12px!important;transition:border-color .2s ease,background-color .2s ease}:root:not(.dark) card{border:1px solid rgba(0,0,0,.08)!important}:root:not(.dark) card:hover{border-color:rgba(0,0,0,.15)!important;background:rgba(0,0,0,.01)!important}:root.dark card{border:1px solid rgba(255,255,255,.06)!important}:root.dark card:hover{border-color:rgba(255,255,255,.12)!important;background:rgba(255,255,255,.02)!important}callout{border-left-width:3px!important}mdx-content table{overflow:hidden}mdx-content table th{font-weight:600!important;font-size:.85rem!important;letter-spacing:.02em;text-transform:uppercase}accordion,callout,mdx-content img,mdx-content table{border-radius:10px!important}api-section{padding-bottom:2rem}:root:not(.dark) api-section{border-bottom:1px solid rgba(0,0,0,.06)}:root.dark api-section{border-bottom:1px solid rgba(255,255,255,.05)}api-section-heading-title{font-size:1.75rem!important;font-weight:600!important;letter-spacing:-.02em!important}#table-of-contents,breadcrumb-list{font-size:13px!important}toc-item{transition:color .15s ease}breadcrumb-list{opacity:.7}nav-tabs-item{font-weight:500!important;letter-spacing:.01em}#pagination{margin-top:2rem!important;padding-top:1rem!important}:root:not(.dark) #pagination{border-top:1px solid rgba(0,0,0,.06)!important}:root.dark #pagination{border-top:1px solid rgba(255,255,255,.05)!important}steps{border-left-color:rgba(200,149,106,.3)!important}step-content{padding-bottom:.75rem!important}#search-bar-entry,expandable{border-radius:8px!important}nav-tag-pill{font-size:11px!important;font-weight:600!important;letter-spacing:.03em;border-radius:4px!important}[data-component-part=update-tag]{padding:2px 8px!important;border-radius:6px!important;font-size:12px!important}:root:not(.dark) [data-component-part=update-tag]{background:rgba(0,0,0,.06)!important;color:#374151!important}:root.dark [data-component-part=update-tag]{background:rgba(255,255,255,.1)!important;color:#d1d5db!important}:root:not(.dark) #footer{border-top:1px solid rgba(0,0,0,.06)!important}:root.dark #footer{border-top:1px solid rgba(255,255,255,.05)!important}"}],"page":{"pagePath":"features/billing","slug":"/features/billing","pageMetadata":{"title":"Billing","description":"Top up your balance, pay in your currency, set up auto top-up, and manage invoices and billing history","icon":"credit-card","href":"/features/billing"},"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: \"Top up your balance, pay in your currency, set up auto top-up, and manage invoices and billing history\"\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`,li:`li`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Note,Table,Tip}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Requesty bills from a prepaid USD balance: every request deducts its cost from your organization’s balance, and a request is rejected with a 402 error once the balance runs out. Manage everything from `,_jsx(_components.a,{href:`https://app.requesty.ai/settings/billing`,children:`Billing settings`}),` in the Console.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Billing is `,_jsx(_components.strong,{children:`admin only`}),`. See `,_jsx(_components.a,{href:`/features/rbac`,children:`RBAC`}),` for the role breakdown.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`topping-up`,children:`Topping up`}),`\n`,_jsxs(_components.p,{children:[`Open `,_jsx(_components.strong,{children:`Billing settings`}),` and choose `,_jsx(_components.strong,{children:`Top up`}),`. Pick an amount in USD credits, a payment method, and a currency. A 5% service fee is added to every top-up, so a `,`$100 top-up costs $`,`105 and credits $100 to your balance.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Payment method`}),_jsx(_components.th,{children:`Currencies`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Card`}),_jsx(_components.td,{children:`USD, GBP, EUR, JPY, CNY`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`iDEAL`}),_jsx(_components.td,{children:`EUR`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Bancontact`}),_jsx(_components.td,{children:`EUR`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`EPS`}),_jsx(_components.td,{children:`EUR`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Satispay`}),_jsx(_components.td,{children:`EUR`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Billie (pay by invoice)`}),_jsx(_components.td,{children:`GBP`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`UPI`}),_jsx(_components.td,{children:`INR`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Naver Pay`}),_jsx(_components.td,{children:`KRW`})]})]})]}),`\n`,_jsx(_components.p,{children:`UPI top-ups are limited to ₹100,000 per payment, including the service fee.`}),`\n`,_jsx(_components.p,{children:`Your balance is always held in USD credits. When you pay in another currency, checkout shows the exchange rate (1 USD = the converted amount) and the converted base, fee, and total before you pay; the displayed rate already includes currency conversion costs.`}),`\n`,_jsx(_components.p,{children:`Cards are processed by Stripe. Requesty stores only a reference to the payment method, never the card details.`}),`\n`,_jsx(Heading,{level:`2`,id:`auto-top-up`,children:`Auto top-up`}),`\n`,_jsxs(_components.p,{children:[`Auto top-up keeps your balance above a floor you choose. In the top-up dialog, enable `,_jsx(_components.strong,{children:`Auto top-up`}),` and set:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Threshold`}),`: the USD balance that triggers a charge`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Top-up amount`}),`: the USD amount charged each time`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`When your balance falls below the threshold, Requesty charges your saved payment method for the top-up amount plus the 5% service fee and credits the USD amount to your balance. The charge is made in your card’s currency when it is one of USD, GBP, EUR, JPY, or CNY; cards in other currencies are charged in USD.`}),`\n`,_jsx(_components.p,{children:`Only one top-up runs at a time, and repeated triggers within a short window do not double-charge. If the card keeps declining, auto top-up stops trying until a charge succeeds or you set it up again.`}),`\n`,_jsx(_components.p,{children:`Disable auto top-up at any time from the same dialog.`}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Your balance is also your `,_jsx(_components.a,{href:`/features/in-flight-rate-limits`,children:`in-flight request limit`}),`: the limit is your balance multiplied by your tier’s multiplier. An auto top-up threshold keeps that limit stable, so set the threshold so that threshold times your multiplier covers your peak concurrency.`]})}),`\n`,_jsxs(_components.p,{children:[`Pair auto top-up with a `,_jsx(_components.a,{href:`/features/alerts`,children:`low-balance alert`}),` if you want a notification when the balance still drops below a level you care about.`]}),`\n`,_jsx(Heading,{level:`2`,id:`billing-history`,children:`Billing history`}),`\n`,_jsxs(_components.p,{children:[`The billing page lists every payment for the organization: the USD credits added, any gift or promotion bonus, the service fee, the total charged, the charge currency, and the status. In-flight charges appear as `,_jsx(_components.strong,{children:`Pending`}),` until the payment completes; completed charges show `,_jsx(_components.strong,{children:`Paid`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`billing-details`,children:`Billing details`}),`\n`,_jsxs(_components.p,{children:[`Prepaid organizations manage the details printed on their invoices and receipts in the `,_jsx(_components.strong,{children:`Billing details`}),` section of the billing page. Choose `,_jsx(_components.strong,{children:`Add billing details`}),` (or `,_jsx(_components.strong,{children:`Edit`}),`) and set:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.strong,{children:`Company or billing name`})}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Invoice email`}),`: invoices and receipts are emailed to this address`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Address`}),`: country, address lines, postal code, city, and optional state or region`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`VAT / Tax ID`}),` (optional): shown with its verification status, such as `,_jsx(_components.strong,{children:`Verified`}),` or `,_jsx(_components.strong,{children:`Verification pending`}),`. Clear the field to remove it.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`The top-up dialog shows an `,_jsx(_components.strong,{children:`Invoice to`}),` summary of these details with a shortcut to edit them. When details are saved, checkout uses them instead of asking again; without them, you can still enter them at checkout. Changes apply to future top-ups and auto top-ups; invoices already issued do not change.`]}),`\n`,_jsx(Heading,{level:`2`,id:`invoices`,children:`Invoices`}),`\n`,_jsxs(_components.p,{children:[`Turn on `,_jsx(_components.strong,{children:`Invoices`}),` in billing settings and each charge generates a Stripe invoice with your organization’s invoice name, address, and tax ID, taken from your `,_jsx(_components.a,{href:`#billing-details`,children:`billing details`}),`. For a past card payment that has no invoice, open its row in billing history and choose `,_jsx(_components.strong,{children:`View`}),` or `,_jsx(_components.strong,{children:`Download`}),`: Requesty creates the invoice retrospectively and downloads it.`]}),`\n`,_jsx(Heading,{level:`2`,id:`post-paid-organizations`,children:`Post-paid organizations`}),`\n`,_jsxs(_components.p,{children:[`By agreement with Requesty, an organization can run post-paid instead of prepaid: traffic keeps flowing while the balance is negative and usage is settled separately. Post-paid status is set by Requesty and cannot be enabled from the API. Contact `,_jsx(_components.a,{href:`mailto:[email protected]`,children:`[email protected]`}),` to switch.`]}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Situation`}),_jsx(_components.th,{children:`What happens`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Balance reaches zero`}),_jsxs(_components.td,{children:[`Requests return 402 until you top up; see `,_jsx(_components.a,{href:`/features/error-codes`,children:`Error Codes`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Auto top-up charge fails`}),_jsx(_components.td,{children:`The payment method is retried until it keeps failing, then auto top-up pauses; update the card or set auto top-up up again`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Card currency is not USD, GBP, EUR, JPY, or CNY`}),_jsx(_components.td,{children:`The charge is made in USD`})]})]})]})]})}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":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Billing","description":"Top up your balance, pay in your currency, set up auto top-up, and manage invoices and billing history","icon":"credit-card","href":"/features/billing"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Topping up","slug":"topping-up","depth":2,"children":[]},{"title":"Auto top-up","slug":"auto-top-up","depth":2,"children":[]},{"title":"Billing history","slug":"billing-history","depth":2,"children":[]},{"title":"Billing details","slug":"billing-details","depth":2,"children":[]},{"title":"Invoices","slug":"invoices","depth":2,"children":[]},{"title":"Post-paid organizations","slug":"post-paid-organizations","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"requesty","siteName":"Requesty Docs","title":"Billing - Requesty Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-19T12:59:08.145Z","gitLastModified":"2026-10-19T12:58:55.000Z","originalFileLocation":"features/billing.mdx"},"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=\"dark\"}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=\"Top up your balance, pay in your currency, set up auto top-up, and manage invoices and billing history\">\u003cmeta data-mint-head name=\"application-name\" content=\"Requesty 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/requesty/bWQG6e3TK2khNMP8/_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/requesty/bWQG6e3TK2khNMP8/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/requesty/bWQG6e3TK2khNMP8/_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/requesty/bWQG6e3TK2khNMP8/_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/requesty/bWQG6e3TK2khNMP8/_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/requesty/bWQG6e3TK2khNMP8/_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/requesty/bWQG6e3TK2khNMP8/_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/requesty/bWQG6e3TK2khNMP8/_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/requesty/bWQG6e3TK2khNMP8/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Billing - Requesty Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Top up your balance, pay in your currency, set up auto top-up, and manage invoices and billing history\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Requesty Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.requesty.ai/features/billing\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://requesty.mintlify.app/_mintlify/api/og/v2?division=Organization\u0026amp;title=Billing\u0026amp;description=Top+up+your+balance%2C+pay+in+your+currency%2C+set+up+auto+top-up%2C+and+manage+invoices+and+billing+history\u0026amp;theme=1b9a5094c3592451956d887a\u0026amp;signature=5d5c75847300507f2321cf5355a79439b078e7385e4138f7b6339845b3426c9f\">\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=\"Billing - Requesty Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Top up your balance, pay in your currency, set up auto top-up, and manage invoices and billing history\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://requesty.mintlify.app/_mintlify/api/og/v2?division=Organization\u0026amp;title=Billing\u0026amp;description=Top+up+your+balance%2C+pay+in+your+currency%2C+set+up+auto+top-up%2C+and+manage+invoices+and+billing+history\u0026amp;theme=1b9a5094c3592451956d887a\u0026amp;signature=5d5c75847300507f2321cf5355a79439b078e7385e4138f7b6339845b3426c9f\">\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/requesty/bWQG6e3TK2khNMP8/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Requesty Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#C8956A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.requesty.ai/features/billing\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/features/billing.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.requesty.ai/#organization\",\"name\":\"Requesty Docs\",\"url\":\"https://docs.requesty.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/requesty/o8v2COiz3OtlSbqG/logo/light.svg?fit=max\u0026auto=format\u0026n=o8v2COiz3OtlSbqG\u0026q=85\u0026s=33d22576c8ec4d1e68f24969181684df\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.requesty.ai#website\",\"name\":\"Requesty Docs\",\"url\":\"https://docs.requesty.ai\",\"publisher\":{\"@id\":\"https://docs.requesty.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.requesty.ai/features/billing#webpage\",\"url\":\"https://docs.requesty.ai/features/billing\",\"name\":\"Billing\",\"description\":\"Top up your balance, pay in your currency, set up auto top-up, and manage invoices and billing history\",\"dateModified\":\"2026-10-19T12:58:55.000Z\",\"isPartOf\":{\"@id\":\"https://docs.requesty.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.requesty.ai/features/billing#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.requesty.ai/features/billing#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Organization\",\"item\":\"https://docs.requesty.ai/features/users\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Billing\",\"item\":\"https://docs.requesty.ai/features/billing\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.requesty.ai/features/billing#article\",\"headline\":\"Billing\",\"name\":\"Billing\",\"description\":\"Top up your balance, pay in your currency, set up auto top-up, and manage invoices and billing history\",\"url\":\"https://docs.requesty.ai/features/billing\",\"mainEntityOfPage\":{\"@id\":\"https://docs.requesty.ai/features/billing#webpage\"},\"dateModified\":\"2026-10-19T12:58:55.000Z\",\"publisher\":{\"@id\":\"https://docs.requesty.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.requesty.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Requesty Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Requesty Docs","nav":{"global":null,"tabs":[{"tab":"Gateway","groups":[{"group":"Getting Started","pages":[{"title":"Quickstart","icon":"rocket","href":"/quickstart"},{"title":"Supported Models","icon":"microchip","href":"/features/supported-models"},{"title":"Free Models","icon":"gift","href":"/features/free-models"},{"title":"Changelog","icon":"clock-rotate-left","href":"/changelog"},{"title":"Error Codes","icon":"triangle-exclamation","href":"/features/error-codes"}]},{"group":"LLM Gateway","pages":[{"title":"EU Routing","icon":"globe-europe","href":"/features/eu-routing"},{"title":"Fallback Policies","icon":"forward-step","href":"/features/fallback-policies"},{"title":"Load Balancing Policies","icon":"scale-balanced","href":"/features/load-balancing-policies"},{"title":"Latency-Based Routing","icon":"gauge-high","href":"/features/latency-routing"},{"title":"Auto Routing","icon":"route","href":"/features/auto-routing"},{"title":"Managed Policies","icon":"wand-magic-sparkles","href":"/features/managed-policies"},{"title":"Auto Caching","icon":"toggle-on","href":"/features/auto-caching"},{"title":"Manual Caching for Anthropic Models","icon":"code","href":"/features/manual-caching"},{"title":"Messages API Caching","icon":"layer-group","href":"/features/messages-api-caching"},{"title":"Spend Limits \u0026 Rate Limits","icon":"gauge-max","href":"/features/api-limits"},{"title":"In-Flight Rate Limits","icon":"arrows-left-right-to-line","href":"/features/in-flight-rate-limits"},{"title":"Bring Your Own Keys","icon":"key","href":"/features/bring-your-own-keys"},{"title":"Service Accounts","icon":"robot","href":"/features/service-accounts"},{"title":"Prompt Library","icon":"book","href":"/features/prompt-library"}]},{"group":"Model Capabilities","pages":[{"title":"Streaming Responses","icon":"stream","href":"/features/streaming"},{"title":"Structured Outputs","icon":"brackets-curly","href":"/features/structured-outputs"},{"title":"Decisions","icon":"scale-balanced","href":"/features/decisions"},{"title":"Reasoning","icon":"brain","href":"/features/reasoning"},{"title":"Image Understanding","icon":"camera","href":"/features/image-understanding"},{"title":"Image Generation","icon":"image","href":"/features/image-generation"},{"title":"PDF Support","icon":"file-pdf","href":"/features/pdf-support"},{"title":"Video Input","icon":"video","href":"/features/video-input"},{"title":"Web Search","icon":"globe","href":"/features/web-search"}]},{"group":"Analytics \u0026 Monitoring","pages":[{"title":"Overview","icon":"gauge-high","href":"/features/overview"},{"title":"Logs \u0026 Traces","icon":"list","href":"/features/logs"},{"title":"Usage Analytics","icon":"chart-line","href":"/features/usage-analytics"},{"title":"Analytics Exports","icon":"file-export","href":"/features/analytics-exports"},{"title":"Cost Tracking","icon":"dollar-sign","href":"/features/cost-tracking"},{"title":"Performance Monitoring","icon":"gauge-high","href":"/features/performance-monitoring"},{"title":"Tool Call Analytics","icon":"screwdriver-wrench","href":"/features/tool-call-analytics"},{"title":"Analytics Headers","icon":"tags","href":"/features/analytics-headers"},{"title":"Request Metadata","icon":"chart-line","href":"/features/request-metadata"},{"title":"Request Feedback","icon":"comment-pen","href":"/features/request-feedback"},{"title":"Session Reconstruction","icon":"wrench","href":"/features/session-reconstruction"},{"title":"Key Management API","icon":"key","href":"/features/key-management-api"}]},{"group":"Access Control","pages":[{"title":"Approved Models","href":"/features/approved-models"},{"title":"Access Lists","href":"/features/access-lists"}]},{"group":"Organization","pages":[{"title":"User Management","href":"/features/users"},{"title":"Groups Management","href":"/features/groups"},{"title":"Platform Integrations","href":"/features/platform-integrations"},{"title":"Single Sign-On (SSO)","description":"Sign in to Requesty with your corporate identity provider. Works with Microsoft Entra ID, Okta, and any OIDC or SAML provider, with optional group and deprovisioning sync.","href":"/features/sso"},{"title":"Billing","icon":"credit-card","href":"/features/billing"},{"title":"Spending Alerts","description":"Monitor spending across your organization with configurable alert thresholds and webhook notifications","href":"/features/alerts"},{"title":"Webhook Signatures","icon":"signature","href":"/features/webhook-signatures"},{"title":"Guardrails","href":"/features/guardrails"},{"title":"RBAC (Role-Based Access Control)","href":"/features/rbac"},{"title":"Data Privacy \u0026 Zero Data Retention","icon":"lock","href":"/features/data-privacy"},{"title":"Compliance","icon":"shield-check","href":"/features/compliance-report"}]},{"group":"MCP Gateway","pages":[{"title":"Overview","icon":"plug","href":"/features/mcp-gateway"},{"title":"MCP Server Management","icon":"server","href":"/features/mcp-server-management"},{"title":"User Key Management","icon":"key","href":"/features/mcp-user-keys"},{"title":"MCP Analytics","icon":"chart-line","href":"/features/mcp-analytics"},{"title":"AI Tool Integration","icon":"plug-circle-plus","href":"/features/mcp-integration"}]}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/requesty-cli"}]},{"tab":"Inference API","pages":[{"title":"Inference API","href":"/api-reference/inference-apis"}]},{"tab":"Management API","pages":[{"title":"Management API","href":"/api-reference/management-apis"}]}]},"title":"Billing - Requesty Docs","buildId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","deploymentId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","dynamics":[],"chunks":[]}