Sends a crypto deposit that failed the AML check (deposit_data.aml_declined, status declined) back out to the given address. Nothing was credited, so nothing is taken back. Callable by the member the deposit was addressed to or the account owner, with can_withdraw and the same TOTP rule as withdrawals.
Returns as soon as the crypto service accepts the request. The outcome arrives asynchronously: on success the transaction becomes canceled and deposit_data.refund carries tx_hash, blockchain_url and the amount sent; on failure deposit_data.refund.status is failed with an error_code and the request can be sent again. Poll POST /transactions for the outcome. Finup charges no fee, but the network fee is taken out of the transfer (on Tron up to 3 USDT).
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Finup API","description":"Client-facing API documentation for Finup accounts, cards, users, and transactions.","colors":{"primary":"#3B66FF","light":"#6F8CFF","dark":"#2C54DE"},"logo":{"light":"https://mintcdn.com/finup-8fa91179/6xmKNxtArAPMxazm/logo/finup-blck.svg?fit=max\u0026auto=format\u0026n=6xmKNxtArAPMxazm\u0026q=85\u0026s=d171aa7226e7490f97b28c05f6fa49d2","dark":"https://mintcdn.com/finup-8fa91179/6xmKNxtArAPMxazm/logo/finup-wht.svg?fit=max\u0026auto=format\u0026n=6xmKNxtArAPMxazm\u0026q=85\u0026s=a0f341c73f2de832a19ea43bcc669920"},"favicon":"https://mintcdn.com/finup-8fa91179/6xmKNxtArAPMxazm/favicon.svg?fit=max\u0026auto=format\u0026n=6xmKNxtArAPMxazm\u0026q=85\u0026s=6e4a877a548f60c254c0cdfab80307b0","api":{"openapi":"openapi.json","playground":{"display":"interactive","proxy":true},"examples":{"defaults":"required","languages":["curl","javascript","python"]}},"navbar":{"links":[{"href":"https://app.finup.io","label":"App"}]},"footer":{"socials":{"website":"https://finup.io"}},"icons":{"library":"lucide"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"finup-8fa91179","hasAudioNarration":false,"actualSubdomain":"finup-8fa91179","customDomains":["docs.finup.io"],"gitSource":{"type":"github","owner":"finup-development","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"collectionId":"963ade65-9953-42f7-bdfc-1d89541ba72c","liveDeploymentHistoryId":"6aaaa619e906dad22caad070","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aaaa619e906dad22caad070"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae1ddcf8ead5bbc3c1c885b","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"API reference","count":16},{"language":"default","tag":"Cards","count":8},{"language":"default","tag":"Guides","count":7},{"language":"default","tag":"Start","count":6},{"language":"default","tag":"Accounts","count":3},{"language":"default","tag":"Transactions","count":3},{"language":"default","tag":"Overview","count":2},{"language":"default","tag":"MCP","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":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/transactions/refund-a-deposit-blocked-by-the-aml-check","slug":"/api-reference/transactions/refund-a-deposit-blocked-by-the-aml-check","pageMetadata":{"title":"Refund a deposit blocked by the AML check","description":"Sends a crypto deposit that failed the AML check (`deposit_data.aml_declined`, status `declined`) back out to the given address. Nothing was credited, so nothing is taken back. Callable by the member the deposit was addressed to or the account owner, with `can_withdraw` and the same TOTP rule as withdrawals.\n\nReturns as soon as the crypto service accepts the request. The outcome arrives asynchronously: on success the transaction becomes `canceled` and `deposit_data.refund` carries `tx_hash`, `blockchain_url` and the `amount` sent; on failure `deposit_data.refund.status` is `failed` with an `error_code` and the request can be sent again. Poll POST /transactions for the outcome. Finup charges no fee, but the network fee is taken out of the transfer (on Tron up to 3 USDT).","deprecated":null,"version":null,"openapi":"/openapi.json post /transactions/{transaction_id}/aml-refund","href":"/api-reference/transactions/refund-a-deposit-blocked-by-the-aml-check","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Sends a crypto deposit that failed the AML check (\", _jsx(_components.code, {\n children: \"deposit_data.aml_declined\"\n }), \", status \", _jsx(_components.code, {\n children: \"declined\"\n }), \") back out to the given address. Nothing was credited, so nothing is taken back. Callable by the member the deposit was addressed to or the account owner, with \", _jsx(_components.code, {\n children: \"can_withdraw\"\n }), \" and the same TOTP rule as withdrawals.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Returns as soon as the crypto service accepts the request. The outcome arrives asynchronously: on success the transaction becomes \", _jsx(_components.code, {\n children: \"canceled\"\n }), \" and \", _jsx(_components.code, {\n children: \"deposit_data.refund\"\n }), \" carries \", _jsx(_components.code, {\n children: \"tx_hash\"\n }), \", \", _jsx(_components.code, {\n children: \"blockchain_url\"\n }), \" and the \", _jsx(_components.code, {\n children: \"amount\"\n }), \" sent; on failure \", _jsx(_components.code, {\n children: \"deposit_data.refund.status\"\n }), \" is \", _jsx(_components.code, {\n children: \"failed\"\n }), \" with an \", _jsx(_components.code, {\n children: \"error_code\"\n }), \" and the request can be sent again. Poll POST /transactions for the outcome. Finup charges no fee, but the network fee is taken out of the transfer (on Tron up to 3 USDT).\"]\n })]\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Refund a deposit blocked by the AML check","description":"Sends a crypto deposit that failed the AML check (`deposit_data.aml_declined`, status `declined`) back out to the given address. Nothing was credited, so nothing is taken back. Callable by the member the deposit was addressed to or the account owner, with `can_withdraw` and the same TOTP rule as withdrawals.\n\nReturns as soon as the crypto service accepts the request. The outcome arrives asynchronously: on success the transaction becomes `canceled` and `deposit_data.refund` carries `tx_hash`, `blockchain_url` and the `amount` sent; on failure `deposit_data.refund.status` is `failed` with an `error_code` and the request can be sent again. Poll POST /transactions for the outcome. Finup charges no fee, but the network fee is taken out of the transfer (on Tron up to 3 USDT).","deprecated":null,"version":null,"openapi":"/openapi.json post /transactions/{transaction_id}/aml-refund","href":"/api-reference/transactions/refund-a-deposit-blocked-by-the-aml-check","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Transactions"],"summary":"Refund a deposit blocked by the AML check","description":"Sends a crypto deposit that failed the AML check (`deposit_data.aml_declined`, status `declined`) back out to the given address. Nothing was credited, so nothing is taken back. Callable by the member the deposit was addressed to or the account owner, with `can_withdraw` and the same TOTP rule as withdrawals.\n\nReturns as soon as the crypto service accepts the request. The outcome arrives asynchronously: on success the transaction becomes `canceled` and `deposit_data.refund` carries `tx_hash`, `blockchain_url` and the `amount` sent; on failure `deposit_data.refund.status` is `failed` with an `error_code` and the request can be sent again. Poll POST /transactions for the outcome. Finup charges no fee, but the network fee is taken out of the transfer (on Tron up to 3 USDT).","security":["979fde0a-60dd-4179-a180-4a92673eb21d"],"parameters":["b8556149-4da5-47dd-9996-15aae7d90652"],"requestBody":"add5dea9-5c8b-4fe5-8b67-4a9f20d58b97","responses":{"201":"79354572-289f-44c2-850c-15432d7943c2","400":"bc3ea640-7b1c-43c4-9c04-d76eadd186e3","401":"8a47bafb-f902-4943-a66f-fdcc01e84921","403":"d02c7608-e078-4294-a0df-49d8633f5be7","404":"2c6ace6a-97c9-4c88-82bb-01c25f7c113d","409":"b2e55b23-5a5a-4c28-8fbd-d01ba1f9085b","422":"7067a036-f0a2-4435-8f56-6c92362fbd63","428":"522cd2b4-0da4-4804-ab29-7b41daf6d01d"},"method":"post","type":"path","servers":["18d0eb62-b3b9-43a3-8953-4f6751b3c287"],"path":"/transactions/{transaction_id}/aml-refund","baseUrlOptions":["https://api.finup.io/backend"],"title":"Refund a deposit blocked by the AML check","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"b8556149-4da5-47dd-9996-15aae7d90652":{"name":"transaction_id","in":"path","required":true,"description":"Transaction id of the blocked deposit, from POST /transactions.","schema":{"type":"string","isRequired":true,"description":"Transaction id of the blocked deposit, from POST /transactions.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["withdraw_address"],"properties":{"withdraw_address":{"type":"string","minLength":10,"maxLength":128,"example":"TQ5NMqJjjkDWbYi1dmQ8e3n8ZHPyYsMQxA","description":"Address the deposit is sent back to, on the network it arrived on. Must not be the deposit address itself.","isRequired":true,"uniqueKey":"withdraw_address","typeLabel":"string"},"code":{"type":"string","example":"123456","description":"TOTP code. Required unless the account is suspended or blocked and the user has no 2FA enabled.","uniqueKey":"code","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"withdraw_address":"TQ5NMqJjjkDWbYi1dmQ8e3n8ZHPyYsMQxA","code":"123456"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"79354572-289f-44c2-850c-15432d7943c2":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["result"],"properties":{"result":{"type":"object","properties":{"status":{"type":"string","enum":["requested","processing","completed","failed"],"example":"requested","description":"requested — accepted by the crypto service; processing — being sent; completed — sent, see tx_hash and blockchain_url, and the transaction itself is now canceled; failed — nothing left Finup, the deposit is still declined and the refund can be asked for again.","uniqueKey":"result.status","typeLabel":"enum\u003cstring>"},"withdraw_address":{"type":"string","example":"TQ5NMqJjjkDWbYi1dmQ8e3n8ZHPyYsMQxA","description":"Address the blocked deposit is being sent back to.","uniqueKey":"result.withdraw_address","typeLabel":"string"},"amount":{"oneOf":[{"type":"string","example":null,"description":"Amount actually sent back, in the deposit currency. The provider takes the network fee out of the transfer (on Tron up to 3 USDT), so it is only known once the refund is sent.","uniqueKey":"result.amount.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"description":"Amount actually sent back, in the deposit currency. The provider takes the network fee out of the transfer (on Tron up to 3 USDT), so it is only known once the refund is sent.","uniqueKey":"result.amount.oneOf.1","typeLabel":"null"}],"uniqueKey":"result.amount","typeLabel":"string | null"},"fee_amount":{"oneOf":[{"type":"string","example":null,"description":"Network fee the provider took out of the transfer, in the deposit currency; null until the refund is sent.","uniqueKey":"result.fee_amount.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"description":"Network fee the provider took out of the transfer, in the deposit currency; null until the refund is sent.","uniqueKey":"result.fee_amount.oneOf.1","typeLabel":"null"}],"uniqueKey":"result.fee_amount","typeLabel":"string | null"},"tx_hash":{"oneOf":[{"type":"string","example":null,"description":"Hash of the refund transaction; null until it is confirmed.","uniqueKey":"result.tx_hash.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"description":"Hash of the refund transaction; null until it is confirmed.","uniqueKey":"result.tx_hash.oneOf.1","typeLabel":"null"}],"uniqueKey":"result.tx_hash","typeLabel":"string | null"},"blockchain_url":{"oneOf":[{"type":"string","example":null,"description":"Block explorer link for tx_hash, ready to show as-is.","uniqueKey":"result.blockchain_url.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"description":"Block explorer link for tx_hash, ready to show as-is.","uniqueKey":"result.blockchain_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"result.blockchain_url","typeLabel":"string | null"},"error_code":{"oneOf":[{"type":"string","example":null,"description":"Machine-readable failure reason, null unless status is failed: insufficient_gas, insufficient_balance, transaction_reverted, provider_unavailable or transfer_failed. Map it to your own wording.","uniqueKey":"result.error_code.oneOf.0","typeLabel":"string"},{"type":"null","example":null,"description":"Machine-readable failure reason, null unless status is failed: insufficient_gas, insufficient_balance, transaction_reverted, provider_unavailable or transfer_failed. Map it to your own wording.","uniqueKey":"result.error_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"result.error_code","typeLabel":"string | null"},"requested_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"result.requested_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"result.requested_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"result.requested_at","typeLabel":"string\u003cdate-time> | null"},"completed_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"result.completed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"result.completed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"result.completed_at","typeLabel":"string\u003cdate-time> | null"}},"isRequired":true,"uniqueKey":"result","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"result":{"status":"requested","withdraw_address":"TQ5NMqJjjkDWbYi1dmQ8e3n8ZHPyYsMQxA","amount":null,"fee_amount":null,"tx_hash":null,"blockchain_url":null,"error_code":null,"requested_at":"2023-11-07T05:31:56Z","completed_at":"2023-11-07T05:31:56Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"bc3ea640-7b1c-43c4-9c04-d76eadd186e3":{"description":"Code missing, or the address is the deposit address, invalid on the deposit network, or belongs to Finup","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"8a47bafb-f902-4943-a66f-fdcc01e84921":{"description":"Missing or invalid credentials","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"d02c7608-e078-4294-a0df-49d8633f5be7":{"description":"Insufficient permission for this operation","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"2c6ace6a-97c9-4c88-82bb-01c25f7c113d":{"description":"Resource not found","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"b2e55b23-5a5a-4c28-8fbd-d01ba1f9085b":{"description":"The deposit is not refundable, or a refund already exists for it","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"7067a036-f0a2-4435-8f56-6c92362fbd63":{"description":"Invalid 2FA code","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"522cd2b4-0da4-4804-ab29-7b41daf6d01d":{"description":"2FA is not enabled for the caller","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"979fde0a-60dd-4179-a180-4a92673eb21d":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"apiKeyAuth"}}},"servers":{"18d0eb62-b3b9-43a3-8953-4f6751b3c287":{"url":"https://api.finup.io/backend","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"apiKeyAuth"},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyAuth","name":"x-api-key"}],"title":"apiKeyAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"finup-8fa91179","siteName":"Finup API","title":"Refund a deposit blocked by the AML check - Finup API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-28T11:34:44.677Z","originalFileLocation":"api-reference/transactions/refund-a-deposit-blocked-by-the-aml-check.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=\"Sends a crypto deposit that failed the AML check (deposit_data.aml_declined, status declined) back out to the given address. Nothing was credited, so nothing is taken back. Callable by the member the deposit was addressed to or the account owner, with can_withdraw and the same TOTP rule as withdrawals. Returns as soon as the crypto service accepts the request. The outcome arrives asynchronously: on success the transaction becomes canceled and deposit_data.refund carries tx_hash, blockchain_url and the amount sent; on failure deposit_data.refund.status is failed with an error_code and the request can be sent again. Poll POST /transactions for the outcome. Finup charges no fee, but the network fee is taken out of the transfer (on Tron up to 3 USDT).\">\u003cmeta data-mint-head name=\"application-name\" content=\"Finup API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/finup-8fa91179/efMM26EDZKsLZWgY/_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/finup-8fa91179/efMM26EDZKsLZWgY/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/finup-8fa91179/efMM26EDZKsLZWgY/_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/finup-8fa91179/efMM26EDZKsLZWgY/_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/finup-8fa91179/efMM26EDZKsLZWgY/_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/finup-8fa91179/efMM26EDZKsLZWgY/_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/finup-8fa91179/efMM26EDZKsLZWgY/_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/finup-8fa91179/efMM26EDZKsLZWgY/_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/finup-8fa91179/efMM26EDZKsLZWgY/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Refund a deposit blocked by the AML check - Finup API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Sends a crypto deposit that failed the AML check (deposit_data.aml_declined, status declined) back out to the given address. Nothing was credited, so nothing is taken back. Callable by the member the deposit was addressed to or the account owner, with can_withdraw and the same TOTP rule as withdrawals. Returns as soon as the crypto service accepts the request. The outcome arrives asynchronously: on success the transaction becomes canceled and deposit_data.refund carries tx_hash, blockchain_url and the amount sent; on failure deposit_data.refund.status is failed with an error_code and the request can be sent again. Poll POST /transactions for the outcome. Finup charges no fee, but the network fee is taken out of the transfer (on Tron up to 3 USDT).\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Finup API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.finup.io/api-reference/transactions/refund-a-deposit-blocked-by-the-aml-check\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://finup-8fa91179.mintlify.app/_mintlify/api/og/v2?division=Transactions\u0026amp;title=Refund+a+deposit+blocked+by+the+AML+check\u0026amp;description=Sends+a+crypto+deposit+that+failed+the+AML+check+%28%60deposit_data.aml_declined%60%2C+status+%60declined%60%29+back+out+to+the+given+address.+Nothing+was+credited%2C+so+nothin\u0026amp;theme=3a9324784f24285b2fa50338\u0026amp;signature=8c143b9234c82d8e80d808aedf64152f047426925652fa6b3cc835ae7a1cd104\">\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=\"Refund a deposit blocked by the AML check - Finup API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Sends a crypto deposit that failed the AML check (deposit_data.aml_declined, status declined) back out to the given address. Nothing was credited, so nothing is taken back. Callable by the member the deposit was addressed to or the account owner, with can_withdraw and the same TOTP rule as withdrawals. Returns as soon as the crypto service accepts the request. The outcome arrives asynchronously: on success the transaction becomes canceled and deposit_data.refund carries tx_hash, blockchain_url and the amount sent; on failure deposit_data.refund.status is failed with an error_code and the request can be sent again. Poll POST /transactions for the outcome. Finup charges no fee, but the network fee is taken out of the transfer (on Tron up to 3 USDT).\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://finup-8fa91179.mintlify.app/_mintlify/api/og/v2?division=Transactions\u0026amp;title=Refund+a+deposit+blocked+by+the+AML+check\u0026amp;description=Sends+a+crypto+deposit+that+failed+the+AML+check+%28%60deposit_data.aml_declined%60%2C+status+%60declined%60%29+back+out+to+the+given+address.+Nothing+was+credited%2C+so+nothin\u0026amp;theme=3a9324784f24285b2fa50338\u0026amp;signature=8c143b9234c82d8e80d808aedf64152f047426925652fa6b3cc835ae7a1cd104\">\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/finup-8fa91179/efMM26EDZKsLZWgY/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Finup API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3B66FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.finup.io/api-reference/transactions/refund-a-deposit-blocked-by-the-aml-check\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/transactions/refund-a-deposit-blocked-by-the-aml-check.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.finup.io/#organization\",\"name\":\"Finup API\",\"url\":\"https://docs.finup.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/finup-8fa91179/6xmKNxtArAPMxazm/logo/finup-blck.svg?fit=max\u0026auto=format\u0026n=6xmKNxtArAPMxazm\u0026q=85\u0026s=d171aa7226e7490f97b28c05f6fa49d2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.finup.io#website\",\"name\":\"Finup API\",\"url\":\"https://docs.finup.io\",\"publisher\":{\"@id\":\"https://docs.finup.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.finup.io/api-reference/transactions/refund-a-deposit-blocked-by-the-aml-check#webpage\",\"url\":\"https://docs.finup.io/api-reference/transactions/refund-a-deposit-blocked-by-the-aml-check\",\"name\":\"Refund a deposit blocked by the AML check\",\"description\":\"Sends a crypto deposit that failed the AML check (deposit_data.aml_declined, status declined) back out to the given address. Nothing was credited, so nothing is taken back. Callable by the member the deposit was addressed to or the account owner, with can_withdraw and the same TOTP rule as withdrawals. Returns as soon as the crypto service accepts the request. The outcome arrives asynchronously: on success the transaction becomes canceled and deposit_data.refund carries tx_hash, blockchain_url and the amount sent; on failure deposit_data.refund.status is failed with an error_code and the request can be sent again. Poll POST /transactions for the outcome. Finup charges no fee, but the network fee is taken out of the transfer (on Tron up to 3 USDT).\",\"dateModified\":\"2026-10-28T11:34:44.677Z\",\"isPartOf\":{\"@id\":\"https://docs.finup.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.finup.io/api-reference/transactions/refund-a-deposit-blocked-by-the-aml-check#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.finup.io/api-reference/transactions/refund-a-deposit-blocked-by-the-aml-check#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Transactions\",\"item\":\"https://docs.finup.io/api-reference/transactions/list-account-transactions\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Refund a deposit blocked by the AML check\",\"item\":\"https://docs.finup.io/api-reference/transactions/refund-a-deposit-blocked-by-the-aml-check\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.finup.io/api-reference/transactions/refund-a-deposit-blocked-by-the-aml-check#apireference\",\"headline\":\"Refund a deposit blocked by the AML check\",\"name\":\"Refund a deposit blocked by the AML check\",\"description\":\"Sends a crypto deposit that failed the AML check (deposit_data.aml_declined, status declined) back out to the given address. Nothing was credited, so nothing is taken back. Callable by the member the deposit was addressed to or the account owner, with can_withdraw and the same TOTP rule as withdrawals. Returns as soon as the crypto service accepts the request. The outcome arrives asynchronously: on success the transaction becomes canceled and deposit_data.refund carries tx_hash, blockchain_url and the amount sent; on failure deposit_data.refund.status is failed with an error_code and the request can be sent again. Poll POST /transactions for the outcome. Finup charges no fee, but the network fee is taken out of the transfer (on Tron up to 3 USDT).\",\"url\":\"https://docs.finup.io/api-reference/transactions/refund-a-deposit-blocked-by-the-aml-check\",\"mainEntityOfPage\":{\"@id\":\"https://docs.finup.io/api-reference/transactions/refund-a-deposit-blocked-by-the-aml-check#webpage\"},\"dateModified\":\"2026-10-28T11:34:44.677Z\",\"publisher\":{\"@id\":\"https://docs.finup.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.finup.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Finup API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Finup API","nav":{"global":null,"tabs":[{"tab":"Guides","icon":"book-open","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"API reference","icon":"square-terminal","groups":[{"group":"Overview","pages":[{"title":"API reference overview","icon":"square-terminal","href":"/reference/overview"},{"title":"Users","icon":"user","href":"/reference/users"}]},{"group":"Accounts","pages":[{"title":"Create account","deprecated":null,"version":null,"openapi":"/openapi.json post /accounts","href":"/api-reference/accounts/create-account"},{"title":"Get account capabilities","deprecated":null,"version":null,"openapi":"/openapi.json get /account","href":"/api-reference/accounts/get-account-capabilities"},{"title":"Get card types available for the account","deprecated":null,"version":null,"openapi":"/openapi.json get /bins","href":"/api-reference/accounts/get-card-types-available-for-the-account"}]},{"group":"Transactions","pages":[{"title":"List account transactions","description":"Filters and pagination are both optional; pagination defaults to page 1, 50 per page. `pagination.total_records` and `pagination.total_pages` are always null here — call POST /transactions/count with the same body for the totals.","deprecated":null,"version":null,"openapi":"/openapi.json post /transactions","href":"/api-reference/transactions/list-account-transactions"},{"title":"Refund a deposit blocked by the AML check","deprecated":null,"version":null,"openapi":"/openapi.json post /transactions/{transaction_id}/aml-refund","href":"/api-reference/transactions/refund-a-deposit-blocked-by-the-aml-check"},{"title":"Count filtered transactions","description":"Totals for the same filter body POST /transactions takes. Intended to be called in parallel with the page request.","deprecated":null,"version":null,"openapi":"/openapi.json post /transactions/count","href":"/api-reference/transactions/count-filtered-transactions"},{"title":"Summarize filtered transactions","deprecated":null,"version":null,"openapi":"/openapi.json post /transactions/summary","href":"/api-reference/transactions/summarize-filtered-transactions"}]},{"group":"Cards","pages":[{"title":"Issue cards","deprecated":null,"version":null,"openapi":"/openapi.json post /cards","href":"/api-reference/cards/issue-cards"},{"title":"List account cards","deprecated":null,"version":null,"openapi":"/openapi.json post /cards/get","href":"/api-reference/cards/list-account-cards"},{"title":"Get card details","deprecated":null,"version":null,"openapi":"/openapi.json get /cards/{card_id}","href":"/api-reference/cards/get-card-details"},{"title":"Deposit funds to card","deprecated":null,"version":null,"openapi":"/openapi.json post /card/{card_id}/deposit","href":"/api-reference/cards/deposit-funds-to-card"},{"title":"Withdraw funds from card","deprecated":null,"version":null,"openapi":"/openapi.json post /card/{card_id}/withdraw","href":"/api-reference/cards/withdraw-funds-from-card"},{"title":"Freeze cards","deprecated":null,"version":null,"openapi":"/openapi.json patch /cards/freeze","href":"/api-reference/cards/freeze-cards"},{"title":"Unfreeze cards","deprecated":null,"version":null,"openapi":"/openapi.json patch /cards/unfreeze","href":"/api-reference/cards/unfreeze-cards"},{"title":"Close cards","deprecated":null,"version":null,"openapi":"/openapi.json patch /cards/close","href":"/api-reference/cards/close-cards"}]}]}]},"title":"Refund a deposit blocked by the AML check - Finup API","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-WRhTSUDL.js","utils-ChMov4Kr.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-_REmC2bI.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp6nVRCu.js","snippetPresets-DZadmXoU.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CY2WdoTl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DwYG-Q4l.js","shallow-BXQIGwv4.js","getApiPlaygroundDisplay-CK5nK5B9.js","CodeSnippet-TH4a2aGW.js","CodeSnippets-DwsQiOFS.js","Page-R3M_BF4L.js","getPastedJson-DD7kUzi_.js","icon-holE3QoJ.js","MethodPill-DUW0T8us.js","DuplicateIcon-CI_p4be-.js","createIcon-BdbRvavb.js","DynamicMarkdown-DN96a4Ur.js","SectionHeading-SCu36A9d.js","axios-vUo_bRtp.js","Markdown-CCeGv-zI.js","clsx-BGBGWFTt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cv_O2fky.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-2C5OB2eV.js"]}