The refund request ID — persist it and poll get refund to track completion.
string
Starts at requested; progresses through pending to complete (or failed). See the refund lifecycle.
Errors
HTTP
When
Example detail
400
Signature mismatch
Request signature does not match...
401
Bad Bearer token
404
Unknown checkout_id
422
Outside the 100-day refund window
Orders can only be refunded within 100 days of the purchase date.
422
Same-day refund on an auto-refund integration
Order can't be refunded on the day of purchase.
422
Amount exceeds the refundable remainder
429
More than 1 request per second
{"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":"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/create-refund","slug":"/api-reference/create-refund","pageMetadata":{"title":"Create a refund","description":"POST /api/refunds — request a full or partial refund for a checkout.","api":"POST /api/refunds","href":"/api-reference/create-refund"},"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: \"POST /api/refunds — request a full or partial refund for a 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={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,ResponseField,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Creates an asynchronous refund request against a successful checkout. See the `,_jsx(_components.a,{href:`/guides/refunds`,children:`refunds guide`}),` for the lifecycle and constraints.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Rate limited to `,_jsx(_components.strong,{children:`1 request per second`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`request`,children:`Request`}),`\n`,_jsxs(_components.p,{children:[`Headers: `,_jsx(_components.code,{children:`Authorization: Bearer \u003cclient_secret>`}),`, `,_jsx(_components.code,{children:`Content-Type: application/json`}),`, and `,_jsx(_components.code,{children:`X-Signature`}),` (`,_jsx(_components.a,{href:`/authentication#request-signing`,children:`request signing`}),`).`]}),`\n`,_jsx(ParamField,{body:`checkout_id`,type:`string (uuid)`,required:true,id:`param-checkout-id`,children:_jsxs(_components.p,{children:[`The ID of the checkout to refund — the `,_jsx(_components.code,{children:`data.id`}),` from `,_jsx(_components.a,{href:`/api-reference/create-checkout`,children:`create checkout`}),`.`]})}),`\n`,_jsx(ParamField,{body:`amount`,type:`integer`,required:true,id:`param-amount`,children:_jsx(_components.p,{children:`Amount to refund, in pence. Up to the checkout amount minus any previously refunded amounts. Partial refunds are supported; issue several if needed.`})}),`\n`,_jsx(Heading,{level:`3`,id:`example`,children:`Example`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,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:`8`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://uat-secure.choosefloat.com/api/refunds`}),_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:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Signature: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$SIGNATURE`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"checkout_id\": \"9b2f61c4-6c1e-4b7a-9a1d-3f2a8c0de111\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"amount\": 100000`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\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:`\"5d1a7c9e-2222-4444-8888-aa11bb22cc33\"`}),_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:`\"refund_requests\"`}),_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:` \"amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`100000`}),_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:` \"currency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"GBP\"`}),_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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"requested\"`}),_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:` \"created_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-07-17T11:00:00Z\"`})]}),`\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`,_jsx(ResponseField,{name:`data.id`,type:`string (uuid)`,id:`param-data-id`,children:_jsxs(_components.p,{children:[`The refund request ID — persist it and poll `,_jsx(_components.a,{href:`/api-reference/get-refund`,children:`get refund`}),` to track completion.`]})}),`\n`,_jsx(ResponseField,{name:`data.attributes.status`,type:`string`,id:`param-data-attributes-status`,children:_jsxs(_components.p,{children:[`Starts at `,_jsx(_components.code,{children:`requested`}),`; progresses through `,_jsx(_components.code,{children:`pending`}),` to `,_jsx(_components.code,{children:`complete`}),` (or `,_jsx(_components.code,{children:`failed`}),`). See the `,_jsx(_components.a,{href:`/guides/refunds#refund-lifecycle`,children:`refund lifecycle`}),`.`]})}),`\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.th,{children:[`Example `,_jsx(_components.code,{children:`detail`})]})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:`Signature mismatch`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Request signature does not match...`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`401`})}),_jsx(_components.td,{children:`Bad Bearer token`}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsxs(_components.td,{children:[`Unknown `,_jsx(_components.code,{children:`checkout_id`})]}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`422`})}),_jsx(_components.td,{children:`Outside the 100-day refund window`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Orders can only be refunded within 100 days of the purchase date.`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`422`})}),_jsx(_components.td,{children:`Same-day refund on an auto-refund integration`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Order can't be refunded on the day of purchase.`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`422`})}),_jsx(_components.td,{children:`Amount exceeds the refundable remainder`}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`429`})}),_jsx(_components.td,{children:`More than 1 request per second`}),_jsx(_components.td,{})]})]})]})]})}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":"Create a refund","description":"POST /api/refunds — request a full or partial refund for a checkout.","api":"POST /api/refunds","href":"/api-reference/create-refund"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Request","slug":"request","depth":2,"children":[{"title":"Example","slug":"example","depth":3,"children":[]}]},{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"Create a refund","path":"/api/refunds","servers":[{"url":"https://uat-secure.choosefloat.com"},{"url":"https://secure.choosefloat.com"}],"method":"post","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":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"checkout_id":[{"type":"object","properties":{},"description":"The ID of the checkout to refund — the `data.id` from create checkout .","required":true}],"amount":[{"type":"integer","description":"Amount to refund, in pence. Up to the checkout amount minus any previously refunded amounts. Partial refunds are supported; issue several if needed.","required":true}]}}],"examples":{"example":{"value":{"checkout_id":{},"amount":123}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"data.id":[{"type":"object","properties":{},"description":"The refund request ID — persist it and poll get refund to track completion."}],"data.attributes.status":[{"type":"string","description":"Starts at `requested` ; progresses through `pending` to `complete` (or `failed` ). See the refund lifecycle ."}]}}],"examples":{"example":{"value":{"data.id":{},"data.attributes.status":"\u003cstring>"}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"choosefloat","siteName":"Float Developer Documentation","title":"Create a refund - Float Developer Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-22T10:07:05.966Z","originalFileLocation":"api-reference/create-refund.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=\"POST /api/refunds — request a full or partial refund for a checkout.\">\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=\"Create a refund - Float Developer Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"POST /api/refunds — request a full or partial refund for a checkout.\">\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/create-refund\">\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=Refunds\u0026amp;title=Create+a+refund\u0026amp;description=POST+%2Fapi%2Frefunds+%E2%80%94+request+a+full+or+partial+refund+for+a+checkout.\u0026amp;theme=7729f7e0db976a20aad3d8ad\u0026amp;signature=9faf15f69ca4e272fa32878a2d3a559e84d4296c2f36896cdd586cdb63543a50\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a refund - Float Developer Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"POST /api/refunds — request a full or partial refund for a checkout.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://choosefloat.mintlify.site/_mintlify/api/og/v2?division=Refunds\u0026amp;title=Create+a+refund\u0026amp;description=POST+%2Fapi%2Frefunds+%E2%80%94+request+a+full+or+partial+refund+for+a+checkout.\u0026amp;theme=7729f7e0db976a20aad3d8ad\u0026amp;signature=9faf15f69ca4e272fa32878a2d3a559e84d4296c2f36896cdd586cdb63543a50\">\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/create-refund\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/create-refund.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/create-refund#webpage\",\"url\":\"https://docs.choosefloat.com/api-reference/create-refund\",\"name\":\"Create a refund\",\"description\":\"POST /api/refunds — request a full or partial refund for a checkout.\",\"dateModified\":\"2026-07-22T10:07:05.966Z\",\"isPartOf\":{\"@id\":\"https://docs.choosefloat.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.choosefloat.com/api-reference/create-refund#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.choosefloat.com/api-reference/create-refund#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Float Developer Documentation\",\"item\":\"https://docs.choosefloat.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a refund\",\"item\":\"https://docs.choosefloat.com/api-reference/create-refund\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.choosefloat.com/api-reference/create-refund#apireference\",\"headline\":\"Create a refund\",\"name\":\"Create a refund\",\"description\":\"POST /api/refunds — request a full or partial refund for a checkout.\",\"url\":\"https://docs.choosefloat.com/api-reference/create-refund\",\"mainEntityOfPage\":{\"@id\":\"https://docs.choosefloat.com/api-reference/create-refund#webpage\"},\"dateModified\":\"2026-07-22T10:07:05.966Z\",\"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/create-refund.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","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","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","description":"GET /api/checkouts — paginated list of your 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","description":"GET /api/refunds/:id — track a refund request's status.","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":"Create a refund - 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"]}