AnonymousOrders
Guest/anonymous order operations
Allows guest users to retrieve their order details by providing the order number and email address used during checkout.
Access Restriction: Only returns orders where user type is 'guest'. Orders from registered users cannot be queried through this endpoint.
Validation:
Order must exist and belong to a guest user
Email must exactly match the order's user_email field
Email format must be valid
Response: Returns array with single order object if found.
Order number
Email address used for the order (must match)
Order details retrieved successfully
Validation errors:
- Order number doesn't exist or doesn't belong to a guest user
- Email doesn't match order's user_email
- Invalid email format
Allows guest users to request cancellation of order items. Requires order number and email for verification.
Validation:
Order must exist and belong to a guest user
Email must match order's user_email
Order item must belong to the specified order
Order item cannot already have an active cancellation request
Cancellation Types:
cancel: Simple cancellation without refund processrefund: Refund request (requires shipping_company for easy return)
Shipping Company Requirement: For refund type cancellations, shipping_company is required for easy return process.
Error Codes:
cancellation_request_100_1: Cancellation request already exists for this order item
Order number
Email address (must match order)
Order item ID to cancel
Cancellation reason ID
Type of cancellation.
- cancel: Simple cancellation
- refund: Cancellation with refund (easy return)
Optional cancellation description
Easy return shipping company ID (required for refund type). Must be an active EasyReturnShippingCompany.
Quantity to cancel (for mergeable order items). Cannot exceed order item quantity.
IBAN for refund (for cash payment orders)
Account holder name for refund
Cancellation request created successfully
Validation errors:
- Order not found or doesn't belong to guest user
- Email doesn't match order
- Order item doesn't exist or doesn't belong to order
- Cancellation request already exists (error_code: cancellation_request_100_1)
- Missing required fields for refund type
- Invalid quantity (exceeds order item quantity for mergeable items)
Allows guest users to request cancellation of multiple order items in a single request. Requires order number and email for verification.
Validation:
Order must exist and belong to a guest user
Email must match order's user_email
All order items must belong to the specified order
At least one order item must be provided
Order items cannot already have active cancellation requests
Structure: Request contains array of cancel_order_items, where each item can have:
Required: order_item, reason, cancellation_type
Optional: description, shipping_company, pickup_date, quantity, cancellation_request_image_set
Pickup Address: Optional shared pickup address for all items (for easy return refunds).
Loyalty Money Refund: Set fully_refund_as_loyalty_money to refund entire amount as loyalty points.
Order number
Email address (must match order)
Optional shared pickup address ID for all items. Must be a customer address belonging to the user.
Whether to refund entire amount as loyalty points
falseCancellation requests created successfully for all items
Validation errors:
- Order not found or doesn't belong to guest user
- Email doesn't match order
- Empty cancel_order_items array
- Order item doesn't exist or doesn't belong to order
- Missing required fields (order_item, reason, cancellation_type)
- Invalid quantity for mergeable items
- Too many images per item (exceeds CANCELLATION_REQUEST_MAX_IMAGE_COUNT_PER_ORDER_ITEM)
Last updated
Was this helpful?