Advanced order operations using Wix's ecom-orders V1 API for aggregation, advanced filtering, payment status, refundability, and fulfillment management.
From wix-ecom-coworknpx claudepluginhub itayher/wix-ecom-cowork --plugin wix-ecom-coworkThis skill uses the workspace's default tool permissions.
Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Searches prompts.chat for AI prompt templates by keyword or category, retrieves by ID with variable handling, and improves prompts via AI. Use for discovering or enhancing prompts.
Guides agentic engineering workflows: eval-first loops, 15-min task decomposition, model routing (Haiku/Sonnet/Opus), AI code reviews, and cost tracking.
Advanced order operations using Wix's ecom-orders V1 API for aggregation, advanced filtering, payment status, refundability, and fulfillment management.
df7c18eb-009b-4868-9891-15e19dddbe67${API_KEY}${SITE_ID}Endpoint: POST /_api/ecom-orders/v1/orders/aggregate
Get order statistics and aggregated data (counts, totals, breakdowns).
curl -X POST "https://www.wixapis.com/_api/ecom-orders/v1/orders/aggregate" \
-H "Authorization: ${API_KEY}" \
-H "wix-site-id: ${SITE_ID}" \
-H "Content-Type: application/json" \
-d '{
"aggregation": {
"deliveryMethodPerShippingRegion": {
"$count": ["shippingRegion", "deliveryMethod"]
}
}
}'
Use Cases:
curl -X POST "https://www.wixapis.com/_api/ecom-orders/v1/orders/aggregate" \
-H "Authorization: ${API_KEY}" \
-H "wix-site-id: ${SITE_ID}" \
-H "Content-Type: application/json" \
-d '{
"aggregation": {
"ordersByStatus": {
"$count": ["paymentStatus", "fulfillmentStatus"]
}
}
}'
Endpoint: POST /_api/ecom-orders/v1/orders/query
Query orders with advanced filters beyond the public API.
curl -X POST "https://www.wixapis.com/_api/ecom-orders/v1/orders/query" \
-H "Authorization: ${API_KEY}" \
-H "wix-site-id: ${SITE_ID}" \
-H "Content-Type: application/json" \
-d '{
"filter": {
"$and": [
{
"lineItems.catalogReference.appId": {
"$eq": "PRODUCT_APP_ID"
}
}
]
},
"paging": {
"limit": 50,
"offset": 0
}
}'
Advanced Filters:
Endpoint: POST /_api/order-billing/v1/get-order-refundability
Check if an order can be refunded and get refund details.
curl -X POST "https://www.wixapis.com/_api/order-billing/v1/get-order-refundability" \
-H "Authorization: ${API_KEY}" \
-H "wix-site-id: ${SITE_ID}" \
-H "Content-Type: application/json" \
-d '{
"orderId": "ORDER_ID_HERE"
}'
Response:
{
"refundable": true,
"maxRefundAmount": 125.50,
"currency": "USD",
"reasons": [],
"paymentProvider": "stripe"
}
Use Cases:
Endpoint: GET /ecom/v1/payments-collector/orders/{orderId}/payment-collectability-status
Check if payment can be collected for an order (for pending payments).
ORDER_ID="order-id-here"
curl -X GET "https://www.wixapis.com/ecom/v1/payments-collector/orders/${ORDER_ID}/payment-collectability-status" \
-H "Authorization: ${API_KEY}" \
-H "wix-site-id: ${SITE_ID}"
Response:
{
"collectable": true,
"status": "PENDING",
"paymentMethod": "credit_card",
"amount": 125.50
}
Use Cases:
Endpoint: GET /_api/tips-service/v1/tips/order/{orderId}
Retrieve tip/gratuity information for an order (if applicable).
ORDER_ID="order-id-here"
curl -X GET "https://www.wixapis.com/_api/tips-service/v1/tips/order/${ORDER_ID}" \
-H "Authorization: ${API_KEY}" \
-H "wix-site-id: ${SITE_ID}"
Response:
{
"orderId": "order-123",
"tipAmount": 15.00,
"currency": "USD",
"tipPercentage": 20.0
}
Use Cases:
Endpoint: GET /_api/wix-ecommerce-fulfillment/v1/fulfillers/unified
Get all connected fulfillment providers (dropshipping, POD, etc.).
curl -X GET "https://www.wixapis.com/_api/wix-ecommerce-fulfillment/v1/fulfillers/unified" \
-H "Authorization: ${API_KEY}" \
-H "wix-site-id: ${SITE_ID}"
Response:
{
"fulfillers": [
{
"id": "fulfiller-123",
"name": "Printful",
"type": "PRINT_ON_DEMAND",
"orderCount": 145,
"active": true
}
]
}
Endpoint: GET /ecom/v1/draft-orders/{draftOrderId}/draftability
Check if a draft order can still be modified.
DRAFT_ORDER_ID="draft-order-id"
curl -X GET "https://www.wixapis.com/ecom/v1/draft-orders/${DRAFT_ORDER_ID}/draftability" \
-H "Authorization: ${API_KEY}" \
-H "wix-site-id: ${SITE_ID}"
Use Cases:
Endpoint: GET /ambassador/payment-settings-web/v2/settings/provider-accounts
Get configured payment providers and accounts.
curl -X GET "https://www.wixapis.com/ambassador/payment-settings-web/v2/settings/provider-accounts" \
-H "Authorization: ${API_KEY}" \
-H "wix-site-id: ${SITE_ID}"
Response:
{
"providers": [
{
"type": "STRIPE",
"accountId": "acct_123",
"active": true,
"capabilities": ["card", "apple_pay", "google_pay"]
}
]
}
Endpoint: POST /_api/catalog-reader-server/v1/products/query
Query products using the catalog reader service (optimized for reads).
curl -X POST "https://www.wixapis.com/_api/catalog-reader-server/v1/products/query" \
-H "Authorization: ${API_KEY}" \
-H "wix-site-id: ${SITE_ID}" \
-H "Content-Type: application/json" \
-d '{
"query": {
"filter": {},
"paging": {
"limit": 50,
"offset": 0
}
}
}'
Benefit: Potentially faster reads than the standard products API.
Use public API: GET /stores/v1/orders/{id}
POST /_api/order-billing/v1/get-order-refundability
GET /ecom/v1/payments-collector/orders/{id}/payment-collectability-status
GET /_api/tips-service/v1/tips/order/{id}
POST /_api/ecom-orders/v1/orders/aggregate