Return a placed order, in two calls: a quote, then a confirm.
Connect to https://mcp.opencommerce.sh/mcp with your Commerce SDK credentials as Authorization: Bearer <YOUR_CLIENT_ID>:<YOUR_CLIENT_SECRET>. See Connect your agent.
start_return isn’t available on the server yet. Until it is, a call answers order_actions_unavailable.
Behavior: Changes state on the second call only. The quote changes nothing and can be asked again. Never resend the confirm.
What it does
Returns a whole placed order in two calls. The first call, without confirm_token, returns a quote with the refund, the card it goes back to, a confirm_token, and its expires_at, and changes nothing. Show the shopper the refund and ask.Only after the shopper says yes to that quote, call again with the same reason and the quote’s confirm_token. That opens the return once and answers return_id. The labels and the refund come later: read them with get_return.
Inputs
Field
Type
Description
shopper_id(required)
string
Your own stable id for the shopper. The same value on every call for the same person.
order_id(required)
string
The order’s id, from a buy result, get_conversation, or an order update.
reason(required)
enum
Why the shopper sends it back, in their words mapped to one of the reasons listed under Notes.
notes
string
Anything else the shopper said about the problem, as they said it. 1 to 1000 characters.
confirm_token
string
The confirm_token from this order’s quote, only after the shopper said yes to that quote. Leave it out to get the quote.
merchant
string
Only when the error is order_id_ambiguous: one of the stores the error names.
Returns
Field
Type
Description
order_id
string
The order’s id.
action
string
cancel or return.
stage
string
quote: nothing changed yet, so show the shopper the refund and ask. confirmed: the store has the request.
refund
object or null
{ amount_cents, currency }: what goes back to the shopper.
refund_to
object or null
{ brand, last4 }: the card the refund goes back to. null when the order was paid from a balance.
items
array of strings
The order lines the action covers. Empty for the whole order.
confirm_token
string or null
On a quote: pass it back with the shopper’s yes. It acts once.
expires_at
string or null
On a quote: the time the token stops working.
state
string or null
Once confirmed. For a cancel: canceled, or requested while the store hasn’t confirmed. For a return: requested, label_ready, denied, or refunded.
reason is one of damaged, not_delivered, empty_box, wrong_item, defective, not_as_described, wrong_size, no_longer_needed, or other.
If the confirming call’s result is uncertain, call get_order to see whether it went through. Never resend it.
return_not_supported means the store doesn’t take returns for this order. Tell the shopper the reason and the next step the message names.
order_actions_unavailable means returning isn’t available yet. Tell the shopper to contact the store, or check the order with get_order.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Agentcard","description":"Agentcard lets your AI agent buy anything online for your users: Vault for each user's own saved card, Issuing for cards the agent spends as itself, and opencommerce to buy from 5,026 online stores at 1% per completed order.","colors":{"primary":"#000","light":"#fff","dark":"#000"},"logo":{"light":"https://mintcdn.com/agentcard/ZxfluG2aJB7NnJ1J/logo/light.svg?fit=max\u0026auto=format\u0026n=ZxfluG2aJB7NnJ1J\u0026q=85\u0026s=1d8a10192584ca97f3cdb1fa2bb122dc","dark":"https://mintcdn.com/agentcard/ZxfluG2aJB7NnJ1J/logo/dark.svg?fit=max\u0026auto=format\u0026n=ZxfluG2aJB7NnJ1J\u0026q=85\u0026s=3ef50977098e76e7906a971d92e88839","href":"https://agentcard.sh"},"favicon":"https://mintcdn.com/agentcard/ZxfluG2aJB7NnJ1J/favicon.ico?fit=max\u0026auto=format\u0026n=ZxfluG2aJB7NnJ1J\u0026q=85\u0026s=9b691a67a81b4be3d091590a89888330","navbar":{"links":[{"href":"mailto:support@agentcard.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.agentcard.sh"}},"footer":{"socials":{"x":"https://x.com/agentcardhq"}},"integrations":{"posthog":{"apiKey":"phc_1C1Kf78UFYiOTqYbgDn6DjJkma7J2ZNhMEQObS394Ay","apiHost":"https://us.i.posthog.com","sessionRecording":false}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"markdown":{"instructions":["Agentcard is for companies whose agent buys for their users. Pick one path: the opencommerce SDK (@agent-cards/commerce-sdk) gives your agent one buy tool that finds the product, builds the cart, gets the user's approval and places the order at real stores; the Agentcard SDK (@agent-cards/sdk) pays with the user's own card when your agent already shops in a browser (Browser Use, Kernel, Browserbase, Anchor or Notte); the Purchase API (POST /buy) does the same purchase flow over plain HTTP in any language; Issuing gives the agent its own card.","Start with `npx agent-cards init` in the app's folder (Node 22 or later). No invite is needed: it creates your Agentcard account if you don't have one, installs the opencommerce SDK and puts the credentials in the env file, kept out of git. From a coding agent, run `npx agent-cards init --print --categories all --implementation tool --wallet vault --skip-install` to get the setup steps to apply yourself.","Vault is by invitation: request it at https://agentcard.com/get-started?utm_source=docs\u0026utm_medium=llms\u0026utm_campaign=agent-instructions. opencommerce needs no invite.","Never ask a user for a card number, expiry date or CVV in chat. Send them the Vault link; they add their card on Agentcard's page, and the agent never sees the number.","Every purchase is approved by the user, with a passkey or Face ID, or by an auto-approval they granted. An approval covers one merchant and one exact total. If the total changes, ask again. When a result says the user already said yes, don't ask again.","`init` writes PRODUCTION credentials, which place real orders, so test in sandbox first. For opencommerce, run `npx agent-cards credentials --mode sandbox` and put the two lines it prints in place of the production ones in the env file `init` wrote, because that command only prints them; sandbox then runs the whole flow against real stores and stops before payment, so no order is placed and nobody is charged. For Vault and Issuing, sandbox credentials issue test cards that no real merchant accepts; try the checkout against shop.agentcard.sh, a test store on Stripe test mode.","Tell the user an order is placed only after Agentcard reports it placed.","Vault is free up to 5,000 users (https://agentcard.com/pricing). opencommerce takes 1% of each completed order. Full docs in one file: https://docs.agentcard.com/llms-full.txt"]},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"agentcard","hasAudioNarration":false,"actualSubdomain":"agentcard","customDomains":["docs.agentcard.com"],"gitSource":{"type":"github","owner":"tiny-agent-company","repo":"tiny-agent-company","deployBranch":"main","contentDirectory":"apps/agent-cards/docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afc967bfb29084f48a0bce4","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"MCP","count":120},{"language":"default","tag":"API reference","count":92},{"language":"default","tag":"User tools","count":92},{"language":"default","tag":"Guides","count":63},{"language":"default","tag":"Vault","count":52},{"language":"default","tag":"Webhooks","count":51},{"language":"default","tag":"Events","count":49},{"language":"default","tag":"Cards","count":30},{"language":"default","tag":"Getting started","count":30},{"language":"default","tag":"Commerce SDK","count":28}],"searchSettings":{"isFiltersEnabled":true}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@agentcard.com"}},"basePath":"","hasChatPermissions":false,"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":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"nav a[href^=\"https://agentcard.sh\"]{background-color:#1520b8;color:#fff!important;border-radius:9999px;padding-left:14px;padding-right:12px;transition:background-color 200ms ease}nav a[href^=\"https://agentcard.sh\"]:hover{background-color:#2e3ae8}nav a[href^=\"https://agentcard.sh\"] *{color:#fff!important;background:transparent!important}#agentcard-cta{margin-top:24px}.ac-cta-box{border:1px solid rgba(21, 32, 184, 0.15);border-radius:16px;padding:20px;background:linear-gradient(180deg, rgba(21, 32, 184, 0.04) 0%, rgba(21, 32, 184, 0.02) 100%)}html.dark .ac-cta-box{border-color:rgba(70, 83, 240, 0.25);background:linear-gradient(180deg, rgba(46, 58, 232, 0.09) 0%, rgba(46, 58, 232, 0.04) 100%)}.ac-cta-logo{height:20px;width:auto;display:block}.ac-cta-logo-dark{display:none}html.dark .ac-cta-logo-light{display:none}html.dark .ac-cta-logo-dark{display:block}.ac-cta-title{margin:14px 0 0;font-size:18px;font-weight:600;line-height:1.3;color:#111}html.dark .ac-cta-title{color:#fff}.ac-cta-description{margin:8px 0 0;font-size:13px;line-height:1.5;color:#666}.ac-cta-description strong{color:#333}html.dark .ac-cta-description{color:#aaa}html.dark .ac-cta-description strong{color:#ddd}.ac-cta-buttons{display:flex;flex-direction:column;gap:8px;margin-top:16px}.ac-cta-btn-primary,.ac-cta-btn-secondary{display:flex;align-items:center;justify-content:center;height:40px;border-radius:9999px;font-size:14px;font-weight:500;text-decoration:none;transition:background-color 200ms ease, border-color 200ms ease}.ac-cta-btn-primary{background:#1520b8;color:#ffffff!important}.ac-cta-btn-primary:hover{background:#2e3ae8}html.dark .ac-cta-btn-primary{background:#2e3ae8}html.dark .ac-cta-btn-primary:hover{background:#4653f0}.ac-cta-btn-secondary{background:#fff;border:1px solid #e5e7eb;color:#333!important}.ac-cta-btn-secondary:hover{background:#f9fafb;border-color:#d1d5db}html.dark .ac-cta-btn-secondary{background:rgba(255, 255, 255, 0.05);border-color:rgba(255, 255, 255, 0.1);color:#ddd!important}html.dark .ac-cta-btn-secondary:hover{background:rgba(255, 255, 255, 0.1);border-color:rgba(255, 255, 255, 0.2)}@media (max-width: 1024px){#agentcard-cta{display:none}}#footer a.max-w-36{max-width:none;overflow:visible;text-overflow:clip;white-space:nowrap}#footer div:has(>a.max-w-36){flex-wrap:wrap}nav[aria-label=\"Pages\"]:has(a[href=\"/webhooks/overview\"]) div.flex-1.items-center.gap-2>span{font-weight:600;font-size:12px}html.dark nav[aria-label=\"Pages\"]:has(a[href=\"/webhooks/overview\"]) div.flex-1.items-center.gap-2>span{color:rgb(222, 222, 222)}html:not(.dark) nav[aria-label=\"Pages\"]:has(a[href=\"/webhooks/overview\"]) div.flex-1.items-center.gap-2>span{color:rgb(31, 41, 55)}#sidebar-content{width:22rem}#table-of-contents-layout{width:17rem}"}],"page":{"pagePath":"commerce-mcp/tools/start_return","slug":"/commerce-mcp/tools/start_return","pageMetadata":{"title":"start_return","sidebarTitle":"start_return","description":"Return a placed order, in two calls: a quote, then a confirm.","tag":"Soon","href":"/commerce-mcp/tools/start_return"},"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: \"Return a placed order, in two calls: a quote, then a confirm.\"\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`,em:`em`,li:`li`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Connect to `,_jsx(_components.code,{children:`https://mcp.opencommerce.sh/mcp`}),` with your Commerce SDK credentials as `,_jsx(_components.code,{children:`Authorization: Bearer \u003cYOUR_CLIENT_ID>:\u003cYOUR_CLIENT_SECRET>`}),`. See `,_jsx(_components.a,{href:`/commerce-mcp/implement#connect-a-client`,children:`Connect your agent`}),`.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`start_return`}),` isn’t available on the server yet. Until it is, a call answers `,_jsx(_components.code,{children:`order_actions_unavailable`}),`.`]})}),`\n`,_jsx(_components.p,{children:`Behavior: Changes state on the second call only. The quote changes nothing and can be asked again. Never resend the confirm.`}),`\n`,_jsx(Heading,{level:`2`,id:`what-it-does`,children:`What it does`}),`\n`,_jsxs(_components.p,{children:[`Returns a whole placed order in two calls. The first call, without `,_jsx(_components.code,{children:`confirm_token`}),`, returns a quote with the refund, the card it goes back to, a `,_jsx(_components.code,{children:`confirm_token`}),`, and its `,_jsx(_components.code,{children:`expires_at`}),`, and changes nothing. Show the shopper the refund and ask.`]}),`\n`,_jsxs(_components.p,{children:[`Only after the shopper says yes to that quote, call again with the same `,_jsx(_components.code,{children:`reason`}),` and the quote’s `,_jsx(_components.code,{children:`confirm_token`}),`. That opens the return once and answers `,_jsx(_components.code,{children:`return_id`}),`. The labels and the refund come later: read them with `,_jsx(_components.a,{href:`/commerce-mcp/tools/get_return`,children:_jsx(_components.code,{children:`get_return`})}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`inputs`,children:`Inputs`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`shopper_id`}),` `,_jsx(_components.em,{children:`(required)`})]}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Your own stable id for the shopper. The same value on every call for the same person.`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`order_id`}),` `,_jsx(_components.em,{children:`(required)`})]}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`The order’s id, from a `,_jsx(_components.code,{children:`buy`}),` result, `,_jsx(_components.code,{children:`get_conversation`}),`, or an order update.`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`reason`}),` `,_jsx(_components.em,{children:`(required)`})]}),_jsx(_components.td,{children:`enum`}),_jsx(_components.td,{children:`Why the shopper sends it back, in their words mapped to one of the reasons listed under Notes.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`notes`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Anything else the shopper said about the problem, as they said it. 1 to 1000 characters.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`confirm_token`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`The `,_jsx(_components.code,{children:`confirm_token`}),` from this order’s quote, only after the shopper said yes to that quote. Leave it out to get the quote.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`merchant`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Only when the error is `,_jsx(_components.code,{children:`order_id_ambiguous`}),`: one of the stores the error names.`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`returns`,children:`Returns`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`order_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`The order’s id.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`action`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`cancel`}),` or `,_jsx(_components.code,{children:`return`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`stage`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`quote`}),`: nothing changed yet, so show the shopper the refund and ask. `,_jsx(_components.code,{children:`confirmed`}),`: the store has the request.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`refund`})}),_jsx(_components.td,{children:`object or null`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`{ amount_cents, currency }`}),`: what goes back to the shopper.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`refund_to`})}),_jsx(_components.td,{children:`object or null`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`{ brand, last4 }`}),`: the card the refund goes back to. `,_jsx(_components.code,{children:`null`}),` when the order was paid from a balance.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`items`})}),_jsx(_components.td,{children:`array of strings`}),_jsx(_components.td,{children:`The order lines the action covers. Empty for the whole order.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`confirm_token`})}),_jsx(_components.td,{children:`string or null`}),_jsx(_components.td,{children:`On a quote: pass it back with the shopper’s yes. It acts once.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`expires_at`})}),_jsx(_components.td,{children:`string or null`}),_jsx(_components.td,{children:`On a quote: the time the token stops working.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`state`})}),_jsx(_components.td,{children:`string or null`}),_jsxs(_components.td,{children:[`Once confirmed. For a cancel: `,_jsx(_components.code,{children:`canceled`}),`, or `,_jsx(_components.code,{children:`requested`}),` while the store hasn’t confirmed. For a return: `,_jsx(_components.code,{children:`requested`}),`, `,_jsx(_components.code,{children:`label_ready`}),`, `,_jsx(_components.code,{children:`denied`}),`, or `,_jsx(_components.code,{children:`refunded`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`return_id`})}),_jsx(_components.td,{children:`string or null`}),_jsxs(_components.td,{children:[`A confirmed return’s id, for `,_jsx(_components.code,{children:`get_return`}),`.`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`example-calls`,children:`Example calls`}),`\n`,_jsx(_components.p,{children:`Ask for the quote:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,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:`9`,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:` \"tool\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"start_return\"`}),_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:` \"arguments\"`}),_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:` \"shopper_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"user_8f3a21\"`}),_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:` \"order_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003cORDER_ID>\"`}),_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:` \"reason\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"damaged\"`}),_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:` \"notes\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"The box arrived crushed.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`After the shopper says yes to the quote, send the same call with its token:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`10`,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:`10`,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:` \"tool\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"start_return\"`}),_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:` \"arguments\"`}),_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:` \"shopper_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"user_8f3a21\"`}),_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:` \"order_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003cORDER_ID>\"`}),_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:` \"reason\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"damaged\"`}),_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:` \"notes\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"The box arrived crushed.\"`}),_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:` \"confirm_token\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003cCONFIRM_TOKEN>\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`notes`,children:`Notes`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`reason`}),` is one of `,_jsx(_components.code,{children:`damaged`}),`, `,_jsx(_components.code,{children:`not_delivered`}),`, `,_jsx(_components.code,{children:`empty_box`}),`, `,_jsx(_components.code,{children:`wrong_item`}),`, `,_jsx(_components.code,{children:`defective`}),`, `,_jsx(_components.code,{children:`not_as_described`}),`, `,_jsx(_components.code,{children:`wrong_size`}),`, `,_jsx(_components.code,{children:`no_longer_needed`}),`, or `,_jsx(_components.code,{children:`other`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`If the confirming call’s result is uncertain, call `,_jsx(_components.a,{href:`/commerce-mcp/tools/get_order`,children:_jsx(_components.code,{children:`get_order`})}),` to see whether it went through. Never resend it.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`return_not_supported`}),` means the store doesn’t take returns for this order. Tell the shopper the reason and the next step the message names.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`order_actions_unavailable`}),` means returning isn’t available yet. Tell the shopper to contact the store, or check the order with `,_jsx(_components.code,{children:`get_order`}),`.`]}),`\n`]})]})}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":"start_return","sidebarTitle":"start_return","description":"Return a placed order, in two calls: a quote, then a confirm.","tag":"Soon","href":"/commerce-mcp/tools/start_return"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What it does","slug":"what-it-does","depth":2,"children":[]},{"title":"Inputs","slug":"inputs","depth":2,"children":[]},{"title":"Returns","slug":"returns","depth":2,"children":[]},{"title":"Example calls","slug":"example-calls","depth":2,"children":[]},{"title":"Notes","slug":"notes","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/agentcard/b756546712a1ddf3/vector.js","/_mintlify/custom/agentcard/58f05fe16da3f154/agentcard-cta.js","/_mintlify/custom/agentcard/4e624125805329e1/same-tab-links.js"],"subdomain":"agentcard","siteName":"Agentcard","title":"start_return - Agentcard","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-13T23:32:37.343Z","originalFileLocation":"commerce-mcp/tools/start_return.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=\"Return a placed order, in two calls: a quote, then a confirm.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Agentcard\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/agentcard/A6lDmirySbdlXtFn/_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/agentcard/A6lDmirySbdlXtFn/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/agentcard/A6lDmirySbdlXtFn/_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/agentcard/A6lDmirySbdlXtFn/_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/agentcard/A6lDmirySbdlXtFn/_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/agentcard/A6lDmirySbdlXtFn/_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/agentcard/A6lDmirySbdlXtFn/_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/agentcard/A6lDmirySbdlXtFn/_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/agentcard/A6lDmirySbdlXtFn/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"start_return - Agentcard\">\u003cmeta data-mint-head property=\"og:description\" content=\"Return a placed order, in two calls: a quote, then a confirm.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Agentcard\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.agentcard.com/commerce-mcp/tools/start_return\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://agentcard.mintlify.site/_mintlify/api/og/v2?division=Orders+and+updates\u0026amp;title=start_return\u0026amp;description=Return+a+placed+order%2C+in+two+calls%3A+a+quote%2C+then+a+confirm.\u0026amp;theme=8a730d3f394e0de49720ada6\u0026amp;signature=9d3d82ca9fb507357efcd4c290ef13eef8ad91d328a4be35ee8d0365f74466f8\">\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=\"start_return - Agentcard\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Return a placed order, in two calls: a quote, then a confirm.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://agentcard.mintlify.site/_mintlify/api/og/v2?division=Orders+and+updates\u0026amp;title=start_return\u0026amp;description=Return+a+placed+order%2C+in+two+calls%3A+a+quote%2C+then+a+confirm.\u0026amp;theme=8a730d3f394e0de49720ada6\u0026amp;signature=9d3d82ca9fb507357efcd4c290ef13eef8ad91d328a4be35ee8d0365f74466f8\">\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/agentcard/A6lDmirySbdlXtFn/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Agentcard\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.agentcard.com/commerce-mcp/tools/start_return\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/commerce-mcp/tools/start_return.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.agentcard.com/#organization\",\"name\":\"Agentcard\",\"url\":\"https://docs.agentcard.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/agentcard/ZxfluG2aJB7NnJ1J/logo/light.svg?fit=max\u0026auto=format\u0026n=ZxfluG2aJB7NnJ1J\u0026q=85\u0026s=1d8a10192584ca97f3cdb1fa2bb122dc\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.agentcard.com#website\",\"name\":\"Agentcard\",\"url\":\"https://docs.agentcard.com\",\"publisher\":{\"@id\":\"https://docs.agentcard.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.agentcard.com/commerce-mcp/tools/start_return#webpage\",\"url\":\"https://docs.agentcard.com/commerce-mcp/tools/start_return\",\"name\":\"start_return\",\"description\":\"Return a placed order, in two calls: a quote, then a confirm.\",\"dateModified\":\"2026-11-13T23:32:37.343Z\",\"isPartOf\":{\"@id\":\"https://docs.agentcard.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.agentcard.com/commerce-mcp/tools/start_return#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.agentcard.com/commerce-mcp/tools/start_return#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Orders and updates\",\"item\":\"https://docs.agentcard.com/commerce-mcp/tools/get_updates\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"start_return\",\"item\":\"https://docs.agentcard.com/commerce-mcp/tools/start_return\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.agentcard.com/commerce-mcp/tools/start_return#article\",\"headline\":\"start_return\",\"name\":\"start_return\",\"description\":\"Return a placed order, in two calls: a quote, then a confirm.\",\"url\":\"https://docs.agentcard.com/commerce-mcp/tools/start_return\",\"mainEntityOfPage\":{\"@id\":\"https://docs.agentcard.com/commerce-mcp/tools/start_return#webpage\"},\"dateModified\":\"2026-11-13T23:32:37.343Z\",\"publisher\":{\"@id\":\"https://docs.agentcard.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.agentcard.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Agentcard\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Agentcard\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/commerce-mcp/tools/start_return.md","siteName":"Agentcard","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/getting-started"}]},{"tab":"API reference","pages":[{"title":"API reference","href":"/api-reference/overview"}]},{"tab":"Webhooks","pages":[{"title":"Webhooks","href":"/webhooks/overview"}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/tools/cli"}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/tools/mcp"}]},{"tab":"Commerce MCP","groups":[{"group":"Commerce MCP","pages":[{"title":"Connect to the Commerce MCP server","sidebarTitle":"Overview","href":"/commerce-mcp"},{"title":"Connect your agent to the Commerce MCP server","sidebarTitle":"Implement","href":"/commerce-mcp/implement"},{"title":"Give your model the shopping skill","sidebarTitle":"Skill","href":"/commerce-mcp/skill"}]},{"group":"Shopping","pages":[{"title":"buy","sidebarTitle":"buy","href":"/commerce-mcp/tools/buy"},{"title":"get_conversation","sidebarTitle":"get_conversation","href":"/commerce-mcp/tools/get_conversation"},{"title":"change_plan","sidebarTitle":"change_plan","href":"/commerce-mcp/tools/change_plan"},{"title":"remove_cart_line","sidebarTitle":"remove_cart_line","href":"/commerce-mcp/tools/remove_cart_line"},{"title":"list_merchants","sidebarTitle":"list_merchants","href":"/commerce-mcp/tools/list_merchants"}]},{"group":"Orders and updates","pages":[{"title":"get_updates","sidebarTitle":"get_updates","href":"/commerce-mcp/tools/get_updates"},{"title":"get_order","sidebarTitle":"get_order","href":"/commerce-mcp/tools/get_order"},{"title":"cancel_order","sidebarTitle":"cancel_order","description":"Cancel a placed order, in two calls: a quote, then a confirm.","tag":"Soon","href":"/commerce-mcp/tools/cancel_order"},{"title":"start_return","sidebarTitle":"start_return","tag":"Soon","href":"/commerce-mcp/tools/start_return"},{"title":"get_return","sidebarTitle":"get_return","description":"Read where a return is: its state, labels, and refund.","tag":"Soon","href":"/commerce-mcp/tools/get_return"}]},{"group":"Saved carts","pages":[{"title":"list_carts","sidebarTitle":"list_carts","href":"/commerce-mcp/tools/list_carts"},{"title":"get_cart","sidebarTitle":"get_cart","href":"/commerce-mcp/tools/get_cart"},{"title":"update_cart_line","sidebarTitle":"update_cart_line","href":"/commerce-mcp/tools/update_cart_line"},{"title":"remove_cart_store","sidebarTitle":"remove_cart_store","href":"/commerce-mcp/tools/remove_cart_store"},{"title":"resume_cart","sidebarTitle":"resume_cart","href":"/commerce-mcp/tools/resume_cart"},{"title":"set_cart_delivery","sidebarTitle":"set_cart_delivery","href":"/commerce-mcp/tools/set_cart_delivery"}]},{"group":"Saved addresses","pages":[{"title":"list_addresses","sidebarTitle":"list_addresses","tag":"Soon","href":"/commerce-mcp/tools/list_addresses"},{"title":"save_address","sidebarTitle":"save_address","tag":"Soon","href":"/commerce-mcp/tools/save_address"},{"title":"remove_address","sidebarTitle":"remove_address","tag":"Soon","href":"/commerce-mcp/tools/remove_address"}]},{"group":"Account and stats","pages":[{"title":"get_account","sidebarTitle":"get_account","href":"/commerce-mcp/tools/get_account"},{"title":"list_cards","sidebarTitle":"list_cards","href":"/commerce-mcp/tools/list_cards"},{"title":"get_stats","sidebarTitle":"get_stats","href":"/commerce-mcp/tools/get_stats"}]}]}]},"basePath":"","title":"start_return - Agentcard","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":[],"chunks":[]}