> ## Documentation Index
> Fetch the complete documentation index at: https://docs.modulex.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# WooCommerce Integration for AI Agents & Workflows

> WooCommerce REST API integration for managing orders, products, customers, and refunds on self-hosted WooCommerce stores.

{/* Self-hosted logo — build-time vendored from modulex.json / Iconify (see scripts/lib/logo.js). */}

<img src="https://mintcdn.com/modulexaillc/df8MOr-hXotYLTh5/logos/woocommerce.svg?fit=max&auto=format&n=df8MOr-hXotYLTh5&q=85&s=620a1883ce2493a5e37d43ea66f1d9c7" alt="WooCommerce logo" width="72" height="72" data-path="logos/woocommerce.svg" />

## Overview

Add **WooCommerce** to any ModuleX agent or workflow. Manage orders, products, customers, refunds, and payment methods on self-hosted WooCommerce stores via the WooCommerce REST API (`{store_url}/wp-json/wc/v3`).

<Info>
  **Categories**: E-Commerce · Retail · Payments · **Auth**: WooCommerce REST API Credentials · **Actions**: 17
</Info>

## Authentication

### WooCommerce REST API Credentials

Authenticate using your WooCommerce store URL, consumer key, and consumer secret via HTTP Basic Auth (HTTPS required).

#### Required Credentials

