• AUTOMATED
  • AUTOMATED
  • MANUAL
  • MANUAL

How to cancel orders and trigger refunds with your AI

Connect VTEX Orders to your AI client to manage order cancellations. You can handle refund requests directly in your chat window.

Ask AI about this page

Short answer

Can I cancel VTEX orders using my AI?

Yes. You can use your AI to find and cancel orders in VTEX via chat. This allows you to trigger the refund process without opening the VTEX admin panel.

Where every request lands.

Order management outcomes

The AI handles the order status changes so you don't have to switch tabs.

AUTOMATED

Order cancellations

The AI executes the cancellation in VTEX. You get a confirmation in your chat once the order status updates.

AUTOMATED

Refund initiation

The AI triggers the necessary steps to start a refund. This moves the order into the correct state for your payment processor.

MANUAL

Shipped orders

If an order has already shipped, the AI cannot cancel it. You'll need to handle these returns manually in VTEX.

MANUAL

Complex disputes

For edge cases like partial refunds or specific billing errors, the AI flags the order for you to review personally.

The workflow

What your AI does when a cancellation request arrives.

The AI acts as the interface between your chat and the VTEX order system.

  1. Identify the order

    The AI pulls the order details from VTEX to confirm it's the right one.

    cancel_order

  2. Cancel the order

    The AI sends the cancellation command to VTEX to stop the order.

    cancel_order

  3. Trigger the refund

    The AI ensures the order is set up to receive a refund in the system.

    cancel_order

  4. Confirm completion

    The AI verifies the new status in VTEX and tells you it's done.

    cancel_order

Try it

Copy these to start.

Use these prompts to act on your VTEX orders.

Starting points

Swap the order numbers for the actual ones you need to process.

VTEX Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_j7X6HiwX1bBJXST5tZZMutxUuUBghIML8gfccIJU/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — VTEX capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "vtex-orders-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_j7X6HiwX1bBJXST5tZZMutxUuUBghIML8gfccIJU/mcp"
    }
  }
}
Copy into chat04

  • Cancel order #88291 in VTEX.

  • Can you cancel order 44521 for me?

  • I need to trigger a refund for order #10023.

  • Check if order 99283 can still be cancelled.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect VTEX Orders once, then ask.

Connect your store once and your credentials stay encrypted. You can then manage orders through any compatible client.

Connect VTEX Orders to your AI

FAQ

How this task behaves

  • 01

    Can the AI cancel an order that is already being shipped?

    No. If the order status in VTEX prevents cancellation, the AI cannot proceed.

  • 02

    Does the AI handle the actual money transfer?

    No. The AI triggers the refund in VTEX, but your payment gateway handles the actual movement of money.

  • 03

    Can the AI delete an order from my history?

    No. The AI can only change the status of an order via the cancel_order tool; it cannot delete records.

  • 04

    Can I cancel multiple orders at once?

    Yes. You can give your AI a list of order numbers and ask it to cancel them.

  • 05

    What happens if the cancellation fails?

    The AI will show you the error returned by VTEX so you can fix it in the admin panel.

  • More questions about VTEX Orders? The Connector page answers them. See everything the VTEX Orders Connector can do

Connect VTEX to Claude, Cursor, ChatGPT & more