Before creating an invoice, you can use this endpoint to calculate the precise service fees that would apply to a proposed financing transaction. The fee calculation takes into account the buyer’s credit facility terms, the requested payment term, the invoice amount, and your platform’s configured fee structure. Calling this endpoint at checkout lets you display exact fee amounts to the buyer before they confirm their payment term selection – improving transparency and reducing disputes.
Call this endpoint for each payment term option you display to the buyer at checkout. Showing a breakdown of fees per term
(e.g., “30 days – €5.95 fee / 60 days – €9.50 fee”) helps buyers make informed decisions and reduces post-purchase confusion.
Fee calculations are estimates against the fee configuration in force now. Creating a financing service pins that
configuration: a configuration you publish afterwards does not change the fees for a service already created. The
estimate can still differ from the accepted fee when the payout date moves at acceptance, because the daily rate is
applied to the number of days between payout and due date. advance and security use the same range shape as the
fees, and the same names as a financing service.
Authorizations
Authorization
string
header
required
Your Tilta API key, sent as Bearer <key>.
Body
application/json
amount
integer
required
Total amount of the invoice in cents.
due_at
number
required
Timestamp indicating when the invoice should be paid.
Example:
1582896122
buyer_external_id
string
required
Unique identifier of a related buyer.
Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$
paid_out_at
number | null
Timestamp indicating when the invoice is actually paid.
Example:
1582896122
merchant_external_id
string
Unique identifier of a merchant. Optional only for Single-merchant platforms.
Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$
Response
fees
object
required
Show child attributes
advance
object
required
Advance amount that would be paid out to the merchant for this invoice. Each number is a range across configured risk bands.
Show child attributes
security
object
required
Holdback on this financing preview.
Show child attributes
amount
integer
required
Total amount of the invoice in cents.
due_at
number
required
Timestamp indicating when the invoice should be paid.
Example:
1582896122
buyer_external_id
string
required
Unique identifier of a related buyer.
Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$
merchant_external_id
string
required
Unique identifier of a related merchant.
Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$
paid_out_at
number | null
Timestamp indicating when the invoice is actually paid.
Example:
1582896122
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Tilta","colors":{"primary":"#7563E4","light":"#8A7AFE","dark":"#7563E4"},"logo":{"light":"https://mintcdn.com/tilta/9uQVAt1ClfFJqI9c/images/wordmark_positive_nopadding.svg?fit=max\u0026auto=format\u0026n=9uQVAt1ClfFJqI9c\u0026q=85\u0026s=2d77f76ffd19a7569d9f4281c2c7d985","dark":"https://mintcdn.com/tilta/9uQVAt1ClfFJqI9c/images/wordmark_negative_nopadding.svg?fit=max\u0026auto=format\u0026n=9uQVAt1ClfFJqI9c\u0026q=85\u0026s=9750c80c39f37d607fc7cc0f9ded89ff"},"favicon":"https://mintcdn.com/tilta/9uQVAt1ClfFJqI9c/favicon.svg?fit=max\u0026auto=format\u0026n=9uQVAt1ClfFJqI9c\u0026q=85\u0026s=d3419a3989bf69708050d87b411d8540","api":{"openapi":"api-reference/openapi.yml","playground":{"display":"interactive"},"examples":{"defaults":"all","languages":["bash","javascript","python","php"]}},"background":{"decoration":"gradient","color":{"light":"#FFFFFF","dark":"#101019"}},"navbar":{"primary":{"type":"button","label":"Book a Demo","href":"https://www.tilta.ai/book-a-demo"}},"footer":{"socials":{"github":"https://github.com/tilta-io","linkedin":"https://www.linkedin.com/company/tilta","website":"https://tilta.ai/"}},"fonts":{"heading":{"family":"Inter"},"body":{"family":"Inter"}},"icons":{"library":"lucide"},"integrations":{"gtm":{"tagId":"GTM-KGGKX2BZ"}},"contextual":{"options":["copy","view","download-spec","mcp","cursor","claude"],"display":"toc"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tilta","hasAudioNarration":false,"actualSubdomain":"tilta","customDomains":["docs.tilta.ai"],"gitSource":{"type":"github","owner":"tilta-io","repo":"tilta-backend","deployBranch":"docs-release","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6afeebaf42e7ae4824d4e79d","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":69},{"language":"default","tag":"Documentation","count":25},{"language":"default","tag":"Merchants","count":17},{"language":"default","tag":"Invoices","count":10},{"language":"default","tag":"Buyers","count":9},{"language":"default","tag":"Orders","count":8},{"language":"default","tag":"Platform \u0026 Utilities","count":8},{"language":"default","tag":"Contacts \u0026 Persons","count":7},{"language":"default","tag":"Platform \u0026 Reference","count":6},{"language":"default","tag":"Integration","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"brand.css","content":":root{--background-light: 255 255 255;--background-dark: 16 16 25;--gray-50: 250 250 251;--gray-100: 243 243 245;--gray-200: 230 230 233;--gray-300: 211 212 217;--gray-400: 139 139 146;--gray-500: 114 114 121;--gray-600: 93 93 100;--gray-700: 71 71 79;--gray-800: 50 50 58;--gray-900: 32 31 40;--gray-950: 16 16 25}.prose{--tw-prose-links: #7563e4}.prose a.link{color:#7563e4}html.dark .prose{--tw-prose-links: #8a7afe;color:#d3d4d9}html.dark .prose a.link{color:#8a7afe}html.dark #topbar-cta-button .bg-primary-dark{background-color:#8a7afe}html.dark #topbar-cta-button .text-white{color:#101019}.callout[data-callout-type=\"note\"]{background-color:#f4f4ff;border-color:#d7d7ff;color:#5e4dbe}html.dark .callout[data-callout-type=\"note\"]{background-color:#221b4b;border-color:#352a70;color:#d7d7ff}.callout[data-callout-type=\"tip\"]{background-color:#daffe0;border-color:#09e36b;color:#01813a}html.dark .callout[data-callout-type=\"tip\"]{background-color:#1a3520;border-color:#01813a;color:#30bb60}.callout[data-callout-type=\"warning\"]{background-color:#ffeee5;border-color:#ff7e21;color:#b15203}html.dark .callout[data-callout-type=\"warning\"]{background-color:#422616;border-color:#b15203;color:#e58042}.callout[data-callout-type=\"info\"]{background-color:#fafafb;border-color:#e6e6e9;color:#5d5d64}html.dark .callout[data-callout-type=\"info\"]{background-color:#201f28;border-color:#32323a;color:#d3d4d9}.callout[data-callout-type] [data-component-part=\"callout-icon\"],.callout[data-callout-type] svg,.callout[data-callout-type] a{color:inherit}"}]}
{"page":{"pagePath":"api-reference/invoices/calculate-fees","slug":"/api-reference/invoices/calculate-fees","pageMetadata":{"title":"Calculate fees","sidebarTitle":"Calculate fees","description":"Calculate the exact buyer and merchant fees for a proposed invoice. Use this before capturing financing to show transparent fee amounts at checkout.","keywords":["buyer fee","merchant fee","agio","disagio","checkout"],"openapi":"POST /v1/invoices/calculate_fees","href":"/api-reference/invoices/calculate-fees"},"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: \"Calculate the exact buyer and merchant fees for a proposed invoice. Use this before capturing financing to show transparent fee amounts at checkout.\"\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={code:`code`,p:`p`,..._provideComponents(),...props.components},{Note,Tip}=_components;if(!Note)_missingMdxReference(`Note`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Before creating an invoice, you can use this endpoint to calculate the precise service fees that would apply to a proposed financing transaction. The fee calculation takes into account the buyer’s credit facility terms, the requested payment term, the invoice amount, and your platform’s configured fee structure. Calling this endpoint at checkout lets you display exact fee amounts to the buyer before they confirm their payment term selection – improving transparency and reducing disputes.`}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Call this endpoint for each payment term option you display to the buyer at checkout. Showing a breakdown of fees per term\n(e.g., “30 days – €5.95 fee / 60 days – €9.50 fee”) helps buyers make informed decisions and reduces post-purchase confusion.`})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Fee calculations are estimates against the fee configuration in force now. Creating a financing service pins that\nconfiguration: a configuration you publish afterwards does not change the fees for a service already created. The\nestimate can still differ from the accepted fee when the payout date moves at acceptance, because the daily rate is\napplied to the number of days between payout and due date. `,_jsx(_components.code,{children:`advance`}),` and `,_jsx(_components.code,{children:`security`}),` use the same range shape as the\nfees, and the same names as a financing service.`]})})]})}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":"Calculate fees","sidebarTitle":"Calculate fees","description":"Calculate the exact buyer and merchant fees for a proposed invoice. Use this before capturing financing to show transparent fee amounts at checkout.","keywords":["buyer fee","merchant fee","agio","disagio","checkout"],"openapi":"POST /v1/invoices/calculate_fees","href":"/api-reference/invoices/calculate-fees"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Calculate the exact buyer and merchant fees for a proposed invoice. Use this before capturing financing to show transparent fee amounts at checkout.","summary":"Calculate fees for an invoice","tags":["Invoices"],"security":["d70300ba-a5d5-4206-aa7f-6494fa9fc0af"],"requestBody":"013bb3b0-27d4-41af-b5b2-18279f11d6f1","responses":{"200":"f77c13de-5088-4bc0-af15-1bf759e7b2a8","400":"04dd6dfe-c51a-4aad-b9a4-1076d6d31cd2","401":"631b36f1-4514-4b14-a535-a8d190a6bcca"},"method":"post","type":"path","servers":["0d16876d-c42e-4739-9cb6-74ddf3bb3f66","a8fd5e82-bae4-4987-aed3-5d5342202f75"],"path":"/v1/invoices/calculate_fees","baseUrlOptions":["https://api.tilta.io","https://api.tilta-sandbox.io"],"title":"Calculate fees for an invoice","codeSamples":[],"requestExampleLanguages":["bash","javascript","python","php"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"type":"integer","description":"Total amount of the invoice in cents.","isRequired":true,"uniqueKey":"amount","typeLabel":"integer"},"due_at":{"type":"number","description":"Timestamp indicating when the invoice should be paid.","example":1582896122,"isRequired":true,"uniqueKey":"due_at","typeLabel":"number"},"buyer_external_id":{"type":"string","maxLength":100,"pattern":"^[a-zA-Z0-9-_]+$","description":"Unique identifier of a related buyer.","isRequired":true,"uniqueKey":"buyer_external_id","typeLabel":"string"},"paid_out_at":{"oneOf":[{"type":"number","description":"Timestamp indicating when the invoice is actually paid.","example":1582896122,"uniqueKey":"paid_out_at.oneOf.0","typeLabel":"number"},{"type":"null","description":"Timestamp indicating when the invoice is actually paid.","example":1582896122,"uniqueKey":"paid_out_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"paid_out_at","typeLabel":"number | null"},"merchant_external_id":{"type":"string","maxLength":100,"pattern":"^[a-zA-Z0-9-_]+$","description":"Unique identifier of a merchant. Optional only for Single-merchant platforms.","uniqueKey":"merchant_external_id","typeLabel":"string"}},"required":["amount","due_at","buyer_external_id"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"amount":123,"due_at":1582896122,"buyer_external_id":"\u003cstring>","paid_out_at":1582896122,"merchant_external_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"f77c13de-5088-4bc0-af15-1bf759e7b2a8":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"fees":{"type":"object","properties":{"financing":{"type":"object","properties":{"merchant_fee":{"type":"object","properties":{"base_rate":{"type":"object","properties":{"value":{"oneOf":[{"type":"number","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.base_rate.value.oneOf.0","typeLabel":"number"},{"type":"null","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.base_rate.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fees.financing.merchant_fee.base_rate.value","typeLabel":"number | null"},"min":{"type":"number","description":"Lower bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.base_rate.min","typeLabel":"number"},"max":{"type":"number","description":"Upper bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.base_rate.max","typeLabel":"number"}},"required":["value","min","max"],"description":"Numeric value with min/max range. When the value depends on the buyer risk band and the band is not yet known, `value` is null and the range still indicates the bounds.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.base_rate","typeLabel":"object"},"daily_rate":{"type":"object","properties":{"value":{"oneOf":[{"type":"number","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.daily_rate.value.oneOf.0","typeLabel":"number"},{"type":"null","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.daily_rate.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fees.financing.merchant_fee.daily_rate.value","typeLabel":"number | null"},"min":{"type":"number","description":"Lower bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.daily_rate.min","typeLabel":"number"},"max":{"type":"number","description":"Upper bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.daily_rate.max","typeLabel":"number"}},"required":["value","min","max"],"description":"Numeric value with min/max range. When the value depends on the buyer risk band and the band is not yet known, `value` is null and the range still indicates the bounds.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.daily_rate","typeLabel":"object"},"total_rate":{"type":"object","properties":{"value":{"oneOf":[{"type":"number","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.total_rate.value.oneOf.0","typeLabel":"number"},{"type":"null","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.total_rate.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fees.financing.merchant_fee.total_rate.value","typeLabel":"number | null"},"min":{"type":"number","description":"Lower bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.total_rate.min","typeLabel":"number"},"max":{"type":"number","description":"Upper bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.total_rate.max","typeLabel":"number"}},"required":["value","min","max"],"description":"Numeric value with min/max range. When the value depends on the buyer risk band and the band is not yet known, `value` is null and the range still indicates the bounds.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.total_rate","typeLabel":"object"},"tax_rate":{"type":"object","properties":{"value":{"oneOf":[{"type":"number","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.tax_rate.value.oneOf.0","typeLabel":"number"},{"type":"null","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.tax_rate.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fees.financing.merchant_fee.tax_rate.value","typeLabel":"number | null"},"min":{"type":"number","description":"Lower bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.tax_rate.min","typeLabel":"number"},"max":{"type":"number","description":"Upper bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.tax_rate.max","typeLabel":"number"}},"required":["value","min","max"],"description":"Numeric value with min/max range. When the value depends on the buyer risk band and the band is not yet known, `value` is null and the range still indicates the bounds.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.tax_rate","typeLabel":"object"},"amount":{"type":"object","properties":{"net":{"type":"object","properties":{"value":{"oneOf":[{"type":"number","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.amount.net.value.oneOf.0","typeLabel":"number"},{"type":"null","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.amount.net.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fees.financing.merchant_fee.amount.net.value","typeLabel":"number | null"},"min":{"type":"number","description":"Lower bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.amount.net.min","typeLabel":"number"},"max":{"type":"number","description":"Upper bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.amount.net.max","typeLabel":"number"}},"required":["value","min","max"],"description":"Numeric value with min/max range. When the value depends on the buyer risk band and the band is not yet known, `value` is null and the range still indicates the bounds.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.amount.net","typeLabel":"object"},"tax":{"type":"object","properties":{"value":{"oneOf":[{"type":"number","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.amount.tax.value.oneOf.0","typeLabel":"number"},{"type":"null","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.amount.tax.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fees.financing.merchant_fee.amount.tax.value","typeLabel":"number | null"},"min":{"type":"number","description":"Lower bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.amount.tax.min","typeLabel":"number"},"max":{"type":"number","description":"Upper bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.amount.tax.max","typeLabel":"number"}},"required":["value","min","max"],"description":"Numeric value with min/max range. When the value depends on the buyer risk band and the band is not yet known, `value` is null and the range still indicates the bounds.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.amount.tax","typeLabel":"object"},"gross":{"type":"object","properties":{"value":{"oneOf":[{"type":"number","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.amount.gross.value.oneOf.0","typeLabel":"number"},{"type":"null","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.amount.gross.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fees.financing.merchant_fee.amount.gross.value","typeLabel":"number | null"},"min":{"type":"number","description":"Lower bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.amount.gross.min","typeLabel":"number"},"max":{"type":"number","description":"Upper bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.amount.gross.max","typeLabel":"number"}},"required":["value","min","max"],"description":"Numeric value with min/max range. When the value depends on the buyer risk band and the band is not yet known, `value` is null and the range still indicates the bounds.","isRequired":true,"uniqueKey":"fees.financing.merchant_fee.amount.gross","typeLabel":"object"}},"required":["net","tax","gross"],"isRequired":true,"uniqueKey":"fees.financing.merchant_fee.amount","typeLabel":"object"}},"required":["base_rate","daily_rate","total_rate","tax_rate","amount"],"isRequired":true,"uniqueKey":"fees.financing.merchant_fee","typeLabel":"object"}},"required":["merchant_fee"],"isRequired":true,"uniqueKey":"fees.financing","typeLabel":"object"},"insurance":{"type":"object","properties":{"merchant_fee":{"type":"object","properties":{"base_rate":{"type":"object","properties":{"value":{"oneOf":[{"type":"number","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.base_rate.value.oneOf.0","typeLabel":"number"},{"type":"null","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.base_rate.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.base_rate.value","typeLabel":"number | null"},"min":{"type":"number","description":"Lower bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.base_rate.min","typeLabel":"number"},"max":{"type":"number","description":"Upper bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.base_rate.max","typeLabel":"number"}},"required":["value","min","max"],"description":"Numeric value with min/max range. When the value depends on the buyer risk band and the band is not yet known, `value` is null and the range still indicates the bounds.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.base_rate","typeLabel":"object"},"daily_rate":{"type":"object","properties":{"value":{"oneOf":[{"type":"number","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.daily_rate.value.oneOf.0","typeLabel":"number"},{"type":"null","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.daily_rate.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.daily_rate.value","typeLabel":"number | null"},"min":{"type":"number","description":"Lower bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.daily_rate.min","typeLabel":"number"},"max":{"type":"number","description":"Upper bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.daily_rate.max","typeLabel":"number"}},"required":["value","min","max"],"description":"Numeric value with min/max range. When the value depends on the buyer risk band and the band is not yet known, `value` is null and the range still indicates the bounds.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.daily_rate","typeLabel":"object"},"total_rate":{"type":"object","properties":{"value":{"oneOf":[{"type":"number","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.total_rate.value.oneOf.0","typeLabel":"number"},{"type":"null","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.total_rate.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.total_rate.value","typeLabel":"number | null"},"min":{"type":"number","description":"Lower bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.total_rate.min","typeLabel":"number"},"max":{"type":"number","description":"Upper bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.total_rate.max","typeLabel":"number"}},"required":["value","min","max"],"description":"Numeric value with min/max range. When the value depends on the buyer risk band and the band is not yet known, `value` is null and the range still indicates the bounds.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.total_rate","typeLabel":"object"},"tax_rate":{"type":"object","properties":{"value":{"oneOf":[{"type":"number","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.tax_rate.value.oneOf.0","typeLabel":"number"},{"type":"null","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.tax_rate.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.tax_rate.value","typeLabel":"number | null"},"min":{"type":"number","description":"Lower bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.tax_rate.min","typeLabel":"number"},"max":{"type":"number","description":"Upper bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.tax_rate.max","typeLabel":"number"}},"required":["value","min","max"],"description":"Numeric value with min/max range. When the value depends on the buyer risk band and the band is not yet known, `value` is null and the range still indicates the bounds.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.tax_rate","typeLabel":"object"},"amount":{"type":"object","properties":{"net":{"type":"object","properties":{"value":{"oneOf":[{"type":"number","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.amount.net.value.oneOf.0","typeLabel":"number"},{"type":"null","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.amount.net.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.amount.net.value","typeLabel":"number | null"},"min":{"type":"number","description":"Lower bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.amount.net.min","typeLabel":"number"},"max":{"type":"number","description":"Upper bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.amount.net.max","typeLabel":"number"}},"required":["value","min","max"],"description":"Numeric value with min/max range. When the value depends on the buyer risk band and the band is not yet known, `value` is null and the range still indicates the bounds.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.amount.net","typeLabel":"object"},"tax":{"type":"object","properties":{"value":{"oneOf":[{"type":"number","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.amount.tax.value.oneOf.0","typeLabel":"number"},{"type":"null","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.amount.tax.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.amount.tax.value","typeLabel":"number | null"},"min":{"type":"number","description":"Lower bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.amount.tax.min","typeLabel":"number"},"max":{"type":"number","description":"Upper bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.amount.tax.max","typeLabel":"number"}},"required":["value","min","max"],"description":"Numeric value with min/max range. When the value depends on the buyer risk band and the band is not yet known, `value` is null and the range still indicates the bounds.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.amount.tax","typeLabel":"object"},"gross":{"type":"object","properties":{"value":{"oneOf":[{"type":"number","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.amount.gross.value.oneOf.0","typeLabel":"number"},{"type":"null","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.amount.gross.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.amount.gross.value","typeLabel":"number | null"},"min":{"type":"number","description":"Lower bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.amount.gross.min","typeLabel":"number"},"max":{"type":"number","description":"Upper bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.amount.gross.max","typeLabel":"number"}},"required":["value","min","max"],"description":"Numeric value with min/max range. When the value depends on the buyer risk band and the band is not yet known, `value` is null and the range still indicates the bounds.","isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.amount.gross","typeLabel":"object"}},"required":["net","tax","gross"],"isRequired":true,"uniqueKey":"fees.insurance.merchant_fee.amount","typeLabel":"object"}},"required":["base_rate","daily_rate","total_rate","tax_rate","amount"],"isRequired":true,"uniqueKey":"fees.insurance.merchant_fee","typeLabel":"object"}},"required":["merchant_fee"],"isRequired":true,"uniqueKey":"fees.insurance","typeLabel":"object"},"collection":{"type":"object","properties":{"merchant_fee":{"type":"object","properties":{"base_rate":{"type":"object","properties":{"value":{"oneOf":[{"type":"number","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.base_rate.value.oneOf.0","typeLabel":"number"},{"type":"null","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.base_rate.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fees.collection.merchant_fee.base_rate.value","typeLabel":"number | null"},"min":{"type":"number","description":"Lower bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.base_rate.min","typeLabel":"number"},"max":{"type":"number","description":"Upper bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.base_rate.max","typeLabel":"number"}},"required":["value","min","max"],"description":"Numeric value with min/max range. When the value depends on the buyer risk band and the band is not yet known, `value` is null and the range still indicates the bounds.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.base_rate","typeLabel":"object"},"daily_rate":{"type":"object","properties":{"value":{"oneOf":[{"type":"number","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.daily_rate.value.oneOf.0","typeLabel":"number"},{"type":"null","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.daily_rate.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fees.collection.merchant_fee.daily_rate.value","typeLabel":"number | null"},"min":{"type":"number","description":"Lower bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.daily_rate.min","typeLabel":"number"},"max":{"type":"number","description":"Upper bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.daily_rate.max","typeLabel":"number"}},"required":["value","min","max"],"description":"Numeric value with min/max range. When the value depends on the buyer risk band and the band is not yet known, `value` is null and the range still indicates the bounds.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.daily_rate","typeLabel":"object"},"total_rate":{"type":"object","properties":{"value":{"oneOf":[{"type":"number","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.total_rate.value.oneOf.0","typeLabel":"number"},{"type":"null","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.total_rate.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fees.collection.merchant_fee.total_rate.value","typeLabel":"number | null"},"min":{"type":"number","description":"Lower bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.total_rate.min","typeLabel":"number"},"max":{"type":"number","description":"Upper bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.total_rate.max","typeLabel":"number"}},"required":["value","min","max"],"description":"Numeric value with min/max range. When the value depends on the buyer risk band and the band is not yet known, `value` is null and the range still indicates the bounds.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.total_rate","typeLabel":"object"},"tax_rate":{"type":"object","properties":{"value":{"oneOf":[{"type":"number","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.tax_rate.value.oneOf.0","typeLabel":"number"},{"type":"null","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.tax_rate.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fees.collection.merchant_fee.tax_rate.value","typeLabel":"number | null"},"min":{"type":"number","description":"Lower bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.tax_rate.min","typeLabel":"number"},"max":{"type":"number","description":"Upper bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.tax_rate.max","typeLabel":"number"}},"required":["value","min","max"],"description":"Numeric value with min/max range. When the value depends on the buyer risk band and the band is not yet known, `value` is null and the range still indicates the bounds.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.tax_rate","typeLabel":"object"},"amount":{"type":"object","properties":{"net":{"type":"object","properties":{"value":{"oneOf":[{"type":"number","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.amount.net.value.oneOf.0","typeLabel":"number"},{"type":"null","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.amount.net.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fees.collection.merchant_fee.amount.net.value","typeLabel":"number | null"},"min":{"type":"number","description":"Lower bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.amount.net.min","typeLabel":"number"},"max":{"type":"number","description":"Upper bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.amount.net.max","typeLabel":"number"}},"required":["value","min","max"],"description":"Numeric value with min/max range. When the value depends on the buyer risk band and the band is not yet known, `value` is null and the range still indicates the bounds.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.amount.net","typeLabel":"object"},"tax":{"type":"object","properties":{"value":{"oneOf":[{"type":"number","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.amount.tax.value.oneOf.0","typeLabel":"number"},{"type":"null","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.amount.tax.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fees.collection.merchant_fee.amount.tax.value","typeLabel":"number | null"},"min":{"type":"number","description":"Lower bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.amount.tax.min","typeLabel":"number"},"max":{"type":"number","description":"Upper bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.amount.tax.max","typeLabel":"number"}},"required":["value","min","max"],"description":"Numeric value with min/max range. When the value depends on the buyer risk band and the band is not yet known, `value` is null and the range still indicates the bounds.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.amount.tax","typeLabel":"object"},"gross":{"type":"object","properties":{"value":{"oneOf":[{"type":"number","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.amount.gross.value.oneOf.0","typeLabel":"number"},{"type":"null","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.amount.gross.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"fees.collection.merchant_fee.amount.gross.value","typeLabel":"number | null"},"min":{"type":"number","description":"Lower bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.amount.gross.min","typeLabel":"number"},"max":{"type":"number","description":"Upper bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.amount.gross.max","typeLabel":"number"}},"required":["value","min","max"],"description":"Numeric value with min/max range. When the value depends on the buyer risk band and the band is not yet known, `value` is null and the range still indicates the bounds.","isRequired":true,"uniqueKey":"fees.collection.merchant_fee.amount.gross","typeLabel":"object"}},"required":["net","tax","gross"],"isRequired":true,"uniqueKey":"fees.collection.merchant_fee.amount","typeLabel":"object"}},"required":["base_rate","daily_rate","total_rate","tax_rate","amount"],"isRequired":true,"uniqueKey":"fees.collection.merchant_fee","typeLabel":"object"}},"required":["merchant_fee"],"isRequired":true,"uniqueKey":"fees.collection","typeLabel":"object"}},"required":["financing","insurance","collection"],"isRequired":true,"uniqueKey":"fees","typeLabel":"object"},"advance":{"type":"object","properties":{"value":{"type":"object","properties":{"value":{"oneOf":[{"type":"number","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"advance.value.value.oneOf.0","typeLabel":"number"},{"type":"null","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"advance.value.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"advance.value.value","typeLabel":"number | null"},"min":{"type":"number","description":"Lower bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"advance.value.min","typeLabel":"number"},"max":{"type":"number","description":"Upper bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"advance.value.max","typeLabel":"number"}},"required":["value","min","max"],"description":"Amount transferred to the merchant, in the smallest currency unit (e.g. cents). This is the configured advance rate applied to the invoice face, capped so fees and any holdback are not paid out.","isRequired":true,"uniqueKey":"advance.value","typeLabel":"object"},"rate":{"type":"object","properties":{"value":{"oneOf":[{"type":"number","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"advance.rate.value.oneOf.0","typeLabel":"number"},{"type":"null","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"advance.rate.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"advance.rate.value","typeLabel":"number | null"},"min":{"type":"number","description":"Lower bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"advance.rate.min","typeLabel":"number"},"max":{"type":"number","description":"Upper bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"advance.rate.max","typeLabel":"number"}},"required":["value","min","max"],"description":"Share of the invoice face this advance represents. Lower than the configured advance rate when fees cap the payout.","isRequired":true,"uniqueKey":"advance.rate","typeLabel":"object"}},"required":["value","rate"],"description":"Advance amount that would be paid out to the merchant for this invoice. Each number is a range across configured risk bands.","isRequired":true,"uniqueKey":"advance","typeLabel":"object"},"security":{"type":"object","properties":{"value":{"type":"object","properties":{"value":{"oneOf":[{"type":"number","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"security.value.value.oneOf.0","typeLabel":"number"},{"type":"null","description":"Exact value when known. Null when no risk band is available to resolve it.","isRequired":true,"uniqueKey":"security.value.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"security.value.value","typeLabel":"number | null"},"min":{"type":"number","description":"Lower bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"security.value.min","typeLabel":"number"},"max":{"type":"number","description":"Upper bound of the range across configured risk bands.","isRequired":true,"uniqueKey":"security.value.max","typeLabel":"number"}},"required":["value","min","max"],"description":"Amount held back from the merchant and released when the buyer pays, in the smallest currency unit. Zero when the advance already covers the invoice face after fees.","isRequired":true,"uniqueKey":"security.value","typeLabel":"object"}},"required":["value"],"description":"Holdback on this financing preview.","isRequired":true,"uniqueKey":"security","typeLabel":"object"},"amount":{"type":"integer","description":"Total amount of the invoice in cents.","isRequired":true,"uniqueKey":"amount","typeLabel":"integer"},"due_at":{"type":"number","description":"Timestamp indicating when the invoice should be paid.","example":1582896122,"isRequired":true,"uniqueKey":"due_at","typeLabel":"number"},"buyer_external_id":{"type":"string","maxLength":100,"pattern":"^[a-zA-Z0-9-_]+$","description":"Unique identifier of a related buyer.","isRequired":true,"uniqueKey":"buyer_external_id","typeLabel":"string"},"merchant_external_id":{"type":"string","maxLength":100,"pattern":"^[a-zA-Z0-9-_]+$","description":"Unique identifier of a related merchant.","isRequired":true,"uniqueKey":"merchant_external_id","typeLabel":"string"},"paid_out_at":{"oneOf":[{"type":"number","description":"Timestamp indicating when the invoice is actually paid.","example":1582896122,"uniqueKey":"paid_out_at.oneOf.0","typeLabel":"number"},{"type":"null","description":"Timestamp indicating when the invoice is actually paid.","example":1582896122,"uniqueKey":"paid_out_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"paid_out_at","typeLabel":"number | null"}},"required":["fees","advance","security","amount","due_at","buyer_external_id","merchant_external_id"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"fees":{"financing":{"merchant_fee":{"base_rate":{"value":123,"min":123,"max":123},"daily_rate":{"value":123,"min":123,"max":123},"total_rate":{"value":123,"min":123,"max":123},"tax_rate":{"value":123,"min":123,"max":123},"amount":{"net":{"value":123,"min":123,"max":123},"tax":{"value":123,"min":123,"max":123},"gross":{"value":123,"min":123,"max":123}}}},"insurance":{"merchant_fee":{"base_rate":{"value":123,"min":123,"max":123},"daily_rate":{"value":123,"min":123,"max":123},"total_rate":{"value":123,"min":123,"max":123},"tax_rate":{"value":123,"min":123,"max":123},"amount":{"net":{"value":123,"min":123,"max":123},"tax":{"value":123,"min":123,"max":123},"gross":{"value":123,"min":123,"max":123}}}},"collection":{"merchant_fee":{"base_rate":{"value":123,"min":123,"max":123},"daily_rate":{"value":123,"min":123,"max":123},"total_rate":{"value":123,"min":123,"max":123},"tax_rate":{"value":123,"min":123,"max":123},"amount":{"net":{"value":123,"min":123,"max":123},"tax":{"value":123,"min":123,"max":123},"gross":{"value":123,"min":123,"max":123}}}}},"advance":{"value":{"value":123,"min":123,"max":123},"rate":{"value":123,"min":123,"max":123}},"security":{"value":{"value":123,"min":123,"max":123}},"amount":123,"due_at":1582896122,"buyer_external_id":"\u003cstring>","merchant_external_id":"\u003cstring>","paid_out_at":1582896122}}},"exampleType":"generated"}},"exampleType":"generated"},"04dd6dfe-c51a-4aad-b9a4-1076d6d31cd2":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Error code","example":"BAD_REQUEST","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"error":{"type":"string","description":"Error message for debugging purposes","example":"Request validation failed. 1 issue found.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Issue code","example":"INVALID_TYPE","isRequired":true,"uniqueKey":"issues.items.[INDEX].code","typeLabel":"string"},"path":{"type":"string","description":"Issue path starting with body, params, querystring, or headers","example":"body.registered_at","isRequired":true,"uniqueKey":"issues.items.[INDEX].path","typeLabel":"string"},"message":{"type":"string","description":"Issue message for debugging purposes","example":"Invalid type","isRequired":true,"uniqueKey":"issues.items.[INDEX].message","typeLabel":"string"}},"required":["code","path","message"],"uniqueKey":"issues.items.[INDEX]","typeLabel":"object"},"description":"List of issues","example":[{"code":"INVALID_TYPE","path":"body.registered_at","message":"Invalid type"}],"isRequired":true,"uniqueKey":"issues","typeLabel":"object[]"}},"required":["code","error","issues"],"description":"Bad Request, see error message for details.","example":{"code":"BAD_REQUEST","error":"Request validation failed. 1 issue found.","issues":[{"code":"INVALID_TYPE","path":"body.registered_at","message":"Invalid type"}]},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"BAD_REQUEST","error":"Request validation failed. 1 issue found.","issues":[{"code":"INVALID_TYPE","path":"body.registered_at","message":"Invalid type"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"631b36f1-4514-4b14-a535-a8d190a6bcca":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error details.","example":"Unauthorized","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Error code.","example":"UNAUTHORIZED","isRequired":true,"uniqueKey":"code","typeLabel":"string"}},"required":["error","code"],"description":"Unauthorized Request.","example":{"error":"Unauthorized","code":"UNAUTHORIZED"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Unauthorized","code":"UNAUTHORIZED"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"d70300ba-a5d5-4206-aa7f-6494fa9fc0af":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Your Tilta API key, sent as `Bearer \u003ckey>`.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"0d16876d-c42e-4739-9cb6-74ddf3bb3f66":{"url":"https://api.tilta.io","description":"Tilta Production API"},"a8fd5e82-bae4-4987-aed3-5d5342202f75":{"url":"https://api.tilta-sandbox.io","description":"Tilta Sandbox API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Your Tilta API key, sent as `Bearer \u003ckey>`.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Your Tilta API key, sent as `Bearer \u003ckey>`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.yml"},"subdomain":"tilta","siteName":"Tilta","title":"Calculate fees - Tilta","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-06T16:40:26.548Z","originalFileLocation":"api-reference/invoices/calculate-fees.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=\"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=\"Calculate the exact buyer and merchant fees for a proposed invoice. Use this before capturing financing to show transparent fee amounts at checkout.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Tilta\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tilta/_zj8nRvZJCBo9Rnw/_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/tilta/_zj8nRvZJCBo9Rnw/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tilta/_zj8nRvZJCBo9Rnw/_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/tilta/_zj8nRvZJCBo9Rnw/_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/tilta/_zj8nRvZJCBo9Rnw/_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/tilta/_zj8nRvZJCBo9Rnw/_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/tilta/_zj8nRvZJCBo9Rnw/_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/tilta/_zj8nRvZJCBo9Rnw/_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/tilta/_zj8nRvZJCBo9Rnw/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Calculate fees - Tilta\">\u003cmeta data-mint-head property=\"og:description\" content=\"Calculate the exact buyer and merchant fees for a proposed invoice. Use this before capturing financing to show transparent fee amounts at checkout.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Tilta\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.tilta.ai/api-reference/invoices/calculate-fees\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tilta.mintlify.site/_mintlify/api/og/v2?division=Invoices\u0026amp;title=Calculate+fees\u0026amp;description=Calculate+the+exact+buyer+and+merchant+fees+for+a+proposed+invoice.+Use+this+before+capturing+financing+to+show+transparent+fee+amounts+at+checkout.\u0026amp;theme=f3f102f26ce2dce4c4ff02d0\u0026amp;signature=8c3bbf0dcdca6b1d347b6a8d06cbb9e5f55ed58195ce5186ead83fb8a3e90ce7\">\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=\"Calculate fees - Tilta\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Calculate the exact buyer and merchant fees for a proposed invoice. Use this before capturing financing to show transparent fee amounts at checkout.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tilta.mintlify.site/_mintlify/api/og/v2?division=Invoices\u0026amp;title=Calculate+fees\u0026amp;description=Calculate+the+exact+buyer+and+merchant+fees+for+a+proposed+invoice.+Use+this+before+capturing+financing+to+show+transparent+fee+amounts+at+checkout.\u0026amp;theme=f3f102f26ce2dce4c4ff02d0\u0026amp;signature=8c3bbf0dcdca6b1d347b6a8d06cbb9e5f55ed58195ce5186ead83fb8a3e90ce7\">\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/tilta/_zj8nRvZJCBo9Rnw/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Tilta\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7563E4\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.tilta.ai/api-reference/invoices/calculate-fees\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/invoices/calculate-fees.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.tilta.ai/#organization\",\"name\":\"Tilta\",\"url\":\"https://docs.tilta.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tilta/9uQVAt1ClfFJqI9c/images/wordmark_positive_nopadding.svg?fit=max\u0026auto=format\u0026n=9uQVAt1ClfFJqI9c\u0026q=85\u0026s=2d77f76ffd19a7569d9f4281c2c7d985\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.tilta.ai#website\",\"name\":\"Tilta\",\"url\":\"https://docs.tilta.ai\",\"publisher\":{\"@id\":\"https://docs.tilta.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.tilta.ai/api-reference/invoices/calculate-fees#webpage\",\"url\":\"https://docs.tilta.ai/api-reference/invoices/calculate-fees\",\"name\":\"Calculate fees\",\"description\":\"Calculate the exact buyer and merchant fees for a proposed invoice. Use this before capturing financing to show transparent fee amounts at checkout.\",\"dateModified\":\"2026-10-06T16:40:26.548Z\",\"isPartOf\":{\"@id\":\"https://docs.tilta.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.tilta.ai/api-reference/invoices/calculate-fees#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.tilta.ai/api-reference/invoices/calculate-fees#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Invoices\",\"item\":\"https://docs.tilta.ai/api-reference/invoices/create-invoice\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Calculate fees\",\"item\":\"https://docs.tilta.ai/api-reference/invoices/calculate-fees\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.tilta.ai/api-reference/invoices/calculate-fees#apireference\",\"headline\":\"Calculate fees\",\"name\":\"Calculate fees\",\"description\":\"Calculate the exact buyer and merchant fees for a proposed invoice. Use this before capturing financing to show transparent fee amounts at checkout.\",\"url\":\"https://docs.tilta.ai/api-reference/invoices/calculate-fees\",\"mainEntityOfPage\":{\"@id\":\"https://docs.tilta.ai/api-reference/invoices/calculate-fees#webpage\"},\"dateModified\":\"2026-10-06T16:40:26.548Z\",\"keywords\":\"buyer fee, merchant fee, agio, disagio, checkout\",\"publisher\":{\"@id\":\"https://docs.tilta.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.tilta.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Tilta\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Tilta\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/invoices/calculate-fees.md","siteName":"Tilta","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/docs/introduction"}]},{"tab":"API Reference","groups":[{"group":"Buyers","pages":[{"title":"Create a buyer","sidebarTitle":"Create buyer","openapi":"POST /v1/buyers","href":"/api-reference/buyers/create-buyer"},{"title":"Retrieve a buyer","sidebarTitle":"Retrieve buyer","openapi":"GET /v1/buyers/{external_id}","href":"/api-reference/buyers/retrieve-buyer"},{"title":"List buyers","sidebarTitle":"List buyers","openapi":"GET /v1/buyers","href":"/api-reference/buyers/list-buyers"},{"title":"Search buyers","sidebarTitle":"Search buyers","openapi":"GET /v1/buyers/search","href":"/api-reference/buyers/search-buyers"},{"title":"Replace a buyer","sidebarTitle":"Replace buyer","openapi":"PUT /v1/buyers/{external_id}","href":"/api-reference/buyers/replace-buyer"},{"title":"Export buyers","sidebarTitle":"Export buyers","openapi":"GET /v1/buyers/export/csv","href":"/api-reference/buyers/export-buyers"},{"title":"Retrieve buyer settings","sidebarTitle":"Retrieve buyer settings","openapi":"GET /v1/buyers/{external_id}/settings","href":"/api-reference/buyers/retrieve-buyer-settings"},{"title":"Replace buyer settings","sidebarTitle":"Replace buyer settings","openapi":"PUT /v1/buyers/{external_id}/settings","href":"/api-reference/buyers/replace-buyer-settings"},{"title":"Create an onboarding session","sidebarTitle":"Onboarding session","openapi":"POST /v1/buyers/{external_id}/sessions/onboarding","href":"/api-reference/buyers/buyer-onboarding-session"}]},{"group":"Credit Facilities","pages":[{"title":"Request a credit facility","sidebarTitle":"Create facility","openapi":"POST /v1/buyers/{external_id}/facility","href":"/api-reference/facilities/create-facility"},{"title":"Retrieve a credit facility","sidebarTitle":"Retrieve facility","openapi":"GET /v1/buyers/{external_id}/facility","href":"/api-reference/facilities/retrieve-facility"},{"title":"List credit facilities","sidebarTitle":"List facilities","openapi":"GET /v1/facilities","href":"/api-reference/facilities/list-facilities"},{"title":"Request a facility increase","sidebarTitle":"Request increase","openapi":"POST /v1/buyers/{external_id}/facility/increase","href":"/api-reference/facilities/request-increase"},{"title":"Request a facility renewal","sidebarTitle":"Request renewal","openapi":"POST /v1/buyers/{external_id}/facility/renew","href":"/api-reference/facilities/request-renewal"}]},{"group":"Orders","pages":[{"title":"Create an order","sidebarTitle":"Create order","openapi":"POST /v1/orders","href":"/api-reference/orders/create-order"},{"title":"Create a draft order","sidebarTitle":"Create draft order","openapi":"POST /v1/orders/draft","href":"/api-reference/orders/create-draft-order"},{"title":"Retrieve an order","sidebarTitle":"Retrieve order","openapi":"GET /v1/orders/{external_id}","href":"/api-reference/orders/retrieve-order"},{"title":"List orders","sidebarTitle":"List orders","openapi":"GET /v1/orders","href":"/api-reference/orders/list-orders"},{"title":"Search orders","sidebarTitle":"Search orders","openapi":"GET /v1/orders/search","href":"/api-reference/orders/search-orders"},{"title":"Replace an order","sidebarTitle":"Replace order","openapi":"PUT /v1/orders/{external_id}","href":"/api-reference/orders/replace-order"},{"title":"Transition an order","sidebarTitle":"Transition order","openapi":"POST /v1/orders/{external_id}/transition","href":"/api-reference/orders/transition-order"},{"title":"Create a checkout session","sidebarTitle":"Checkout session","openapi":"POST /v1/orders/{external_id}/sessions/checkout","href":"/api-reference/orders/checkout-session"}]},{"group":"Invoices","pages":[{"title":"Create an invoice","sidebarTitle":"Create invoice","openapi":"POST /v1/invoices","href":"/api-reference/invoices/create-invoice"},{"title":"Retrieve an invoice","sidebarTitle":"Retrieve invoice","openapi":"GET /v1/invoices/{external_id}","href":"/api-reference/invoices/retrieve-invoice"},{"title":"List invoices","sidebarTitle":"List invoices","openapi":"GET /v1/invoices","href":"/api-reference/invoices/list-invoices"},{"title":"Search invoices","sidebarTitle":"Search invoices","openapi":"GET /v1/invoices/search","href":"/api-reference/invoices/search-invoices"},{"title":"Update an invoice","sidebarTitle":"Update invoice","openapi":"PUT /v1/invoices/{external_id}","href":"/api-reference/invoices/update-invoice"},{"title":"Mark an invoice as paid","sidebarTitle":"Mark paid","openapi":"POST /v1/invoices/{external_id}/paid","href":"/api-reference/invoices/mark-paid"},{"title":"Refund an invoice","sidebarTitle":"Refund invoice","description":"Refund a captured invoice in full or partially. Use when goods are returned or cancelled post-invoice. Reverses financing and adjusts merchant payouts.","openapi":"POST /v1/invoices/{external_id}/refund","href":"/api-reference/invoices/refund-invoice"},{"title":"Calculate fees","sidebarTitle":"Calculate fees","openapi":"POST /v1/invoices/calculate_fees","href":"/api-reference/invoices/calculate-fees"},{"title":"Upload an invoice file","sidebarTitle":"Upload file","description":"Attach a file to an invoice – such as the PDF invoice document. Uploaded files are associated with the invoice and stored securely by Tilta.","openapi":"POST /v1/invoices/{external_id}/files","href":"/api-reference/invoices/upload-file"},{"title":"Export invoices","sidebarTitle":"Export CSV","openapi":"GET /v1/invoices/export/csv","href":"/api-reference/invoices/export-invoices"}]},{"group":"Merchants","pages":[{"title":"Create a merchant","sidebarTitle":"Create merchant","openapi":"POST /v1/merchants","href":"/api-reference/merchants/create-merchant"},{"title":"Retrieve a merchant","sidebarTitle":"Retrieve merchant","openapi":"GET /v1/merchants/{external_id}","href":"/api-reference/merchants/retrieve-merchant"},{"title":"List merchants","sidebarTitle":"List merchants","openapi":"GET /v1/merchants","href":"/api-reference/merchants/list-merchants"},{"title":"Replace a merchant","sidebarTitle":"Replace merchant","openapi":"PUT /v1/merchants/{external_id}","href":"/api-reference/merchants/replace-merchant"},{"title":"List representatives","sidebarTitle":"List representatives","openapi":"GET /v1/merchants/{external_id}/representatives","href":"/api-reference/merchants/list-representatives"},{"title":"Add a representative","sidebarTitle":"Add representative","openapi":"POST /v1/merchants/{external_id}/representatives","href":"/api-reference/merchants/add-representative"},{"title":"Remove a representative","sidebarTitle":"Remove representative","openapi":"DELETE /v1/merchants/{external_id}/representatives/{person_external_id}","href":"/api-reference/merchants/remove-representative"},{"title":"List owners","sidebarTitle":"List owners","openapi":"GET /v1/merchants/{external_id}/owners","href":"/api-reference/merchants/list-owners"},{"title":"Add an owner","sidebarTitle":"Add owner","openapi":"POST /v1/merchants/{external_id}/owners","href":"/api-reference/merchants/add-owner"},{"title":"Remove an owner","sidebarTitle":"Remove owner","openapi":"DELETE /v1/merchants/{external_id}/owners/{person_external_id}","href":"/api-reference/merchants/remove-owner"},{"title":"List payout instructions","sidebarTitle":"List payout instructions","openapi":"GET /v1/payout_instructions","href":"/api-reference/merchants/list-payout-instructions"},{"title":"Create a payout instruction","sidebarTitle":"Create payout instruction","openapi":"POST /v1/payout_instructions","href":"/api-reference/merchants/create-payout-instruction"},{"title":"Retrieve a payout instruction","sidebarTitle":"Retrieve payout instruction","openapi":"GET /v1/payout_instructions/{external_id}","href":"/api-reference/merchants/retrieve-payout-instruction"},{"title":"Replace a payout instruction","sidebarTitle":"Replace payout instruction","openapi":"PUT /v1/payout_instructions/{external_id}","href":"/api-reference/merchants/replace-payout-instruction"},{"title":"Delete a payout instruction","sidebarTitle":"Delete payout instruction","openapi":"DELETE /v1/payout_instructions/{external_id}","href":"/api-reference/merchants/delete-payout-instruction"},{"title":"List mandates","sidebarTitle":"List mandates","openapi":"GET /v1/merchants/{external_id}/mandates","href":"/api-reference/merchants/list-mandates"},{"title":"Create a mandate","sidebarTitle":"Create mandate","openapi":"POST /v1/merchants/{external_id}/mandates","href":"/api-reference/merchants/create-mandate"}]},{"group":"Contacts \u0026 Persons","pages":[{"title":"Create a contact","sidebarTitle":"Create contact","openapi":"POST /v1/contacts","href":"/api-reference/contacts/create-contact"},{"title":"Retrieve a contact","sidebarTitle":"Retrieve contact","openapi":"GET /v1/contacts/{external_id}","href":"/api-reference/contacts/retrieve-contact"},{"title":"Replace a contact","sidebarTitle":"Replace contact","openapi":"PUT /v1/contacts/{external_id}","href":"/api-reference/contacts/replace-contact"},{"title":"Delete a contact","sidebarTitle":"Delete contact","openapi":"DELETE /v1/contacts/{external_id}","href":"/api-reference/contacts/delete-contact"},{"title":"Create a person","sidebarTitle":"Create person","openapi":"POST /v1/persons","href":"/api-reference/persons/create-person"},{"title":"Retrieve a person","sidebarTitle":"Retrieve person","openapi":"GET /v1/persons/{external_id}","href":"/api-reference/persons/retrieve-person"},{"title":"Replace a person","sidebarTitle":"Replace person","openapi":"PUT /v1/persons/{external_id}","href":"/api-reference/persons/replace-person"}]},{"group":"Webhooks","pages":[{"title":"Create a subscription","sidebarTitle":"Create subscription","openapi":"POST /v1/webhooks","href":"/api-reference/webhooks/create-subscription"},{"title":"List subscriptions","sidebarTitle":"List subscriptions","openapi":"GET /v1/webhooks","href":"/api-reference/webhooks/list-subscriptions"},{"title":"Replace a subscription","sidebarTitle":"Replace subscription","openapi":"PUT /v1/webhooks/{type}","href":"/api-reference/webhooks/replace-subscription"},{"title":"Delete a subscription","sidebarTitle":"Delete subscription","openapi":"POST /v1/webhooks/{type}/unsubscribe","href":"/api-reference/webhooks/delete-subscription"},{"title":"Rotate the signature key","sidebarTitle":"Rotate signature key","openapi":"POST /v1/webhooks/{type}/signature_key","href":"/api-reference/webhooks/rotate-signature-key"}]},{"group":"Platform \u0026 Utilities","pages":[{"title":"Retrieve the platform","sidebarTitle":"Retrieve platform","openapi":"GET /v1/platform","href":"/api-reference/platform/retrieve-platform"},{"title":"Retrieve payment terms","sidebarTitle":"Payment terms","openapi":"GET /v1/platform/payment_terms","href":"/api-reference/platform/payment-terms"},{"title":"Search businesses","sidebarTitle":"Search businesses","openapi":"GET /v1/businesses/search","href":"/api-reference/utilities/search-businesses"},{"title":"List legal forms","sidebarTitle":"Legal forms","openapi":"GET /v1/legal_forms","href":"/api-reference/utilities/legal-forms"},{"title":"Check service requirements","sidebarTitle":"Service requirements","openapi":"GET /v1/invoices/{external_id}/services/{service_type}/requirements","href":"/api-reference/utilities/invoice-service-requirements"},{"title":"Request a service","sidebarTitle":"Request service","openapi":"POST /v1/services","href":"/api-reference/utilities/create-invoice-service"},{"title":"Retrieve a service","sidebarTitle":"Retrieve service","openapi":"GET /v1/services/{external_id}","href":"/api-reference/utilities/retrieve-invoice-service"},{"title":"List services","sidebarTitle":"List services","openapi":"GET /v1/invoices/{external_id}/services","href":"/api-reference/utilities/list-invoice-services"}]}]}]},"basePath":"","title":"Calculate fees - Tilta","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}