| Field           | Description                                                                            | Required | Format                                        |
| --------------- | -------------------------------------------------------------------------------------- | -------- | --------------------------------------------- |
| Store URL       | Your WooCommerce store URL (e.g. [https://mystore.com](https://mystore.com))           | Yes      | `https://mystore.example.com`                 |
| Consumer Key    | WooCommerce REST API consumer key from WooCommerce > Settings > Advanced > REST API    | Yes      | `ck_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
| Consumer Secret | WooCommerce REST API consumer secret from WooCommerce > Settings > Advanced > REST API | Yes      | `cs_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |

## Available Actions

<AccordionGroup>
  <Accordion title="create_order — Create a new order in the WooCommerce store.">
    ### Parameters

    <ResponseField name="status" type="string">
      Order status. Options: pending, processing, on-hold, completed, cancelled, refunded, failed, trash (Default: `pending`)
    </ResponseField>

    <ResponseField name="customer_id" type="integer">
      User ID who owns the order. 0 for guests
    </ResponseField>

    <ResponseField name="payment_method" type="string">
      Payment method ID (e.g. bacs, cheque, cod, paypal)
    </ResponseField>

    <ResponseField name="line_items" type="array">
      Array of line item objects, each with product\_id (integer) and quantity (integer)
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "OrderSummary": {
          "additionalProperties": false,
          "properties": {
            "id": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "number": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Number"
            },
            "status": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Status"
            },
            "total": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Total"
            },
            "currency": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Currency"
            },
            "customer_id": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Customer Id"
            },
            "payment_method": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Payment Method"
            },
            "date_created": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Date Created"
            },
            "date_modified": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Date Modified"
            },
            "line_items": {
              "items": {
                "additionalProperties": true,
                "type": "object"
              },
              "title": "Line Items",
              "type": "array"
            },
            "billing": {
              "anyOf": [
                {
                  "additionalProperties": true,
                  "type": "object"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Billing"
            },
            "shipping": {
              "anyOf": [
                {
                  "additionalProperties": true,
                  "type": "object"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Shipping"
            }
          },
          "title": "OrderSummary",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "order": {
          "anyOf": [
            {
              "$ref": "#/$defs/OrderSummary"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "required": [
        "success"
      ],
      "title": "CreateOrderOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="get_order — Retrieve a specific order by ID.">
    ### Parameters

    <ResponseField name="order_id" type="integer" required>
      ID of the order to retrieve
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "OrderSummary": {
          "additionalProperties": false,
          "properties": {
            "id": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "number": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Number"
            },
            "status": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Status"
            },
            "total": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Total"
            },
            "currency": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Currency"
            },
            "customer_id": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Customer Id"
            },
            "payment_method": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Payment Method"
            },
            "date_created": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Date Created"
            },
            "date_modified": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Date Modified"
            },
            "line_items": {
              "items": {
                "additionalProperties": true,
                "type": "object"
              },
              "title": "Line Items",
              "type": "array"
            },
            "billing": {
              "anyOf": [
                {
                  "additionalProperties": true,
                  "type": "object"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Billing"
            },
            "shipping": {
              "anyOf": [
                {
                  "additionalProperties": true,
                  "type": "object"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Shipping"
            }
          },
          "title": "OrderSummary",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "order": {
          "anyOf": [
            {
              "$ref": "#/$defs/OrderSummary"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "required": [
        "success"
      ],
      "title": "GetOrderOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="list_orders — Retrieve a list of orders with optional filters.">
    ### Parameters

    <ResponseField name="search" type="string">
      Limit results to those matching a string
    </ResponseField>

    <ResponseField name="status" type="string">
      Order status filter. Options: pending, processing, on-hold, completed, cancelled, refunded, failed, trash (Default: `pending`)
    </ResponseField>

    <ResponseField name="customer" type="integer">
      Filter by customer user ID. 0 for guests
    </ResponseField>

    <ResponseField name="after" type="string">
      Limit to orders created after this ISO8601 date (e.g. 2023-01-01T00:00:00)
    </ResponseField>

    <ResponseField name="before" type="string">
      Limit to orders created before this ISO8601 date (e.g. 2023-12-31T23:59:59)
    </ResponseField>

    <ResponseField name="max_results" type="integer">
      Maximum number of results to return (Default: `20`)
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "OrderSummary": {
          "additionalProperties": false,
          "properties": {
            "id": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "number": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Number"
            },
            "status": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Status"
            },
            "total": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Total"
            },
            "currency": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Currency"
            },
            "customer_id": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Customer Id"
            },
            "payment_method": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Payment Method"
            },
            "date_created": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Date Created"
            },
            "date_modified": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Date Modified"
            },
            "line_items": {
              "items": {
                "additionalProperties": true,
                "type": "object"
              },
              "title": "Line Items",
              "type": "array"
            },
            "billing": {
              "anyOf": [
                {
                  "additionalProperties": true,
                  "type": "object"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Billing"
            },
            "shipping": {
              "anyOf": [
                {
                  "additionalProperties": true,
                  "type": "object"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Shipping"
            }
          },
          "title": "OrderSummary",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "orders": {
          "items": {
            "$ref": "#/$defs/OrderSummary"
          },
          "title": "Orders",
          "type": "array"
        },
        "total": {
          "default": 0,
          "title": "Total",
          "type": "integer"
        }
      },
      "required": [
        "success"
      ],
      "title": "ListOrdersOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="delete_order — Delete an existing order.">
    ### Parameters

    <ResponseField name="order_id" type="integer" required>
      ID of the order to delete
    </ResponseField>

    <ResponseField name="force" type="boolean">
      Whether to bypass trash and permanently delete the order
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "OrderSummary": {
          "additionalProperties": false,
          "properties": {
            "id": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "number": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Number"
            },
            "status": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Status"
            },
            "total": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Total"
            },
            "currency": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Currency"
            },
            "customer_id": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Customer Id"
            },
            "payment_method": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Payment Method"
            },
            "date_created": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Date Created"
            },
            "date_modified": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Date Modified"
            },
            "line_items": {
              "items": {
                "additionalProperties": true,
                "type": "object"
              },
              "title": "Line Items",
              "type": "array"
            },
            "billing": {
              "anyOf": [
                {
                  "additionalProperties": true,
                  "type": "object"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Billing"
            },
            "shipping": {
              "anyOf": [
                {
                  "additionalProperties": true,
                  "type": "object"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Shipping"
            }
          },
          "title": "OrderSummary",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "order": {
          "anyOf": [
            {
              "$ref": "#/$defs/OrderSummary"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "required": [
        "success"
      ],
      "title": "DeleteOrderOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="update_order_status — Update the status of a specific order.">
    ### Parameters

    <ResponseField name="order_id" type="integer" required>
      ID of the order to update
    </ResponseField>

    <ResponseField name="status" type="string" required>
      New order status. Options: pending, processing, on-hold, completed, cancelled, refunded, failed, trash
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "OrderSummary": {
          "additionalProperties": false,
          "properties": {
            "id": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "number": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Number"
            },
            "status": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Status"
            },
            "total": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Total"
            },
            "currency": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Currency"
            },
            "customer_id": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Customer Id"
            },
            "payment_method": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Payment Method"
            },
            "date_created": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Date Created"
            },
            "date_modified": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Date Modified"
            },
            "line_items": {
              "items": {
                "additionalProperties": true,
                "type": "object"
              },
              "title": "Line Items",
              "type": "array"
            },
            "billing": {
              "anyOf": [
                {
                  "additionalProperties": true,
                  "type": "object"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Billing"
            },
            "shipping": {
              "anyOf": [
                {
                  "additionalProperties": true,
                  "type": "object"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Shipping"
            }
          },
          "title": "OrderSummary",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "order": {
          "anyOf": [
            {
              "$ref": "#/$defs/OrderSummary"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "required": [
        "success"
      ],
      "title": "UpdateOrderStatusOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="create_product — Create a new product in the WooCommerce store.">
    ### Parameters

    <ResponseField name="name" type="string" required>
      Name of the product
    </ResponseField>

    <ResponseField name="type" type="string">
      Product type. Options: simple, grouped, external, variable (Default: `simple`)
    </ResponseField>

    <ResponseField name="status" type="string">
      Product status. Options: draft, pending, private, publish (Default: `publish`)
    </ResponseField>

    <ResponseField name="regular_price" type="string">
      Product regular price
    </ResponseField>

    <ResponseField name="sale_price" type="string">
      Product sale price
    </ResponseField>

    <ResponseField name="description" type="string">
      Product description (HTML allowed)
    </ResponseField>

    <ResponseField name="categories" type="array">
      Array of category IDs (integers) to assign the product to
    </ResponseField>

    <ResponseField name="image_url" type="string">
      URL of an image to add to the product
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "ProductSummary": {
          "additionalProperties": false,
          "properties": {
            "id": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Name"
            },
            "slug": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Slug"
            },
            "type": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Type"
            },
            "status": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Status"
            },
            "regular_price": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Regular Price"
            },
            "sale_price": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Sale Price"
            },
            "price": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Price"
            },
            "description": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Description"
            },
            "categories": {
              "items": {
                "additionalProperties": true,
                "type": "object"
              },
              "title": "Categories",
              "type": "array"
            },
            "images": {
              "items": {
                "additionalProperties": true,
                "type": "object"
              },
              "title": "Images",
              "type": "array"
            },
            "date_created": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Date Created"
            }
          },
          "title": "ProductSummary",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "product": {
          "anyOf": [
            {
              "$ref": "#/$defs/ProductSummary"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "required": [
        "success"
      ],
      "title": "CreateProductOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="update_product — Update an existing product.">
    ### Parameters

    <ResponseField name="product_id" type="integer" required>
      ID of the product to update
    </ResponseField>

    <ResponseField name="name" type="string">
      New name for the product
    </ResponseField>

    <ResponseField name="type" type="string">
      Product type. Options: simple, grouped, external, variable
    </ResponseField>

    <ResponseField name="status" type="string">
      Product status. Options: draft, pending, private, publish
    </ResponseField>

    <ResponseField name="regular_price" type="string">
      Product regular price
    </ResponseField>

    <ResponseField name="sale_price" type="string">
      Product sale price
    </ResponseField>

    <ResponseField name="description" type="string">
      Product description (HTML allowed)
    </ResponseField>

    <ResponseField name="categories" type="array">
      Array of category IDs (integers) to assign the product to
    </ResponseField>

    <ResponseField name="image_url" type="string">
      URL of an image to add to the product
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "ProductSummary": {
          "additionalProperties": false,
          "properties": {
            "id": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Name"
            },
            "slug": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Slug"
            },
            "type": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Type"
            },
            "status": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Status"
            },
            "regular_price": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Regular Price"
            },
            "sale_price": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Sale Price"
            },
            "price": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Price"
            },
            "description": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Description"
            },
            "categories": {
              "items": {
                "additionalProperties": true,
                "type": "object"
              },
              "title": "Categories",
              "type": "array"
            },
            "images": {
              "items": {
                "additionalProperties": true,
                "type": "object"
              },
              "title": "Images",
              "type": "array"
            },
            "date_created": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Date Created"
            }
          },
          "title": "ProductSummary",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "product": {
          "anyOf": [
            {
              "$ref": "#/$defs/ProductSummary"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "required": [
        "success"
      ],
      "title": "UpdateProductOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="get_product — Retrieve a specific product by ID.">
    ### Parameters

    <ResponseField name="product_id" type="integer" required>
      ID of the product to retrieve
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "ProductSummary": {
          "additionalProperties": false,
          "properties": {
            "id": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Name"
            },
            "slug": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Slug"
            },
            "type": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Type"
            },
            "status": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Status"
            },
            "regular_price": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Regular Price"
            },
            "sale_price": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Sale Price"
            },
            "price": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Price"
            },
            "description": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Description"
            },
            "categories": {
              "items": {
                "additionalProperties": true,
                "type": "object"
              },
              "title": "Categories",
              "type": "array"
            },
            "images": {
              "items": {
                "additionalProperties": true,
                "type": "object"
              },
              "title": "Images",
              "type": "array"
            },
            "date_created": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Date Created"
            }
          },
          "title": "ProductSummary",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "product": {
          "anyOf": [
            {
              "$ref": "#/$defs/ProductSummary"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "required": [
        "success"
      ],
      "title": "GetProductOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="list_products — Retrieve a list of products with optional filters.">
    ### Parameters

    <ResponseField name="search" type="string">
      Limit results to those matching a string
    </ResponseField>

    <ResponseField name="status" type="string">
      Product status filter. Options: draft, pending, private, publish (Default: `publish`)
    </ResponseField>

    <ResponseField name="type" type="string">
      Product type filter. Options: simple, grouped, external, variable (Default: `simple`)
    </ResponseField>

    <ResponseField name="after" type="string">
      Limit to products created after this ISO8601 date
    </ResponseField>

    <ResponseField name="before" type="string">
      Limit to products created before this ISO8601 date
    </ResponseField>

    <ResponseField name="max_results" type="integer">
      Maximum number of results to return (Default: `20`)
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "ProductSummary": {
          "additionalProperties": false,
          "properties": {
            "id": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Name"
            },
            "slug": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Slug"
            },
            "type": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Type"
            },
            "status": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Status"
            },
            "regular_price": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Regular Price"
            },
            "sale_price": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Sale Price"
            },
            "price": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Price"
            },
            "description": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Description"
            },
            "categories": {
              "items": {
                "additionalProperties": true,
                "type": "object"
              },
              "title": "Categories",
              "type": "array"
            },
            "images": {
              "items": {
                "additionalProperties": true,
                "type": "object"
              },
              "title": "Images",
              "type": "array"
            },
            "date_created": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Date Created"
            }
          },
          "title": "ProductSummary",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "products": {
          "items": {
            "$ref": "#/$defs/ProductSummary"
          },
          "title": "Products",
          "type": "array"
        },
        "total": {
          "default": 0,
          "title": "Total",
          "type": "integer"
        }
      },
      "required": [
        "success"
      ],
      "title": "ListProductsOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="search_customers — Search for customers by email, name, or other criteria.">
    ### Parameters

    <ResponseField name="search" type="string">
      Limit results to those matching a string
    </ResponseField>

    <ResponseField name="email" type="string">
      Filter by exact customer email address
    </ResponseField>

    <ResponseField name="role" type="string">
      Filter by role. Options: all, administrator, editor, author, contributor, subscriber, customer (Default: `customer`)
    </ResponseField>

    <ResponseField name="max_results" type="integer">
      Maximum number of results to return (Default: `20`)
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "CustomerSummary": {
          "additionalProperties": false,
          "properties": {
            "id": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "email": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Email"
            },
            "first_name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "First Name"
            },
            "last_name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Last Name"
            },
            "username": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Username"
            },
            "role": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Role"
            },
            "date_created": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Date Created"
            },
            "billing": {
              "anyOf": [
                {
                  "additionalProperties": true,
                  "type": "object"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Billing"
            },
            "shipping": {
              "anyOf": [
                {
                  "additionalProperties": true,
                  "type": "object"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Shipping"
            },
            "is_paying_customer": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Is Paying Customer"
            }
          },
          "title": "CustomerSummary",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "customers": {
          "items": {
            "$ref": "#/$defs/CustomerSummary"
          },
          "title": "Customers",
          "type": "array"
        },
        "total": {
          "default": 0,
          "title": "Total",
          "type": "integer"
        }
      },
      "required": [
        "success"
      ],
      "title": "SearchCustomersOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="get_customer — Retrieve a specific customer by ID.">
    ### Parameters

    <ResponseField name="customer_id" type="integer" required>
      ID of the customer to retrieve
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "CustomerSummary": {
          "additionalProperties": false,
          "properties": {
            "id": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "email": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Email"
            },
            "first_name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "First Name"
            },
            "last_name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Last Name"
            },
            "username": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Username"
            },
            "role": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Role"
            },
            "date_created": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Date Created"
            },
            "billing": {
              "anyOf": [
                {
                  "additionalProperties": true,
                  "type": "object"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Billing"
            },
            "shipping": {
              "anyOf": [
                {
                  "additionalProperties": true,
                  "type": "object"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Shipping"
            },
            "is_paying_customer": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Is Paying Customer"
            }
          },
          "title": "CustomerSummary",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "customer": {
          "anyOf": [
            {
              "$ref": "#/$defs/CustomerSummary"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "required": [
        "success"
      ],
      "title": "GetCustomerOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="create_customer — Create a new customer.">
    ### Parameters

    <ResponseField name="email" type="string" required>
      Customer email address
    </ResponseField>

    <ResponseField name="first_name" type="string">
      Customer first name
    </ResponseField>

    <ResponseField name="last_name" type="string">
      Customer last name
    </ResponseField>

    <ResponseField name="username" type="string">
      Customer login username
    </ResponseField>

    <ResponseField name="password" type="string">
      Customer password
    </ResponseField>

    <ResponseField name="is_paying_customer" type="boolean">
      Whether the customer is a paying customer
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "CustomerSummary": {
          "additionalProperties": false,
          "properties": {
            "id": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "email": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Email"
            },
            "first_name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "First Name"
            },
            "last_name": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Last Name"
            },
            "username": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Username"
            },
            "role": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Role"
            },
            "date_created": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Date Created"
            },
            "billing": {
              "anyOf": [
                {
                  "additionalProperties": true,
                  "type": "object"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Billing"
            },
            "shipping": {
              "anyOf": [
                {
                  "additionalProperties": true,
                  "type": "object"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Shipping"
            },
            "is_paying_customer": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Is Paying Customer"
            }
          },
          "title": "CustomerSummary",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "customer": {
          "anyOf": [
            {
              "$ref": "#/$defs/CustomerSummary"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "required": [
        "success"
      ],
      "title": "CreateCustomerOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="add_order_note — Create a new note for an order.">
    ### Parameters

    <ResponseField name="order_id" type="integer" required>
      ID of the order to add a note to
    </ResponseField>

    <ResponseField name="note" type="string" required>
      Content of the order note
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "OrderNoteSummary": {
          "additionalProperties": false,
          "properties": {
            "id": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "author": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Author"
            },
            "date_created": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Date Created"
            },
            "note": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Note"
            },
            "customer_note": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Customer Note"
            }
          },
          "title": "OrderNoteSummary",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "note": {
          "anyOf": [
            {
              "$ref": "#/$defs/OrderNoteSummary"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "required": [
        "success"
      ],
      "title": "AddOrderNoteOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="get_order_note — Retrieve a specific order note.">
    ### Parameters

    <ResponseField name="order_id" type="integer" required>
      ID of the order
    </ResponseField>

    <ResponseField name="note_id" type="integer" required>
      ID of the order note
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "OrderNoteSummary": {
          "additionalProperties": false,
          "properties": {
            "id": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "author": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Author"
            },
            "date_created": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Date Created"
            },
            "note": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Note"
            },
            "customer_note": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Customer Note"
            }
          },
          "title": "OrderNoteSummary",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "note": {
          "anyOf": [
            {
              "$ref": "#/$defs/OrderNoteSummary"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "required": [
        "success"
      ],
      "title": "GetOrderNoteOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="list_order_notes — Retrieve all notes for a specific order.">
    ### Parameters

    <ResponseField name="order_id" type="integer" required>
      ID of the order
    </ResponseField>

    <ResponseField name="type" type="string">
      Filter by note type. Options: any, customer, internal (Default: `any`)
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "OrderNoteSummary": {
          "additionalProperties": false,
          "properties": {
            "id": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "author": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Author"
            },
            "date_created": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Date Created"
            },
            "note": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Note"
            },
            "customer_note": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Customer Note"
            }
          },
          "title": "OrderNoteSummary",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "notes": {
          "items": {
            "$ref": "#/$defs/OrderNoteSummary"
          },
          "title": "Notes",
          "type": "array"
        }
      },
      "required": [
        "success"
      ],
      "title": "ListOrderNotesOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="create_refund — Create a new refund for an order.">
    ### Parameters

    <ResponseField name="order_id" type="integer" required>
      ID of the order to refund
    </ResponseField>

    <ResponseField name="amount" type="string">
      Refund amount. If not specified, calculated from line items
    </ResponseField>

    <ResponseField name="reason" type="string">
      Reason for the refund
    </ResponseField>

    <ResponseField name="api_refund" type="boolean">
      When true, the payment gateway API generates the refund. When false, the refund is manual
    </ResponseField>

    <ResponseField name="line_items" type="array">
      Array of line item refund objects. Each with id (integer), refund\_total (string), and optionally refund\_tax (array)
    </ResponseField>

    ### Response

    ```json theme={null}
    {
      "$defs": {
        "RefundSummary": {
          "additionalProperties": false,
          "properties": {
            "id": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "amount": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Amount"
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Reason"
            },
            "refunded_by": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Refunded By"
            },
            "date_created": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Date Created"
            },
            "line_items": {
              "items": {
                "additionalProperties": true,
                "type": "object"
              },
              "title": "Line Items",
              "type": "array"
            }
          },
          "title": "RefundSummary",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "refund": {
          "anyOf": [
            {
              "$ref": "#/$defs/RefundSummary"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "required": [
        "success"
      ],
      "title": "CreateRefundOutput",
      "type": "object"
    }
    ```
  </Accordion>

  <Accordion title="list_payment_method_options — Retrieve available payment gateway options.">
    ### Response

    ```json theme={null}
    {
      "$defs": {
        "PaymentMethodSummary": {
          "additionalProperties": false,
          "properties": {
            "id": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Id"
            },
            "title": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Title"
            },
            "description": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Description"
            },
            "enabled": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Enabled"
            }
          },
          "title": "PaymentMethodSummary",
          "type": "object"
        }
      },
      "additionalProperties": false,
      "properties": {
        "success": {
          "title": "Success",
          "type": "boolean"
        },
        "error": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Error"
        },
        "payment_methods": {
          "items": {
            "$ref": "#/$defs/PaymentMethodSummary"
          },
          "title": "Payment Methods",
          "type": "array"
        }
      },
      "required": [
        "success"
      ],
      "title": "ListPaymentMethodOptionsOutput",
      "type": "object"
    }
    ```
  </Accordion>
</AccordionGroup>

## Limits & Quotas

* WooCommerce REST API rate limits depend on the hosting provider and server configuration. Most managed hosts enforce 60-120 requests/minute.
* Pagination is server-controlled; responses include `X-WP-Total` and `X-WP-TotalPages` headers.
* Error model: non-2xx responses are caught and returned as `success=False` + `error` rather than raising. Plan for retries on the agent side based on the error string.
* No per-request pricing — WooCommerce is self-hosted.

## Related integrations

<CardGroup cols={3}>
  <Card title="Shopify" href="/integrations/tools/shopify" />

  <Card title="Amazon Selling Partner" href="/integrations/tools/amazon-selling-partner" />

  <Card title="Etsy" href="/integrations/tools/etsy" />
</CardGroup>

## Links

* [WooCommerce](https://woocommerce.com)