{
  "listings": [
    {
      "slug": "adobe-commerce",
      "name": "Adobe Commerce (Magento)",
      "company": "Adobe Inc.",
      "grade": "D",
      "fit": "caveat",
      "why": "POST /V1/order/{id}/refund and /V1/invoice/{id}/refund create a credit memo and update the order in one call, but no quote step or idempotency key is documented, so a retry can refund twice.",
      "source": "https://raw.githubusercontent.com/AdobeDocs/commerce-webapi/main/src/pages/rest/tutorials/orders/order-issue-refund.md",
      "confidence": "medium",
      "url": "https://www.anchorterminal.com/tools/adobe-commerce"
    },
    {
      "slug": "bigcommerce",
      "name": "BigCommerce API + MCP",
      "company": "Commerce.com US, Inc.",
      "grade": "B",
      "fit": "caveat",
      "why": "get_refund_quote then create_refund re-quotes and refuses on mismatch, but create_refund has no idempotency and the docs say a second submit can refund twice; readback is through get_orders refunded amount.",
      "source": "https://docs.bigcommerce.com/developer/api-reference/mcp/store-management.md",
      "confidence": "high",
      "url": "https://www.anchorterminal.com/tools/bigcommerce"
    },
    {
      "slug": "commerce-layer",
      "name": "Commerce Layer API + MCP",
      "company": "Commerce Layer, Inc.",
      "grade": "B",
      "fit": "caveat",
      "why": "Orders carry a refund trigger and webhooks fire orders.refund, but the docs read show no quote step, and earlier reading found no confirmation on the MCP's delete tool.",
      "source": "https://docs.commercelayer.io/core/real-time-webhooks.md",
      "confidence": "medium",
      "url": "https://www.anchorterminal.com/tools/commerce-layer"
    },
    {
      "slug": "commercetools",
      "name": "commercetools",
      "company": "commercetools GmbH",
      "grade": "BB",
      "fit": "caveat",
      "why": "Payments and transactions are tools, but a refund is a transaction with no quote step, and writes use optimistic version checks rather than idempotency keys, so a retry after a timeout must re-read first.",
      "source": "https://docs.commercetools.com/dev-tooling/mcp/commerce-mcp.md",
      "confidence": "high",
      "url": "https://www.anchorterminal.com/tools/commercetools"
    },
    {
      "slug": "elastic-path",
      "name": "Elastic Path API + MCP",
      "company": "Elastic Path Software Inc.",
      "grade": "C",
      "fit": "caveat",
      "why": "Refund a Transaction refunds through the gateway or marks a refund recorded elsewhere, but there is no quote, no idempotency key and no read-only or confirmation mode on the MCP.",
      "source": "https://developer.elasticpath.com/llms.txt",
      "confidence": "low",
      "url": "https://www.anchorterminal.com/tools/elastic-path"
    },
    {
      "slug": "fabric",
      "name": "Fabric",
      "company": "Commerce Fabric, Inc.",
      "grade": "E",
      "fit": "caveat",
      "why": "check-return-eligibility, check-credits-eligibility and appeasement actions guard refunds and credits, but no idempotency key appears anywhere in the Orders reference, so a retry can repeat a credit.",
      "source": "https://developer.fabric.inc/openapi/orders/v3/orders.openapi.yaml",
      "confidence": "medium",
      "url": "https://www.anchorterminal.com/tools/fabric"
    },
    {
      "slug": "medusa",
      "name": "Medusa API + MCP",
      "company": "MedusaJS, Inc.",
      "grade": "C",
      "fit": "caveat",
      "why": "Admin payment refunds exist over the API, but no idempotency header is documented in the reference, and a closed issue shows refund retries once sent a new provider key.",
      "source": "https://raw.githubusercontent.com/medusajs/medusa/develop/www/apps/api-reference/specs/store/openapi.full.yaml",
      "confidence": "high",
      "url": "https://www.anchorterminal.com/tools/medusa"
    },
    {
      "slug": "saleor",
      "name": "Saleor API + MCP",
      "company": "Saleor Commerce sp. z o.o.",
      "grade": "BB",
      "fit": "caveat",
      "why": "Refunds run only through run_high_impact_mutation after approval, but an idempotency key appears on transaction events, not on the refund mutations an agent sends, so retry safety is not documented.",
      "source": "https://docs.saleor.io/developer/app-store/apps/mcp/permissions.md",
      "confidence": "medium",
      "url": "https://www.anchorterminal.com/tools/saleor"
    },
    {
      "slug": "shopify",
      "name": "Shopify API + MCP",
      "company": "Shopify Inc.",
      "grade": "BB",
      "fit": "caveat",
      "why": "refundCreate requires an @idempotent key from 2026-04 and returns the refund and refunded total, so retries are safe. The page shows no quote step, and a forum thread says caps must sit inside the refund tool.",
      "source": "https://shopify.dev/docs/api/admin-graphql/latest/mutations/refundCreate.md",
      "confidence": "high",
      "url": "https://www.anchorterminal.com/tools/shopify"
    },
    {
      "slug": "shopware",
      "name": "Shopware",
      "company": "shopware AG",
      "grade": "BB",
      "fit": "caveat",
      "why": "shopware-order-state takes transactionAction refund with a dry run, but that is a state transition whose money movement depends on the payment plugin, with no amount, quote or idempotency key.",
      "source": "https://developer.shopware.com/docs/products/tools/mcp-server/tools-reference.md",
      "confidence": "medium",
      "url": "https://www.anchorterminal.com/tools/shopware"
    },
    {
      "slug": "snipcart",
      "name": "Snipcart API + MCP",
      "company": "Snipcart inc.",
      "grade": "D",
      "fit": "caveat",
      "why": "The MCP views and creates refunds, but no quote, confirmation or idempotency key is documented, so a retried refund is not guarded.",
      "source": "https://docs.snipcart.com/v3/mcp-server/basics",
      "confidence": "medium",
      "url": "https://www.anchorterminal.com/tools/snipcart"
    },
    {
      "slug": "spree-commerce",
      "name": "Spree Commerce",
      "company": "Vendo Connect Inc",
      "grade": "BB",
      "fit": "caveat",
      "why": "returns_refund and refunds through create_resource exist with client confirmation, but no refund quote or idempotency for admin writes was found in the tool reference.",
      "source": "https://spreecommerce.org/docs/developer/mcp/tools.md",
      "confidence": "medium",
      "url": "https://www.anchorterminal.com/tools/spree-commerce"
    },
    {
      "slug": "square",
      "name": "Square",
      "company": "Block, Inc.",
      "grade": "B",
      "fit": "caveat",
      "why": "The refunds service takes an idempotency key, but the same tool-description flaw means a retried refund or payment can get a fresh key, and no quote step is documented.",
      "source": "https://github.com/square/square-mcp-server/blob/HEAD/README.md",
      "confidence": "high",
      "url": "https://www.anchorterminal.com/tools/square"
    },
    {
      "slug": "swell",
      "name": "Swell",
      "company": "Swell Commerce Corp.",
      "grade": "C",
      "fit": "caveat",
      "why": "The Backend API issues and lists refunds, but no MCP tool refunds and no idempotency key is documented; cancel_order refunds nothing and points to the dashboard.",
      "source": "https://developers.swell.is/guides/mcp-server.md",
      "confidence": "medium",
      "url": "https://www.anchorterminal.com/tools/swell"
    },
    {
      "slug": "vendure",
      "name": "Vendure",
      "company": "Elevantiq GmbH",
      "grade": "BB",
      "fit": "caveat",
      "why": "refund_order defaults to the payment's remaining refundable balance behind a confirm step, but carries no idempotency key, so a retried call can refund again.",
      "source": "https://docs.vendure.io/current/framework/mcp-server/built-in-tools.md",
      "confidence": "high",
      "url": "https://www.anchorterminal.com/tools/vendure"
    },
    {
      "slug": "wix",
      "name": "Wix Stores and eCommerce API",
      "company": "Wix.com Ltd.",
      "grade": "B",
      "fit": "caveat",
      "why": "calculate-refund and get-order-refundability give a quote, and refund-payments caps quantities and amounts at the refundable balance, but no idempotency key is documented on the refund call.",
      "source": "https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/orders/order-billing/refund-payments.md",
      "confidence": "medium",
      "url": "https://www.anchorterminal.com/tools/wix"
    },
    {
      "slug": "woocommerce",
      "name": "WooCommerce API + MCP",
      "company": "WooCommerce, Inc.",
      "grade": "BB",
      "fit": "caveat",
      "why": "REST POST /orders/{id}/refunds creates and returns a refund, but takes no idempotency key and no MCP refund ability is listed, so a retry can refund twice.",
      "source": "https://raw.githubusercontent.com/woocommerce/woocommerce/trunk/docs/apis/rest-api/v3/refunds.mdx",
      "confidence": "high",
      "url": "https://www.anchorterminal.com/tools/woocommerce"
    },
    {
      "slug": "agentzon",
      "name": "Agentzon",
      "company": "Merit Systems Inc (agentzon.co terms); Merit Systems, Inc. (merit.systems terms)",
      "grade": "D",
      "fit": "no",
      "why": "No refund or cancel endpoint; refunds and cancellations go by email to the seller's support address.",
      "source": "https://agentzon.co/llms.txt",
      "confidence": "medium",
      "url": "https://www.anchorterminal.com/tools/agentzon"
    },
    {
      "slug": "doola-mcp",
      "name": "doola MCP",
      "company": "doola",
      "grade": "F",
      "fit": "no",
      "why": "No refund or cancel tool is published.",
      "source": "https://github.com/doolahq/plugins/blob/HEAD/README.md",
      "confidence": "low",
      "url": "https://www.anchorterminal.com/tools/doola-mcp"
    },
    {
      "slug": "ecwid",
      "name": "Ecwid by Lightspeed",
      "company": "Ecwid, Inc.",
      "grade": "C",
      "fit": "no",
      "why": "Orders show refunds and refundedAmount, but no refund endpoint is listed in the REST reference; changing paymentStatus doesn't move money.",
      "source": "https://docs.ecwid.com/api-reference/rest-api/orders/get-order.md",
      "confidence": "medium",
      "url": "https://www.anchorterminal.com/tools/ecwid"
    }
  ],
  "marks": "yes: the docs show it does the job as the success test says. caveat: it does the job with a limit an agent should know. no: it doesn't do this job. unchecked: we couldn't read it.",
  "meta": {
    "attribution": "Anchor Terminal (https://www.anchorterminal.com)",
    "attributionRequired": true,
    "credit": "CC BY 4.0, credit Anchor Terminal and link the page or API address you took it from (https://www.anchorterminal.com/terms/#data)",
    "docs": "https://www.anchorterminal.com/docs/",
    "generatedAt": "2026-11-16",
    "license": "CC-BY-4.0",
    "method": "https://www.anchorterminal.com/benchmark/",
    "methodology": "0.8",
    "openapi": "https://www.anchorterminal.com/openapi.json",
    "preview": false,
    "run": "2026-10-01",
    "runLabel": "October 2026 research run",
    "terms": "https://www.anchorterminal.com/terms/#data"
  },
  "useCase": {
    "accounts": 2,
    "after": [
      "payments.refund",
      "support.reply"
    ],
    "area": "business",
    "asks": [
      "refund this order",
      "cancel and refund the damaged item",
      "issue store credit for this return"
    ],
    "before": [
      "commerce.order-lookup",
      "support.ticket-in"
    ],
    "blockers": [
      "refund tool with no quote or confirmation step",
      "retry creates a second payment or refund"
    ],
    "capabilities": [
      "commerce.orders"
    ],
    "category": "commerce",
    "categoryName": "Commerce \u0026 checkout",
    "checked": "2026-11-15",
    "companies": {
      "fit": 0,
      "fitWithLimit": 17,
      "tagged": 20
    },
    "competition": "none",
    "fits": null,
    "fitsWithLimit": [
      "adobe-commerce",
      "bigcommerce",
      "commerce-layer",
      "commercetools",
      "elastic-path",
      "fabric",
      "medusa",
      "saleor",
      "shopify",
      "shopware",
      "snipcart",
      "spree-commerce",
      "square",
      "swell",
      "vendure",
      "wix",
      "woocommerce"
    ],
    "id": "commerce.refund-or-cancel",
    "listings": {
      "caveat": 17,
      "no": 3,
      "notRead": 0,
      "tagged": 20,
      "unchecked": 0,
      "yes": 0
    },
    "name": "Refund, cancel or return an order safely",
    "status": "draft",
    "success": "One refund created for no more than the refundable balance, read back by ID with matching amount and status, and no second refund or charge after a retry.",
    "url": "https://www.anchorterminal.com/api/v1/use-cases/commerce.refund-or-cancel.json",
    "weight": 5,
    "weightBasis": "2 of 49 accounts (Square idempotency issue, Shopify refund-guardrails thread) plus BigCommerce and Shopware listing notes; few accounts but the costliest failure"
  }
}
