• VALIDATION
  • LOGISTICS
  • AUDIT
  • MANUAL

How to test cart totals and coupons with your AI

Connect your AI to VTEX Checkout once. From there, your agent handles the repetitive work of building carts and checking prices.

Ask AI about this page

Short answer

How can I test my VTEX checkout logic with AI?

Your AI uses the connector to build virtual carts and apply specific discount codes. It then pulls the updated totals so you can confirm shipping and price accuracy immediately. You get a clear breakdown of the final checkout state.

The results you get

Testing outcomes

Running these tasks gives you specific data points for your checkout logic.

VALIDATION

Verified coupon math

The AI applies codes to a live cart and checks if the math holds up. You get the exact discount applied to the subtotal.

LOGISTICS

Shipping cost checks

By simulating orders with different postal codes, the AI confirms your shipping rules are working. You see the freight costs without entering addresses manually.

AUDIT

Order state snapshots

The AI pulls the full order form data to show you exactly what the customer sees. This includes taxes, items, and applied promotions.

MANUAL

Human review needed

If a coupon fails or a price looks wrong, you step in to investigate the VTEX admin settings. The AI identifies the error, but you fix the rule.

The workflow

What your AI does when the request arrives.

The AI moves through the checkout lifecycle to replicate a real customer experience.

  1. Build the cart

    The agent starts by creating a session and adding products to a virtual basket.

    simulate_order
  2. Apply discounts

    The AI injects specific promotional codes into the active session to test price drops.

    add_coupon
  3. Fetch totals

    It pulls the complete checkout data to see the final price, taxes, and shipping fees.

    get_orderform
  4. Verify results

    The agent compares the resulting totals against your expected values to flag discrepancies.

    get_orderform

Try it

Copy these to start.

Use these prompts to trigger the testing workflow.

Starting points

Swap the bracketed text with your actual SKU IDs, coupon codes, or zip codes.

VTEX Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_1wLH9vAfCGXtiSGXk1obonJ6ckqJcFZi1WL4TSqq/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-checkout-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_1wLH9vAfCGXtiSGXk1obonJ6ckqJcFZi1WL4TSqq/mcp"
    }
  }
}
Copy into chat04
  • Simulate an order with SKU [ID] and check the total.

  • Add coupon [CODE] to the current orderform and tell me the new subtotal.

  • Get the orderform for the current session and list all applied discounts.

  • Check the shipping cost for a cart containing SKU [ID] sent to postal code [ZIP].

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

Start here

Connect VTEX Checkout once, then ask.

Just link your account once. Your credentials stay encrypted, and you can immediately start asking your agent to run checkout simulations.

Connect VTEX Checkout to your AI

FAQ

How the testing behaves

  • 01

    Does the AI actually place a real order?

    No. The AI uses simulation tools to build the cart and check totals without finalizing a real purchase.

  • 02

    Can the AI change my prices in VTEX?

    No. The AI can only read and test the rules you have already set in your VTEX admin.

  • 03

    Can I test shipping rates for any location?

    Yes, as long as you provide the postal code for the AI to use during the simulation.

  • 04

    Will the AI create new coupon codes?

    No. The AI can only apply existing codes to a cart.

  • 05

    How do I know if a test failed?

    The AI will report the final totals it retrieved, allowing you to compare them to your expected math.

  • More questions about VTEX Checkout? See everything the VTEX Checkout Connector can do

Connect VTEX to Claude, Cursor, ChatGPT & more