How refunds are handled, where returned funds go, and what to keep configured.
When a transaction fails after funds have already moved — a receiving bank rejects the payment, a compliance reversal, an expired transaction — the money comes back. This guide covers how refunds are handled, where the returned funds go, and what to configure so refunds happen without you touching anything.
How refunds work
Every transaction gets a refund plan when it’s created. By default, auto-refund is enabled: if the transaction fails after funds moved, Borderless dispatches the refund automatically and the transaction ends in the Refunded status. Refunds are asynchronous — the status updates when the refund completes, and you can follow it on the transaction’s detail page like any other state change.Refund plans can also be dispatched manually — from the transaction’s detail page, or through the API if your team wants programmatic control over when refunds go out.
Where the money goes
A refund plan resolves its destination by hierarchy — the most specific setting wins:
A destination set on the refund itself when it’s dispatched.
A destination set on the individual transaction.
Your organization’s default refund destination.
Depending on what the provider supports, returned funds can go to a wallet address you specify, back to the original onchain sender, or stay in your balance with the provider. When you nominate addresses, you set one per network — a refund uses the address matching the transaction’s network, so a network you haven’t given an address for has no default to fall back on.
Set your default refund destination
The organization default is the safety net — it catches every refund that doesn’t specify its own destination. Configure it on the Team page under Organization Settings: Organization Administration covers the steps.One thing to keep current: the destination needs re-confirming periodically. After 30 days its badge flags that it’s due — refunds still run normally at this point. After 90 days it lapses, the badge moves to an expired state, and automatic refunds to the default stop working until you re-confirm — a two-click task that’s worth a recurring reminder for whoever owns it. Only Owners can manage this setting.
Refund a transaction yourself
Some refunds wait for you rather than going out automatically — a plan created with automatic refunds turned off, or one parked because a fiat payout failed. When a transaction is in that state, a Refund button appears on its detail page.The button only shows when all three of these hold:
The transaction has Failed.
Its refund plan is ready to be dispatched.
Your role includes the refund permission for transactions. Owners have it; other roles need it granted.
Confirming sends the refund to the destination already resolved for that transaction — the modal names the address when there is one. The action can’t be undone.
The returned amount may differ from the original. Where a failed fiat payout is being returned as crypto, the funds are re-converted at the current rate, so currency movement between the original transaction and the refund is reflected in what arrives.
See refunds on your transactions
Refunded transactions show the Refunded status in the Transactions list — filter by status to see them all. Open one for the full picture: the original failure reason and the state timeline.
Troubleshooting
A failed transaction hasn’t refunded. Check your default refund destination on the Team page first — if its badge shows expired, re-confirm it; automatic refunds don’t run while it’s lapsed. Then open the transaction: if a Refund button is showing, the refund is waiting on you and confirming it will send the funds. If the destination is healthy and no button is offered, contact your Borderless representative with the transaction ID — refunds are asynchronous and some rails take longer than others.I don’t know where a refund went. The destination hierarchy above tells you where to look: a transaction-specific destination first, then the organization default. The transaction’s detail page shows its state history.I want refunds to go somewhere else for one transaction. Destinations can be set per transaction (and per dispatched refund) through the API — see the Developer Guides. In the platform, the organization default applies.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Overview","colors":{"primary":"#199eff","light":"#199eff","dark":"#199eff"},"logo":{"light":"https://mintcdn.com/borderless/lidF-q4eMWX6Z_g2/images/BorderlessBlueWordmarkBlack.svg?fit=max\u0026auto=format\u0026n=lidF-q4eMWX6Z_g2\u0026q=85\u0026s=9fbdee5b8229ae0ffb6590f9f7da1fb3","dark":"https://mintcdn.com/borderless/lidF-q4eMWX6Z_g2/images/BorderlessBlueWordmark.svg?fit=max\u0026auto=format\u0026n=lidF-q4eMWX6Z_g2\u0026q=85\u0026s=44aaf67c3d29edd2406e00602f15acdc"},"favicon":"https://mintcdn.com/borderless/lidF-q4eMWX6Z_g2/BorderlessBlueLogo.svg?fit=max\u0026auto=format\u0026n=lidF-q4eMWX6Z_g2\u0026q=85\u0026s=ce789515ed6146f45dea4a0c830ace83","fonts":{"family":"Geist"},"banner":{"content":"[🚀 Borderless Benchmark now LIVE!](https://borderless.xyz/benchmark)","dismissible":true},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"borderless","hasAudioNarration":false,"actualSubdomain":"borderless","customDomains":["docs.borderless.xyz"],"gitSource":{"type":"github","owner":"borderlesslabs","repo":"docs-mintlify","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b018f8ffd415813a10d5dc2","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":118},{"language":"default","tag":"API Endpoints","count":111},{"language":"default","tag":"Developer Guides","count":18},{"language":"default","tag":"Webhooks","count":13},{"language":"default","tag":"Platform Guides","count":13},{"language":"default","tag":"Reconciliation","count":12},{"language":"default","tag":"Identities","count":10},{"language":"default","tag":"Transactions","count":9},{"language":"default","tag":"Mastercard Crypto Credential","count":9},{"language":"default","tag":"Accounts","count":8}]},"assistantConfig":{"enableAskAiButton":true,"enableStarterQuestions":true,"enableAskAiSearchBar":false,"deflection":{"enabled":true,"email":"support@borderless.xyz","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"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},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"starterQuestions":[{"_id":"6929d40a01b1450fbd67f099","deploymentId":"691755c24d74f2daaec8e890","questionText":"How do I get started with Borderless?","status":"active","generatedBy":"manual","createdAt":"2025-11-28T16:55:38.106Z","updatedAt":"2025-11-28T16:55:38.106Z","__v":0},{"_id":"6929d3f601b1450fbd67e863","deploymentId":"691755c24d74f2daaec8e890","questionText":"How do I convert fiat to stablecoins?","status":"active","generatedBy":"manual","createdAt":"2025-11-28T16:55:18.756Z","updatedAt":"2025-11-28T16:55:18.756Z","__v":0},{"_id":"6929d3ef01b1450fbd67e562","deploymentId":"691755c24d74f2daaec8e890","questionText":"How do I set up API keys?","status":"active","generatedBy":"manual","createdAt":"2025-11-28T16:55:11.394Z","updatedAt":"2025-11-28T16:55:11.394Z","__v":0}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"#banner,#banner a{color:#020617!important}html.dark #banner,html.dark #banner a,html[data-theme=\"dark\"] #banner,html[data-theme=\"dark\"] #banner a{color:#ffffff!important}"}]}
{"page":{"pagePath":"platform-guides/refunds","slug":"/platform-guides/refunds","pageMetadata":{"title":"Refunds","description":"How refunds are handled, where returned funds go, and what to keep configured.","href":"/platform-guides/refunds"},"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: \"How refunds are handled, where returned funds go, and what to keep configured.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,OptimizedImage,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`When a transaction fails after funds have already moved — a receiving bank rejects the payment, a compliance reversal, an expired transaction — the money comes back. This guide covers how refunds are handled, where the returned funds go, and what to configure so refunds happen without you touching anything.`}),`\n`,_jsx(Heading,{level:`2`,id:`how-refunds-work`,children:`How refunds work`}),`\n`,_jsxs(_components.p,{children:[`Every transaction gets a refund plan when it’s created. By default, auto-refund is enabled: if the transaction fails after funds moved, Borderless dispatches the refund automatically and the transaction ends in the `,_jsx(_components.strong,{children:`Refunded`}),` status. Refunds are asynchronous — the status updates when the refund completes, and you can follow it on the transaction’s detail page like any other state change.`]}),`\n`,_jsx(_components.p,{children:`Refund plans can also be dispatched manually — from the transaction’s detail page, or through the API if your team wants programmatic control over when refunds go out.`}),`\n`,_jsx(Heading,{level:`2`,id:`where-the-money-goes`,children:`Where the money goes`}),`\n`,_jsx(_components.p,{children:`A refund plan resolves its destination by hierarchy — the most specific setting wins:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`A destination set on the refund itself when it’s dispatched.`}),`\n`,_jsx(_components.li,{children:`A destination set on the individual transaction.`}),`\n`,_jsx(_components.li,{children:`Your organization’s default refund destination.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`Depending on what the provider supports, returned funds can go to a wallet address you specify, back to the original onchain sender, or stay in your balance with the provider. When you nominate addresses, you set one per network — a refund uses the address matching the transaction’s network, so a network you haven’t given an address for has no default to fall back on.`}),`\n`,_jsx(Heading,{level:`2`,id:`set-your-default-refund-destination`,children:`Set your default refund destination`}),`\n`,_jsxs(_components.p,{children:[`The organization default is the safety net — it catches every refund that doesn’t specify its own destination. Configure it on the `,_jsx(_components.strong,{children:`Team`}),` page under `,_jsx(_components.strong,{children:`Organization Settings`}),`: `,_jsx(_components.a,{href:`/platform-guides/org-administration`,children:`Organization Administration`}),` covers the steps.`]}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/borderless/CMYrYypYUM-ylu0U/images/platform-guides/refunds/refund-default.png?fit=max\u0026auto=format\u0026n=CMYrYypYUM-ylu0U\u0026q=85\u0026s=b49a2ab3e7cca9fb4573974534311878`,alt:`Default refund destination modal on the Team page, with destination options and the automatic refund toggle`,\"data-og-width\":`3402`,width:`3402`,\"data-og-height\":`1452`,height:`1452`,\"data-path\":`images/platform-guides/refunds/refund-default.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/borderless/CMYrYypYUM-ylu0U/images/platform-guides/refunds/refund-default.png?w=280\u0026fit=max\u0026auto=format\u0026n=CMYrYypYUM-ylu0U\u0026q=85\u0026s=114eca1b1e338a88c4baa170196835f6 280w, https://mintcdn.com/borderless/CMYrYypYUM-ylu0U/images/platform-guides/refunds/refund-default.png?w=560\u0026fit=max\u0026auto=format\u0026n=CMYrYypYUM-ylu0U\u0026q=85\u0026s=eecc41cc5e9bcddf5c6ca4b13d324250 560w, https://mintcdn.com/borderless/CMYrYypYUM-ylu0U/images/platform-guides/refunds/refund-default.png?w=840\u0026fit=max\u0026auto=format\u0026n=CMYrYypYUM-ylu0U\u0026q=85\u0026s=ab58ca105cd369de3ab2034b60a88614 840w, https://mintcdn.com/borderless/CMYrYypYUM-ylu0U/images/platform-guides/refunds/refund-default.png?w=1100\u0026fit=max\u0026auto=format\u0026n=CMYrYypYUM-ylu0U\u0026q=85\u0026s=d05344173ce0655f431c540758ee09ca 1100w, https://mintcdn.com/borderless/CMYrYypYUM-ylu0U/images/platform-guides/refunds/refund-default.png?w=1650\u0026fit=max\u0026auto=format\u0026n=CMYrYypYUM-ylu0U\u0026q=85\u0026s=fc1c38c6ab5adc8d172fa3e4fc7151a1 1650w, https://mintcdn.com/borderless/CMYrYypYUM-ylu0U/images/platform-guides/refunds/refund-default.png?w=2500\u0026fit=max\u0026auto=format\u0026n=CMYrYypYUM-ylu0U\u0026q=85\u0026s=125603831427628ebf9307f7d0322182 2500w`}),`\n`,_jsxs(_components.p,{children:[`One thing to keep current: the destination needs re-confirming periodically. After `,_jsx(_components.strong,{children:`30 days`}),` its badge flags that it’s due — refunds still run normally at this point. After `,_jsx(_components.strong,{children:`90 days`}),` it lapses, the badge moves to an expired state, and `,_jsx(_components.strong,{children:`automatic refunds to the default stop working`}),` until you re-confirm — a two-click task that’s worth a recurring reminder for whoever owns it. Only Owners can manage this setting.`]}),`\n`,_jsx(Heading,{level:`2`,id:`refund-a-transaction-yourself`,children:`Refund a transaction yourself`}),`\n`,_jsxs(_components.p,{children:[`Some refunds wait for you rather than going out automatically — a plan created with automatic refunds turned off, or one parked because a fiat payout failed. When a transaction is in that state, a `,_jsx(_components.strong,{children:`Refund`}),` button appears on its detail page.`]}),`\n`,_jsx(_components.p,{children:`The button only shows when all three of these hold:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`The transaction has `,_jsx(_components.strong,{children:`Failed`}),`.`]}),`\n`,_jsx(_components.li,{children:`Its refund plan is ready to be dispatched.`}),`\n`,_jsx(_components.li,{children:`Your role includes the refund permission for transactions. Owners have it; other roles need it granted.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`Confirming sends the refund to the destination already resolved for that transaction — the modal names the address when there is one. The action can’t be undone.`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`The returned amount may differ from the original. Where a failed fiat payout is being returned as crypto, the funds are re-converted at the current rate, so currency movement between the original transaction and the refund is reflected in what arrives.`})}),`\n`,_jsx(Heading,{level:`2`,id:`see-refunds-on-your-transactions`,children:`See refunds on your transactions`}),`\n`,_jsxs(_components.p,{children:[`Refunded transactions show the `,_jsx(_components.strong,{children:`Refunded`}),` status in the `,_jsx(_components.strong,{children:`Transactions`}),` list — filter by status to see them all. Open one for the full picture: the original failure reason and the state timeline.`]}),`\n`,_jsx(OptimizedImage,{src:`https://mintcdn.com/borderless/CMYrYypYUM-ylu0U/images/platform-guides/refunds/refunded-transaction.png?fit=max\u0026auto=format\u0026n=CMYrYypYUM-ylu0U\u0026q=85\u0026s=88bf4e41e7bf123286e16dc8af5a74a9`,alt:`Transaction detail page for a refunded deposit, showing the Refunded status and the failure reason`,\"data-og-width\":`3386`,width:`3386`,\"data-og-height\":`1238`,height:`1238`,\"data-path\":`images/platform-guides/refunds/refunded-transaction.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/borderless/CMYrYypYUM-ylu0U/images/platform-guides/refunds/refunded-transaction.png?w=280\u0026fit=max\u0026auto=format\u0026n=CMYrYypYUM-ylu0U\u0026q=85\u0026s=306591ec6bb6bebff1a33ba3651ff241 280w, https://mintcdn.com/borderless/CMYrYypYUM-ylu0U/images/platform-guides/refunds/refunded-transaction.png?w=560\u0026fit=max\u0026auto=format\u0026n=CMYrYypYUM-ylu0U\u0026q=85\u0026s=fb1b90aae161e61ec4b0ee7bbbe7c46b 560w, https://mintcdn.com/borderless/CMYrYypYUM-ylu0U/images/platform-guides/refunds/refunded-transaction.png?w=840\u0026fit=max\u0026auto=format\u0026n=CMYrYypYUM-ylu0U\u0026q=85\u0026s=afbb803a6e4e26b6bf15f95837d21542 840w, https://mintcdn.com/borderless/CMYrYypYUM-ylu0U/images/platform-guides/refunds/refunded-transaction.png?w=1100\u0026fit=max\u0026auto=format\u0026n=CMYrYypYUM-ylu0U\u0026q=85\u0026s=93ba7ce2309c451f1985dad9dfc3027b 1100w, https://mintcdn.com/borderless/CMYrYypYUM-ylu0U/images/platform-guides/refunds/refunded-transaction.png?w=1650\u0026fit=max\u0026auto=format\u0026n=CMYrYypYUM-ylu0U\u0026q=85\u0026s=a9614add4602d269441627630546e816 1650w, https://mintcdn.com/borderless/CMYrYypYUM-ylu0U/images/platform-guides/refunds/refunded-transaction.png?w=2500\u0026fit=max\u0026auto=format\u0026n=CMYrYypYUM-ylu0U\u0026q=85\u0026s=9bb7a0c6c50692e3db6a6f583096edc6 2500w`}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`A failed transaction hasn’t refunded.`}),` Check your default refund destination on the `,_jsx(_components.strong,{children:`Team`}),` page first — if its badge shows expired, re-confirm it; automatic refunds don’t run while it’s lapsed. Then open the transaction: if a `,_jsx(_components.strong,{children:`Refund`}),` button is showing, the refund is waiting on you and confirming it will send the funds. If the destination is healthy and no button is offered, contact your Borderless representative with the transaction ID — refunds are asynchronous and some rails take longer than others.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`I don’t know where a refund went.`}),` The destination hierarchy above tells you where to look: a transaction-specific destination first, then the organization default. The transaction’s detail page shows its state history.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`I want refunds to go somewhere else for one transaction.`}),` Destinations can be set per transaction (and per dispatched refund) through the API — see the Developer Guides. In the platform, the organization default applies.`]})]})}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":"Refunds","description":"How refunds are handled, where returned funds go, and what to keep configured.","href":"/platform-guides/refunds"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"How refunds work","slug":"how-refunds-work","depth":2,"children":[]},{"title":"Where the money goes","slug":"where-the-money-goes","depth":2,"children":[]},{"title":"Set your default refund destination","slug":"set-your-default-refund-destination","depth":2,"children":[]},{"title":"Refund a transaction yourself","slug":"refund-a-transaction-yourself","depth":2,"children":[]},{"title":"See refunds on your transactions","slug":"see-refunds-on-your-transactions","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/borderless/0ae79020d6294609/scripts/build-coverage-views.js"],"subdomain":"borderless","siteName":"Overview","title":"Refunds - Overview","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-26T11:47:27.261Z","originalFileLocation":"platform-guides/refunds.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=\"How refunds are handled, where returned funds go, and what to keep configured.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Overview\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/borderless/apHfxY_1uCXsjEzL/_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/borderless/apHfxY_1uCXsjEzL/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/borderless/apHfxY_1uCXsjEzL/_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/borderless/apHfxY_1uCXsjEzL/_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/borderless/apHfxY_1uCXsjEzL/_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/borderless/apHfxY_1uCXsjEzL/_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/borderless/apHfxY_1uCXsjEzL/_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/borderless/apHfxY_1uCXsjEzL/_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/borderless/apHfxY_1uCXsjEzL/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Refunds - Overview\">\u003cmeta data-mint-head property=\"og:description\" content=\"How refunds are handled, where returned funds go, and what to keep configured.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Overview\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.borderless.xyz/platform-guides/refunds\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://borderless.mintlify.site/_mintlify/api/og/v2?division=Transactions\u0026amp;title=Refunds\u0026amp;description=How+refunds+are+handled%2C+where+returned+funds+go%2C+and+what+to+keep+configured.\u0026amp;theme=3c489b58bbb38ab73b53747c\u0026amp;signature=2c0c91077aef11f157f4ca6a5850ef370bb2125aecba4fe73086cb6e329f0419\">\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=\"Refunds - Overview\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"How refunds are handled, where returned funds go, and what to keep configured.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://borderless.mintlify.site/_mintlify/api/og/v2?division=Transactions\u0026amp;title=Refunds\u0026amp;description=How+refunds+are+handled%2C+where+returned+funds+go%2C+and+what+to+keep+configured.\u0026amp;theme=3c489b58bbb38ab73b53747c\u0026amp;signature=2c0c91077aef11f157f4ca6a5850ef370bb2125aecba4fe73086cb6e329f0419\">\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/borderless/apHfxY_1uCXsjEzL/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Overview\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#199eff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.borderless.xyz/platform-guides/refunds\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/platform-guides/refunds.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.borderless.xyz/#organization\",\"name\":\"Overview\",\"url\":\"https://docs.borderless.xyz\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/borderless/lidF-q4eMWX6Z_g2/images/BorderlessBlueWordmarkBlack.svg?fit=max\u0026auto=format\u0026n=lidF-q4eMWX6Z_g2\u0026q=85\u0026s=9fbdee5b8229ae0ffb6590f9f7da1fb3\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.borderless.xyz#website\",\"name\":\"Overview\",\"url\":\"https://docs.borderless.xyz\",\"publisher\":{\"@id\":\"https://docs.borderless.xyz/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.borderless.xyz/platform-guides/refunds#webpage\",\"url\":\"https://docs.borderless.xyz/platform-guides/refunds\",\"name\":\"Refunds\",\"description\":\"How refunds are handled, where returned funds go, and what to keep configured.\",\"dateModified\":\"2026-08-26T11:47:27.261Z\",\"isPartOf\":{\"@id\":\"https://docs.borderless.xyz#website\"},\"breadcrumb\":{\"@id\":\"https://docs.borderless.xyz/platform-guides/refunds#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.borderless.xyz/platform-guides/refunds#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Transactions\",\"item\":\"https://docs.borderless.xyz/platform-guides/creating-transactions\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Refunds\",\"item\":\"https://docs.borderless.xyz/platform-guides/refunds\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.borderless.xyz/platform-guides/refunds#article\",\"headline\":\"Refunds\",\"name\":\"Refunds\",\"description\":\"How refunds are handled, where returned funds go, and what to keep configured.\",\"url\":\"https://docs.borderless.xyz/platform-guides/refunds\",\"mainEntityOfPage\":{\"@id\":\"https://docs.borderless.xyz/platform-guides/refunds#webpage\"},\"dateModified\":\"2026-08-26T11:47:27.261Z\",\"publisher\":{\"@id\":\"https://docs.borderless.xyz/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.borderless.xyz#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Overview\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Overview\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/platform-guides/refunds.md","siteName":"Overview","nav":{"global":null,"tabs":[{"tab":"Home","pages":[{"title":"Home","href":""}]},{"tab":"Platform Guides","groups":[{"group":"Getting Started","pages":[{"title":"Getting Started","href":"/platform-guides/getting-started"},{"title":"Wallets","href":"/platform-guides/wallets"},{"title":"Organization Administration","href":"/platform-guides/org-administration"}]},{"group":"Identities \u0026 Compliance","pages":[{"title":"Identities \u0026 Compliance","href":"/platform-guides/identities-compliance"},{"title":"RFI Case Management","href":"/platform-guides/rfi-case-management"}]},{"group":"Transactions","pages":[{"title":"Creating Transactions","description":"Create deposits, withdrawals, and exchanges, and track them to completion.","href":"/platform-guides/creating-transactions"},{"hidden":true,"title":"Transactions Import","description":null,"href":"/transactions-import"},{"title":"Refunds","href":"/platform-guides/refunds"}]},{"group":"Provider Network","pages":[{"title":"Provider Marketplace","description":"Explore providers by capability, country, and currency, and connect your credentials.","href":"/platform-guides/provider-marketplace"},{"title":"Provider Health","href":"/platform-guides/provider-health"},{"title":"Routing","href":"/platform-guides/routing"}]},{"group":"Financial Operations","pages":[{"title":"Reconciliation","href":"/platform-guides/reconciliation"},{"title":"Execution Benchmarking","href":"/platform-guides/execution-benchmarking"},{"title":"Exporting Reports","href":"/platform-guides/exporting-reports"}]}]},{"tab":"Developer Guides","pages":[{"title":"Developer Guides","href":"/docs/introduction"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/authentication"}]}]},"basePath":"","title":"Refunds - Overview","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["10e4515597","a74be98ba7"],"chunks":["BannerMarkdown-BOAJk9BH.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","zoom-image-lightbox-BQ4tbj_9.js","lightbox-handle-r17bVUz3.js"]}