clawver-ordersManage Clawver orders. List orders, track status, process refunds, generate download links. Use when asked about customer orders, fulfillment, refunds, or order history.
Install via ClawdBot CLI:
clawdbot install nwang783/clawver-ordersManage orders on your Clawver store—view order history, track fulfillment, process refunds, and generate download links.
CLAW_API_KEY environment variableFor platform-specific good and bad API patterns from claw-social, use references/api-examples.md.
curl https://api.clawver.store/v1/orders \
-H "Authorization: Bearer $CLAW_API_KEY"# Confirmed (paid) orders
curl "https://api.clawver.store/v1/orders?status=confirmed" \
-H "Authorization: Bearer $CLAW_API_KEY"
# In-progress POD orders
curl "https://api.clawver.store/v1/orders?status=processing" \
-H "Authorization: Bearer $CLAW_API_KEY"
# Shipped orders
curl "https://api.clawver.store/v1/orders?status=shipped" \
-H "Authorization: Bearer $CLAW_API_KEY"
# Delivered orders
curl "https://api.clawver.store/v1/orders?status=delivered" \
-H "Authorization: Bearer $CLAW_API_KEY"Order statuses:
| Status | Description |
|--------|-------------|
| pending | Order created, payment pending |
| confirmed | Payment confirmed |
| processing | Being fulfilled |
| shipped | In transit (POD only) |
| delivered | Completed |
| cancelled | Cancelled |
paymentStatus is reported separately and can be pending, paid, failed, partially_refunded, or refunded.
curl "https://api.clawver.store/v1/orders?limit=20" \
-H "Authorization: Bearer $CLAW_API_KEY"limit is supported. Cursor-based pagination is not currently exposed on this endpoint.
curl https://api.clawver.store/v1/orders/{orderId} \
-H "Authorization: Bearer $CLAW_API_KEY"For print-on-demand items, order payloads include:
variantId (required — fulfillment variant identifier, must match a product variant)variantName (human-readable selected size/variant label)Note: variantId is required for all POD checkout items as of Feb 2026. Out-of-stock variants are rejected.
curl "https://api.clawver.store/v1/orders/{orderId}/download/{itemId}" \
-H "Authorization: Bearer $CLAW_API_KEY"Use this when customers report download issues or request a new link.
curl "https://api.clawver.store/v1/orders/{orderId}/download/{itemId}/public?token={downloadToken}"Download tokens are issued per order item and can be returned in the checkout receipt (GET /v1/checkout/{checkoutId}/receipt).
curl "https://api.clawver.store/v1/orders/{orderId}/public?token={orderStatusToken}"curl "https://api.clawver.store/v1/checkout/{checkoutId}/receipt"curl -X POST https://api.clawver.store/v1/orders/{orderId}/refund \
-H "Authorization: Bearer $CLAW_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"amountInCents": 2499,
"reason": "Customer requested refund"
}'curl -X POST https://api.clawver.store/v1/orders/{orderId}/refund \
-H "Authorization: Bearer $CLAW_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"amountInCents": 500,
"reason": "Partial refund for missing item"
}'Notes:
amountInCents is required and must be a positive integerreason is requiredamountInCents cannot exceed remaining refundable amountpaymentStatus of paid or partially_refundedFor print-on-demand orders, tracking info becomes available after shipping:
curl https://api.clawver.store/v1/orders/{orderId} \
-H "Authorization: Bearer $CLAW_API_KEY"Check trackingUrl, trackingNumber, and carrier fields in response.
curl -X POST https://api.clawver.store/v1/webhooks \
-H "Authorization: Bearer $CLAW_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://your-server.com/webhook",
"events": ["order.shipped", "order.fulfilled"],
"secret": "your-secret-min-16-chars"
}'Receive real-time notifications:
curl -X POST https://api.clawver.store/v1/webhooks \
-H "Authorization: Bearer $CLAW_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://your-server.com/webhook",
"events": ["order.created", "order.paid", "order.refunded"],
"secret": "your-webhook-secret-16chars"
}'Signature format:
X-Claw-Signature: sha256=abc123...Verification (Node.js):
const crypto = require('crypto');
function verifyWebhook(body, signature, secret) {
const expected = 'sha256=' + crypto
.createHmac('sha256', secret)
.update(body)
.digest('hex');
return crypto.timingSafeEqual(
Buffer.from(signature),
Buffer.from(expected)
);
}# Get newly paid/confirmed orders
response = api.get("/v1/orders?status=confirmed")
orders = response["data"]["orders"]
print(f"New orders: {len(orders)}")
for order in orders:
print(f" - {order['id']}: ${order['totalInCents']/100:.2f}")def process_refund(order_id, amount_cents, reason):
# Get order details
response = api.get(f"/v1/orders/{order_id}")
order = response["data"]["order"]
# Check if refundable
if order["paymentStatus"] not in ["paid", "partially_refunded"]:
return "Order cannot be refunded"
# Process refund
result = api.post(f"/v1/orders/{order_id}/refund", {
"amountInCents": amount_cents,
"reason": reason
})
return f"Refunded ${amount_cents/100:.2f}"def handle_wrong_size(order_id):
response = api.get(f"/v1/orders/{order_id}")
order = response["data"]["order"]
for item in order["items"]:
if item.get("productType") == "print_on_demand":
print("Variant ID:", item.get("variantId"))
print("Variant Name:", item.get("variantName"))
# Confirm selected variant before issuing a refund/replacement workflow.def resend_download(order_id, item_id):
# Generate new download link
response = api.get(f"/v1/orders/{order_id}/download/{item_id}")
return response["data"]["downloadUrl"]pending → confirmed → processing → shipped → delivered
↓
cancelled / refunded (paymentStatus)Digital products: confirmed → delivered (instant fulfillment)
POD products: confirmed → processing → shipped → delivered
Generated Mar 1, 2026
A small business owner uses the skill to monitor daily orders, track fulfillment status for print-on-demand products, and process customer refunds. They filter orders by status like 'confirmed' or 'shipped' to streamline operations and ensure timely delivery.
A support agent accesses order details and generates download links for digital items when customers report issues. They use public endpoints with tokens to verify order status without exposing sensitive data, improving response times.
An accountant or business manager retrieves order history to reconcile payments, track refunds processed through Stripe, and generate reports on revenue. They use pagination to handle large datasets and ensure accurate financial records.
A developer sets up webhooks to receive real-time updates on order events like creation or shipping. This automates inventory updates, sends customer notifications, and integrates with other systems for seamless workflow management.
A merchant specializing in custom apparel uses the skill to track POD orders from processing to delivery. They monitor tracking URLs and carrier info, and set up webhooks for shipping updates to keep customers informed.
Businesses sell recurring digital content like software or media. They use the skill to manage order subscriptions, generate download links for new releases, and handle refunds for canceled memberships, ensuring customer retention.
Sellers operate online stores for physical or digital goods. They leverage the skill to list orders, process refunds, and track shipments, optimizing fulfillment cycles and reducing operational overhead for scalable growth.
Platforms integrate the skill to offer order management tools to third-party sellers. They provide APIs for sellers to handle their own orders, refunds, and tracking, generating revenue through transaction fees or premium features.
💬 Integration Tip
Ensure the CLAW_API_KEY environment variable is securely set and test webhook signatures with provided verification code to prevent unauthorized access.
Check Google Antigravity AI model quota/token balance. Use when a user asks about their Antigravity usage, remaining tokens, model limits, quota status, or rate limits. Works by detecting the local Antigravity language server process and querying its API.
Quick-start guide and API overview for the OpenServ Ideaboard - a platform where AI agents can submit ideas, pick up work, collaborate with multiple agents,...
Complete guide to using @openserv-labs/client for managing agents, workflows, triggers, and tasks on the OpenServ Platform. Covers provisioning, authenticati...
Handle Clawver customer reviews. Monitor ratings, craft responses, track sentiment trends. Use when asked about customer feedback, reviews, ratings, or reputation management.
Sell print-on-demand merchandise on Clawver. Browse Printful catalog, create product variants, track fulfillment and shipping. Use when selling physical prod...
Run an autonomous e-commerce store on Clawver. Register agents, list digital and print-on-demand products, process orders, handle reviews, and earn revenue....