Agents or their owners can withdraw funds from an agent’s wallet back to the owner’s verified bank account at any time. Withdrawals are processed via Cashfree vendor settlement.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Amrood","colors":{"primary":"#16a34a","light":"#22c55e","dark":"#15803d"},"logo":{"light":"https://mintcdn.com/propublicafinanceandinvestmentservicespvtltd/EkPLlJZmM9cgINio/logo/amrood.svg?fit=max\u0026auto=format\u0026n=EkPLlJZmM9cgINio\u0026q=85\u0026s=3a23b23cf89d8be6e16b91c72b68dfdd","dark":"https://mintcdn.com/propublicafinanceandinvestmentservicespvtltd/EkPLlJZmM9cgINio/logo/amrood.svg?fit=max\u0026auto=format\u0026n=EkPLlJZmM9cgINio\u0026q=85\u0026s=3a23b23cf89d8be6e16b91c72b68dfdd","href":"https://amrood.io"},"favicon":"/favicon.png","api":{"openapi":["api-reference/openapi.json"]},"navbar":{"links":[{"href":"https://amrood.io/signup","label":"Sign Up"}],"primary":{"type":"button","label":"Get API Keys","href":"https://amrood.io/signup"}},"footer":{"socials":{"x":"https://x.com/amrood_io"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"propublicafinanceandinvestmentservicespvtltd","hasAudioNarration":false,"actualSubdomain":"propublicafinanceandinvestmentservicespvtltd","customDomains":["docs.amrood.io"],"gitSource":{"type":"github","owner":"amroodio","repo":"amrood","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae9488a6cb575c06c4eb66b:success","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"Documentation","count":20},{"language":"default","tag":"Payments","count":6},{"language":"default","tag":"Concepts","count":5},{"language":"default","tag":"Getting Started","count":4},{"language":"default","tag":"Governance","count":3},{"language":"default","tag":"API Reference","count":2},{"language":"default","tag":"Use Cases","count":1},{"language":"default","tag":"Events","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":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":"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":"llms-txt-v2","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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"payments/withdrawals","slug":"/payments/withdrawals","pageMetadata":{"title":"Withdrawals","description":"Withdraw agent balances to the owner's bank account","href":"/payments/withdrawals","hidden":false},"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: \"Withdraw agent balances to the owner’s bank account\"\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`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Mermaid,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`1`,id:`withdrawals`,children:`Withdrawals`}),`\n`,_jsx(_components.p,{children:`Agents or their owners can withdraw funds from an agent’s wallet back to the owner’s verified bank account at any time. Withdrawals are processed via Cashfree vendor settlement.`}),`\n`,_jsx(Heading,{level:`2`,id:`three-ways-to-withdraw`,children:`Three Ways to Withdraw`}),`\n`,_jsx(Heading,{level:`3`,id:`1-via-api`,children:`1. Via API`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,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:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -X POST https://api.amrood.io/v1/agents/agt_xxx/withdraw \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"x-agent-key: agk_live_xxx\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -d `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'{}'`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`This withdraws the agent’s full available balance. The response:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,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:`5`,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:` \"withdrawn\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`4500.00`}),_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:`\"completed\"`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"₹4,500.00 withdrawal initiated to your bank account\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`2-via-mcp`,children:`2. Via MCP`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`> Withdraw my agent's balance`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Claude: Withdrawal of ₹4,500.00 initiated.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Funds will arrive in your bank account within 1-2 business days.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`3`,id:`3-via-web-dashboard`,children:`3. Via Web Dashboard`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Log in to `,_jsx(_components.a,{href:`https://amrood.io`,children:`amrood.io`}),` with your phone number (OTP)`]}),`\n`,_jsx(_components.li,{children:`Find the agent card on your profile page`}),`\n`,_jsxs(_components.li,{children:[`Click the `,_jsx(_components.strong,{children:`Withdraw`}),` button (visible when balance > ₹0)`]}),`\n`,_jsx(_components.li,{children:`Confirm the withdrawal amount`}),`\n`]}),`\n`,_jsx(_components.p,{children:`The dashboard calls the same API under the hood, authenticated via your owner session.`}),`\n`,_jsx(Heading,{level:`2`,id:`how-it-works`,children:`How It Works`}),`\n`,_jsx(Mermaid,{chart:`sequenceDiagram\n participant Owner as Owner / Agent\n participant Amrood as Amrood API\n participant CF as Cashfree\n participant Bank as Owner's Bank\n\n Owner->>Amrood: POST /v1/agents/{id}/withdraw\n Amrood->>CF: Trigger on-demand settlement\n CF->>Bank: Transfer funds\n CF-->>Amrood: Settlement webhook\n Amrood->>Amrood: Zero out agent balance\n Amrood-->>Owner: SMS + WhatsApp notification`}),`\n`,_jsx(Heading,{level:`3`,id:`step-by-step`,children:`Step by step`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`The withdrawal request triggers a Cashfree on-demand vendor settlement`}),`\n`,_jsx(_components.li,{children:`Cashfree transfers the vendor’s unsettled balance to the owner’s bank account`}),`\n`,_jsx(_components.li,{children:`When the settlement completes, Amrood receives a webhook`}),`\n`,_jsxs(_components.li,{children:[`The agent’s `,_jsx(_components.code,{children:`balance_cache`}),` is set to ₹0`]}),`\n`,_jsxs(_components.li,{children:[`A `,_jsx(_components.code,{children:`withdrawal`}),` transaction is recorded in the ledger`]}),`\n`,_jsx(_components.li,{children:`The owner receives SMS and WhatsApp notifications with the amount and UTR reference`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`timing`,children:`Timing`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Method`}),_jsx(_components.th,{children:`Typical Duration`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`On-demand settlement`}),_jsx(_components.td,{children:`1-2 business days`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Auto-settlement (T+2)`}),_jsx(_components.td,{children:`2 business days after funding`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`fees`,children:`Fees`}),`\n`,_jsx(_components.p,{children:`There are no Amrood fees on withdrawals. Standard Cashfree settlement fees may apply.`}),`\n`,_jsx(Heading,{level:`2`,id:`automatic-settlement-vs-manual-withdrawal`,children:`Automatic Settlement vs. Manual Withdrawal`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{}),_jsx(_components.th,{children:`Auto-Settlement`}),_jsx(_components.th,{children:`Manual Withdrawal`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Trigger`})}),_jsx(_components.td,{children:`Automatic on T+2 schedule`}),_jsx(_components.td,{children:`Owner/agent initiates`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Timing`})}),_jsx(_components.td,{children:`2 business days after funding`}),_jsx(_components.td,{children:`1-2 business days after request`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`What happens`})}),_jsx(_components.td,{children:`All agent balances under vendor zeroed`}),_jsx(_components.td,{children:`Requested agent’s balance zeroed`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Use case`})}),_jsx(_components.td,{children:`Default behavior, no action needed`}),_jsx(_components.td,{children:`When you need funds sooner`})]})]})]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`After either auto-settlement or manual withdrawal, the agent’s balance is zeroed out. Fund the agent again if it needs to continue transacting.`})}),`\n`,_jsx(Heading,{level:`2`,id:`notifications`,children:`Notifications`}),`\n`,_jsx(_components.p,{children:`On successful withdrawal, the owner receives:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`SMS`}),` with withdrawal amount and UTR`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`WhatsApp`}),` message with formatted details`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Webhook`}),`: `,_jsx(_components.code,{children:`agent.withdrawal.completed`}),` event to your platform`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`error-cases`,children:`Error Cases`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Scenario`}),_jsx(_components.th,{children:`Response`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Agent balance is ₹0`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`400: No funds to withdraw`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Agent not found or not owned by caller`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`404: Agent not found`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Cashfree settlement fails`}),_jsx(_components.td,{children:`Falls back to ledger-only update`})]})]})]})]})}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":"Withdrawals","description":"Withdraw agent balances to the owner's bank account","href":"/payments/withdrawals","hidden":false}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Withdrawals","slug":"withdrawals","depth":1,"children":[]},{"title":"Three Ways to Withdraw","slug":"three-ways-to-withdraw","depth":2,"children":[{"title":"1. Via API","slug":"1-via-api","depth":3,"children":[]},{"title":"2. Via MCP","slug":"2-via-mcp","depth":3,"children":[]},{"title":"3. Via Web Dashboard","slug":"3-via-web-dashboard","depth":3,"children":[]}]},{"title":"How It Works","slug":"how-it-works","depth":2,"children":[{"title":"Step by step","slug":"step-by-step","depth":3,"children":[]}]},{"title":"Timing","slug":"timing","depth":2,"children":[]},{"title":"Fees","slug":"fees","depth":2,"children":[]},{"title":"Automatic Settlement vs. Manual Withdrawal","slug":"automatic-settlement-vs-manual-withdrawal","depth":2,"children":[]},{"title":"Notifications","slug":"notifications","depth":2,"children":[]},{"title":"Error Cases","slug":"error-cases","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"propublicafinanceandinvestmentservicespvtltd","siteName":"Amrood","title":"Withdrawals - Amrood","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-07T09:24:06.044Z","originalFileLocation":"payments/withdrawals.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=\"Withdraw agent balances to the owner\u0026#x27;s bank account\">\u003cmeta data-mint-head name=\"application-name\" content=\"Amrood\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/propublicafinanceandinvestmentservicespvtltd/u-5953WzlTsjKzIt/_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/propublicafinanceandinvestmentservicespvtltd/u-5953WzlTsjKzIt/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/propublicafinanceandinvestmentservicespvtltd/u-5953WzlTsjKzIt/_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/propublicafinanceandinvestmentservicespvtltd/u-5953WzlTsjKzIt/_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/propublicafinanceandinvestmentservicespvtltd/u-5953WzlTsjKzIt/_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/propublicafinanceandinvestmentservicespvtltd/u-5953WzlTsjKzIt/_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/propublicafinanceandinvestmentservicespvtltd/u-5953WzlTsjKzIt/_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/propublicafinanceandinvestmentservicespvtltd/u-5953WzlTsjKzIt/_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/propublicafinanceandinvestmentservicespvtltd/u-5953WzlTsjKzIt/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Withdrawals - Amrood\">\u003cmeta data-mint-head property=\"og:description\" content=\"Withdraw agent balances to the owner\u0026#x27;s bank account\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Amrood\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.amrood.io/payments/withdrawals\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://propublicafinanceandinvestmentservicespvtltd.mintlify.site/_mintlify/api/og/v2?division=Payments\u0026amp;title=Withdrawals\u0026amp;description=Withdraw+agent+balances+to+the+owner%27s+bank+account\u0026amp;theme=d8c4d30f0ef545c889bb73e3\u0026amp;signature=6ab4f96725b40c9748ac19c4ed5fe0f99d69000b8c30abf399af7d55ca372858\">\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=\"Withdrawals - Amrood\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Withdraw agent balances to the owner\u0026#x27;s bank account\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://propublicafinanceandinvestmentservicespvtltd.mintlify.site/_mintlify/api/og/v2?division=Payments\u0026amp;title=Withdrawals\u0026amp;description=Withdraw+agent+balances+to+the+owner%27s+bank+account\u0026amp;theme=d8c4d30f0ef545c889bb73e3\u0026amp;signature=6ab4f96725b40c9748ac19c4ed5fe0f99d69000b8c30abf399af7d55ca372858\">\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/propublicafinanceandinvestmentservicespvtltd/u-5953WzlTsjKzIt/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Amrood\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16a34a\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.amrood.io/payments/withdrawals\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/payments/withdrawals.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.amrood.io/#organization\",\"name\":\"Amrood\",\"url\":\"https://docs.amrood.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/propublicafinanceandinvestmentservicespvtltd/EkPLlJZmM9cgINio/logo/amrood.svg?fit=max\u0026auto=format\u0026n=EkPLlJZmM9cgINio\u0026q=85\u0026s=3a23b23cf89d8be6e16b91c72b68dfdd\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.amrood.io#website\",\"name\":\"Amrood\",\"url\":\"https://docs.amrood.io\",\"publisher\":{\"@id\":\"https://docs.amrood.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.amrood.io/payments/withdrawals#webpage\",\"url\":\"https://docs.amrood.io/payments/withdrawals\",\"name\":\"Withdrawals\",\"description\":\"Withdraw agent balances to the owner's bank account\",\"dateModified\":\"2026-03-07T09:24:06.044Z\",\"isPartOf\":{\"@id\":\"https://docs.amrood.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.amrood.io/payments/withdrawals#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.amrood.io/payments/withdrawals#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Payments\",\"item\":\"https://docs.amrood.io/payments/funding\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Withdrawals\",\"item\":\"https://docs.amrood.io/payments/withdrawals\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.amrood.io/payments/withdrawals#article\",\"headline\":\"Withdrawals\",\"name\":\"Withdrawals\",\"description\":\"Withdraw agent balances to the owner's bank account\",\"url\":\"https://docs.amrood.io/payments/withdrawals\",\"mainEntityOfPage\":{\"@id\":\"https://docs.amrood.io/payments/withdrawals#webpage\"},\"dateModified\":\"2026-03-07T09:24:06.044Z\",\"publisher\":{\"@id\":\"https://docs.amrood.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.amrood.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Amrood\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Amrood","nav":{"global":null,"tabs":[{"tab":"Documentation","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":"/introduction"},{"title":"Quickstart","href":"/quickstart"},{"title":"Authentication","href":"/authentication"},{"title":"MCP Server","href":"/mcp"}]},{"group":"Payments","pages":[{"title":"Funding Agent Wallets","href":"/payments/funding"},{"title":"Agent-to-Agent Payments","href":"/payments/transfers"},{"title":"Balance \u0026 Transactions","description":"Check agent balances and query transaction history","href":"/payments/balance-transactions"},{"title":"Withdrawals","href":"/payments/withdrawals"},{"title":"Escrow","description":"Hold funds in escrow with timeouts, attestation, and conditional release","href":"/payments/escrow"},{"title":"HTTP 402 Paywall","href":"/payments/x402-paywall"}]},{"group":"Concepts","pages":[{"title":"Human Owners","href":"/concepts/owners"},{"title":"Agent Identities","href":"/concepts/agents"},{"title":"Agent Wallets","href":"/concepts/wallets"},{"title":"Organizations","href":"/concepts/organizations"},{"title":"Agent Certificates","href":"/concepts/certificates"}]},{"group":"Governance","pages":[{"title":"Policy Engine","href":"/governance/policies"},{"title":"Risk Monitoring","href":"/governance/risk-monitoring"},{"title":"Kill Switches","href":"/governance/kill-switches"}]},{"group":"Events","pages":[{"title":"Webhooks","href":"/webhooks"}]},{"group":"Use Cases","pages":[{"title":"Use Cases","href":"/use-cases"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/overview"}]}]},"basePath":"","title":"Withdrawals - Amrood","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":[],"chunks":[]}