An intermediary integration lets a platform (a payment orchestrator, marketplace, or agency) create Float checkouts on behalf of many merchants using a single set of API credentials. Your Bearer token identifies you as the intermediary; the target merchant is addressed explicitly.
Intermediary access is provisioned by Float — contact your account manager to have your integration flagged as an intermediary and to onboard the merchants you represent.
Get a managed merchant’s config
Identical to GET /api/config, but addressed to a specific merchant you manage.
string
required
The Float merchant identifier for the managed merchant, provided during that merchant’s onboarding.
Rate limited to 5 requests per hour per config — cache per merchant.
Errors
HTTP
When
401
Bad Bearer token
404
The merchant isn’t managed by your intermediary integration
Everything else works the same
Checkouts, callbacks, and refunds use the same endpoints and semantics documented across this reference. A dedicated intermediary OpenAPI spec is also published at /api-docs-intermediary on each environment.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Float Developer Documentation","description":"Integrate Float's interest-free instalment payments into your store or platform.","colors":{"primary":"#EF0F60","light":"#F096B2","dark":"#252680"},"logo":{"light":"https://mintcdn.com/choosefloat/DLyfu7lA9RBM1J5s/logo/light.svg?fit=max\u0026auto=format\u0026n=DLyfu7lA9RBM1J5s\u0026q=85\u0026s=5d98da1476e1f537ec30be4f4248e36c","dark":"https://mintcdn.com/choosefloat/DLyfu7lA9RBM1J5s/logo/dark.svg?fit=max\u0026auto=format\u0026n=DLyfu7lA9RBM1J5s\u0026q=85\u0026s=f4b6913aab751f86a0d30211f9547c9a"},"favicon":"https://mintcdn.com/choosefloat/DLyfu7lA9RBM1J5s/favicon.svg?fit=max\u0026auto=format\u0026n=DLyfu7lA9RBM1J5s\u0026q=85\u0026s=eeb2afb907162439cd8e2dfeca5bda60","api":{"playground":{"display":"interactive"},"mdx":{"auth":{"method":"bearer"},"server":["https://uat-secure.choosefloat.com","https://secure.choosefloat.com"]}},"navbar":{"links":[{"href":"https://secure.choosefloat.com","label":"Merchant Portal"}],"primary":{"type":"button","label":"Get API Keys","href":"mailto:integrations@choosefloat.com?subject=API%20credentials%20request"}},"footer":{"socials":{"website":"https://www.choosefloat.com"}},"contextual":{"options":["copy","view","claude","chatgpt"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"choosefloat","hasAudioNarration":false,"actualSubdomain":"choosefloat","customDomains":["docs.choosefloat.com"],"gitSource":{"type":"github","owner":"choosefloat","repo":"docs","deployBranch":"main","contentDirectory":"uk","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6afc4f2bae9e0cb848c2f7fb","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"🇬🇧 United Kingdom","count":22},{"language":"default","tag":"Documentation","count":12},{"language":"default","tag":"API Reference","count":10},{"language":"default","tag":"Integration Guides","count":8},{"language":"default","tag":"Getting Started","count":4},{"language":"default","tag":"Checkouts","count":3},{"language":"default","tag":"Refunds","count":3},{"language":"default","tag":"Merchant Config","count":2},{"language":"default","tag":"Webhooks","count":1},{"language":"default","tag":"Concepts","count":1}]},"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":"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":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/intermediaries","slug":"/api-reference/intermediaries","pageMetadata":{"title":"Intermediaries","description":"For platforms integrating Float on behalf of multiple merchants.","api":"GET /api/merchants/{merchant_id}/config","href":"/api-reference/intermediaries"},"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: \"For platforms integrating Float on behalf of multiple merchants.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,ParamField,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`An `,_jsx(_components.strong,{children:`intermediary`}),` integration lets a platform (a payment orchestrator, marketplace, or agency) create Float checkouts on behalf of many merchants using a single set of API credentials. Your Bearer token identifies you as the intermediary; the target merchant is addressed explicitly.`]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Intermediary access is provisioned by Float — contact your account manager to have your integration flagged as an intermediary and to onboard the merchants you represent.`})}),`\n`,_jsx(Heading,{level:`2`,id:`get-a-managed-merchant’s-config`,children:`Get a managed merchant’s config`}),`\n`,_jsxs(_components.p,{children:[`Identical to `,_jsx(_components.a,{href:`/api-reference/get-config`,children:_jsx(_components.code,{children:`GET /api/config`})}),`, but addressed to a specific merchant you manage.`]}),`\n`,_jsx(ParamField,{path:`merchant_id`,type:`string`,required:true,id:`param-merchant-id`,children:_jsx(_components.p,{children:`The Float merchant identifier for the managed merchant, provided during that merchant’s onboarding.`})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://uat-secure.choosefloat.com/api/merchants/12345678-1111-1111-1111-1234567890ab/config`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$FLOAT_CLIENT_SECRET`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`})]}),`\n`]})})}),`\n`,_jsx(CodeBlock,{filename:`200`,numberOfLines:`12`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`12`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"12345678-1111-1111-1111-1234567890ab\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"merchants\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"attributes\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"South Park Cows Merch\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"rules\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"from_amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`10000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"to_amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`100000000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"terms\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`4`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`5`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`6`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`] }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Rate limited to `,_jsx(_components.strong,{children:`5 requests per hour`}),` per config — cache per merchant.`]}),`\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:`HTTP`}),_jsx(_components.th,{children:`When`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`401`})}),_jsx(_components.td,{children:`Bad Bearer token`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsx(_components.td,{children:`The merchant isn’t managed by your intermediary integration`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`everything-else-works-the-same`,children:`Everything else works the same`}),`\n`,_jsxs(_components.p,{children:[`Checkouts, callbacks, and refunds use the same endpoints and semantics documented across this reference. A dedicated intermediary OpenAPI spec is also published at `,_jsx(_components.code,{children:`/api-docs-intermediary`}),` on each environment.`]})]})}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":"Intermediaries","description":"For platforms integrating Float on behalf of multiple merchants.","api":"GET /api/merchants/{merchant_id}/config","href":"/api-reference/intermediaries"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Get a managed merchant’s config","slug":"get-a-managed-merchant’s-config","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[]},{"title":"Everything else works the same","slug":"everything-else-works-the-same","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"Intermediaries","path":"/api/merchants/{merchant_id}/config","servers":[{"url":"https://uat-secure.choosefloat.com"},{"url":"https://secure.choosefloat.com"}],"method":"get","request":{"security":[{"title":"Bearer Auth","parameters":{"header":{"Authorization":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token."}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{},"cookie":{},"path":{"merchant_id":{"schema":[{"type":"string","description":"The Float merchant identifier for the managed merchant, provided during that merchant’s onboarding.","required":true}]}}},"body":{}},"response":{},"deprecated":false}},"jsLinks":[],"subdomain":"choosefloat","siteName":"Float Developer Documentation","title":"Intermediaries - Float Developer Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-22T10:07:05.957Z","originalFileLocation":"api-reference/intermediaries.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=\"For platforms integrating Float on behalf of multiple merchants.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Float Developer Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/choosefloat/F-QFJwj5tcDMBYSe/_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/choosefloat/F-QFJwj5tcDMBYSe/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/choosefloat/F-QFJwj5tcDMBYSe/_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/choosefloat/F-QFJwj5tcDMBYSe/_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/choosefloat/F-QFJwj5tcDMBYSe/_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/choosefloat/F-QFJwj5tcDMBYSe/_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/choosefloat/F-QFJwj5tcDMBYSe/_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/choosefloat/F-QFJwj5tcDMBYSe/_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/choosefloat/F-QFJwj5tcDMBYSe/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Intermediaries - Float Developer Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"For platforms integrating Float on behalf of multiple merchants.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Float Developer Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.choosefloat.com/api-reference/intermediaries\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://choosefloat.mintlify.site/_mintlify/api/og/v2?division=Merchant+Config\u0026amp;title=Intermediaries\u0026amp;description=For+platforms+integrating+Float+on+behalf+of+multiple+merchants.\u0026amp;theme=7729f7e0db976a20aad3d8ad\u0026amp;signature=d8c1e346c8bc66e05bd6989c4746345dec183363cdc53842b9d903b87b80327b\">\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=\"Intermediaries - Float Developer Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"For platforms integrating Float on behalf of multiple merchants.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://choosefloat.mintlify.site/_mintlify/api/og/v2?division=Merchant+Config\u0026amp;title=Intermediaries\u0026amp;description=For+platforms+integrating+Float+on+behalf+of+multiple+merchants.\u0026amp;theme=7729f7e0db976a20aad3d8ad\u0026amp;signature=d8c1e346c8bc66e05bd6989c4746345dec183363cdc53842b9d903b87b80327b\">\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/choosefloat/F-QFJwj5tcDMBYSe/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Float Developer Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#EF0F60\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.choosefloat.com/api-reference/intermediaries\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/intermediaries.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.choosefloat.com/#organization\",\"name\":\"Float Developer Documentation\",\"url\":\"https://docs.choosefloat.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/choosefloat/DLyfu7lA9RBM1J5s/logo/light.svg?fit=max\u0026auto=format\u0026n=DLyfu7lA9RBM1J5s\u0026q=85\u0026s=5d98da1476e1f537ec30be4f4248e36c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.choosefloat.com#website\",\"name\":\"Float Developer Documentation\",\"url\":\"https://docs.choosefloat.com\",\"publisher\":{\"@id\":\"https://docs.choosefloat.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.choosefloat.com/api-reference/intermediaries#webpage\",\"url\":\"https://docs.choosefloat.com/api-reference/intermediaries\",\"name\":\"Intermediaries\",\"description\":\"For platforms integrating Float on behalf of multiple merchants.\",\"dateModified\":\"2026-07-22T10:07:05.957Z\",\"isPartOf\":{\"@id\":\"https://docs.choosefloat.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.choosefloat.com/api-reference/intermediaries#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.choosefloat.com/api-reference/intermediaries#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Merchant Config\",\"item\":\"https://docs.choosefloat.com/api-reference/get-config\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Intermediaries\",\"item\":\"https://docs.choosefloat.com/api-reference/intermediaries\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.choosefloat.com/api-reference/intermediaries#apireference\",\"headline\":\"Intermediaries\",\"name\":\"Intermediaries\",\"description\":\"For platforms integrating Float on behalf of multiple merchants.\",\"url\":\"https://docs.choosefloat.com/api-reference/intermediaries\",\"mainEntityOfPage\":{\"@id\":\"https://docs.choosefloat.com/api-reference/intermediaries#webpage\"},\"dateModified\":\"2026-07-22T10:07:05.957Z\",\"publisher\":{\"@id\":\"https://docs.choosefloat.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.choosefloat.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Float Developer Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Float Developer Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/intermediaries.md","siteName":"Float Developer Documentation","nav":{"global":null,"dropdowns":[{"dropdown":"🇬🇧 United Kingdom","tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Getting Started","pages":[{"title":"API overview","href":"/api-reference/overview"}]},{"group":"Merchant Config","pages":[{"title":"Get merchant config","description":"GET /api/config — your merchant profile and available instalment terms.","api":"GET /api/config","href":"/api-reference/get-config"},{"title":"Intermediaries","api":"GET /api/merchants/{merchant_id}/config","href":"/api-reference/intermediaries"}]},{"group":"Checkouts","pages":[{"title":"Create a checkout","description":"POST /api/checkouts — create a payment session and get the hosted payment URL.","api":"POST /api/checkouts","href":"/api-reference/create-checkout"},{"title":"Get a checkout","api":"GET /api/checkouts/{id}","href":"/api-reference/get-checkout"},{"title":"List checkouts","api":"GET /api/checkouts","href":"/api-reference/list-checkouts"}]},{"group":"Refunds","pages":[{"title":"Create a refund","api":"POST /api/refunds","href":"/api-reference/create-refund"},{"title":"Get a refund","api":"GET /api/refunds/{id}","href":"/api-reference/get-refund"},{"title":"List refunds","api":"GET /api/refunds","href":"/api-reference/list-refunds"}]},{"group":"Webhooks","pages":[{"title":"Payment callback","href":"/api-reference/payment-callback"}]}]}]},{"dropdown":"🇿🇦 South Africa","href":"https://docs.float.co.za"}]},"basePath":"","title":"Intermediaries - Float Developer Documentation","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-BgGj2PGS.js","utils-BhNOqRKb.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BAgRNUZo.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CGkb0TPw.js","snippetPresets-ChLkL1a6.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-Ef10Jrbx.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DlVCnjU8.js","shallow-BA55zJxQ.js","getApiPlaygroundDisplay-DR09dKtp.js","CodeSnippet-BZ8J8Kll.js","CodeSnippets-CcguVheG.js","Page-C7x-eUfk.js","getPastedJson-D5UqeqBp.js","icon-DpD0l99C.js","MethodPill-Wg2NXsp_.js","DuplicateIcon-CCSyX8lh.js","createIcon-C4Ukv9HX.js","DynamicMarkdown-RhjEuCHC.js","SectionHeading-DL1MykRq.js","axios-vUo_bRtp.js"]}