Overview
Store Returns API allows store owners to list returns, review detailed requests, respond (approve/reject), mark pickups completed (triggering refunds), and configure return policies. Location:convex/stores/returns.ts
List Store Returns
List return requests for a store with optional status filtering.Id<'stores'>
Store ID (defaults to authenticated owner’s store)
'pending' | 'approved' | 'rejected' | 'picked_up' | 'refunded' | 'cancelled'
Optional status filter
PaginationOptions
required
Pagination configuration
Get Return Request Details
Get the full details of a return request for store review.Id<'returnRequests'>
required
Return request ID
Respond To Return
Approve or reject a return request.Id<'returnRequests'>
required
Return request ID
boolean
required
Decision: true to approve, false to reject
string
Optional reason (required when rejecting)
Mark Pickup Completed
Mark a return as picked up. This will schedule refund processing.Id<'returnRequests'>
required
Return request ID
Update Return Policy
Configure store-level return policy settings.Id<'stores'>
Store ID (defaults to authenticated owner’s store)
boolean
Whether returns are allowed
number
Return window in days (1-90)
Update Product Returnability
Toggle whether a product is returnable.Id<'products'>
required
Product ID
boolean
required
Whether product is returnable
