Anonymous Orders
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
Array containing the matched order (always single item if successful)
Order ID
Order number (unique identifier)
Order total amount
Total discount applied
Amount before discounts (computed field)
Shipping cost
Tax rate for shipping
Total refund amount
Refunded discount amount
Refunded shipping amount
Whether order is fully cancelled
Whether order can be cancelled
Whether order is eligible for refund
Whether order has pending payment
Shipment tracking URL
Shipment tracking number
Invoice number
Invoice date
E-Archive document URL
Email address used for order
Whether order includes gift box
Gift box message/note
Order delivery instructions
Number of payment installments
Interest amount for installment payment
Credit card BIN number (first 6-8 digits)
Additional order data (rewards, custom fields, etc.)
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
POST /users/orders/anonymous/ HTTP/1.1
Host: sandbox.akinon.com
Content-Type: application/json
Accept: */*
Content-Length: 42
{
"number": "text",
"email": "name@gmail.com"
}[
{
"pk": 1,
"number": "text",
"status": {
"value": "text",
"label": "text"
},
"currency": {
"value": "text",
"label": "text"
},
"amount": "text",
"discount_amount": "text",
"amount_without_discount": "text",
"shipping_amount": "text",
"shipping_tax_rate": null,
"refund_amount": "text",
"discount_refund_amount": "text",
"shipping_refund_amount": "text",
"is_cancelled": true,
"is_cancellable": true,
"is_refundable": true,
"is_payable": true,
"tracking_url": null,
"tracking_number": null,
"invoice_number": null,
"invoice_date": null,
"e_archive_url": null,
"order_type": {
"value": "text",
"label": "text"
},
"user_email": "name@gmail.com",
"has_gift_box": null,
"gift_box_note": null,
"notes": null,
"installment_count": 1,
"installment_interest_amount": "text",
"bin_number": null,
"created_date": "2026-01-01T00:00:00.000Z",
"modified_date": "2026-01-01T00:00:00.000Z",
"shipping_address": {
"pk": 1,
"email": null,
"phone_number": "text",
"first_name": "text",
"last_name": "text",
"country": {
"pk": 1,
"name": "text",
"code": "text"
},
"city": {
"pk": 1,
"name": "text",
"code": "text"
},
"line": "text",
"title": "text",
"township": {
"pk": 1,
"name": "text",
"code": "text"
},
"district": {
"pk": 1,
"name": "text",
"code": "text"
},
"postcode": null,
"notes": null,
"company_name": null,
"tax_office": null,
"tax_no": null,
"e_bill_taxpayer": null,
"hash_data": "text",
"address_type": {
"value": "text",
"label": "text"
},
"retail_store": {},
"remote_id": null,
"identity_number": null,
"extra_field": null,
"user": null,
"is_corporate": null,
"primary": null
},
"billing_address": {
"pk": 1,
"email": null,
"phone_number": "text",
"first_name": "text",
"last_name": "text",
"country": {
"pk": 1,
"name": "text",
"code": "text"
},
"city": {
"pk": 1,
"name": "text",
"code": "text"
},
"line": "text",
"title": "text",
"township": {
"pk": 1,
"name": "text",
"code": "text"
},
"district": {
"pk": 1,
"name": "text",
"code": "text"
},
"postcode": null,
"notes": null,
"company_name": null,
"tax_office": null,
"tax_no": null,
"e_bill_taxpayer": null,
"hash_data": "text",
"address_type": {
"value": "text",
"label": "text"
},
"retail_store": {},
"remote_id": null,
"identity_number": null,
"extra_field": null,
"user": null,
"is_corporate": null,
"primary": null
},
"shipping_company": {
"value": "text",
"label": "text"
},
"client_type": {
"value": "text",
"label": "text"
},
"payment_option": {
"pk": 1,
"name": "text",
"payment_type": "text",
"slug": "text"
},
"bank": {
"pk": 1,
"name": "text",
"slug": "text",
"logo": null,
"logo_path": null
},
"extra_field": null,
"orderitem_set": [
{
"pk": 1,
"product": {
"pk": 1,
"sku": "text",
"base_code": "text",
"name": "text",
"image": null,
"absolute_url": "text",
"attributes": {},
"attributes_kwargs": {},
"form_schema": [],
"data_source": null,
"extra_attributes": {},
"category": null,
"attribute_set": []
},
"order": 1,
"price": "text",
"tax_rate": "text",
"retail_price": null,
"discount_amount": null,
"discounted_price": "text",
"status": {
"value": "text",
"label": "text"
},
"price_currency": {
"value": "text",
"label": "text"
},
"is_cancelled": true,
"is_cancellable": true,
"is_refundable": true,
"is_tradable": true,
"tracking_url": null,
"tracking_number": null,
"invoice_number": null,
"invoice_date": null,
"e_archive_url": null,
"shipping_company": {
"value": "text",
"label": "text"
},
"shipping_option_group": {
"pk": 1,
"amount": "text",
"shipping_option_name": "text",
"shipping_option_logo": null
},
"estimated_delivery_date": null,
"shipped_date": null,
"delivered_date": null,
"image": null,
"attributes": null,
"attributes_kwargs": null,
"extra_field": null,
"cancellationrequest_set": [
{
"pk": 1,
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"order_item": 1,
"reason": 1,
"cancellation_type": {
"value": "text",
"label": "text"
},
"status": {
"value": "text",
"label": "text"
},
"description": null,
"iban": null,
"holder_name": null,
"easy_return": {
"shipping_company": {
"value": "text",
"label": "text"
},
"code": "text",
"start_date": null,
"end_date": null,
"status": {
"value": "text",
"label": "text"
},
"tracking_number": null,
"tracking_url": null,
"pickup_date": {
"date": "2026-01-01",
"hour_range": {
"start": "text",
"end": "text"
}
}
},
"quantity": null,
"fully_refund_as_loyalty_money": null,
"cancellation_request_image_set": [
{
"pk": 1,
"cancellation_request": 1,
"image": "https://example.com",
"description": null,
"is_uploaded_by_user": true,
"created_date": "2026-01-01T00:00:00.000Z",
"modified_date": "2026-01-01T00:00:00.000Z"
}
],
"created_date": "2026-01-01T00:00:00.000Z",
"modified_date": "2026-01-01T00:00:00.000Z"
}
],
"active_cancellation_request": {
"pk": 1,
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"order_item": 1,
"reason": 1,
"cancellation_type": {
"value": "text",
"label": "text"
},
"status": {
"value": "text",
"label": "text"
},
"description": null,
"iban": null,
"holder_name": null,
"easy_return": {
"shipping_company": {
"value": "text",
"label": "text"
},
"code": "text",
"start_date": null,
"end_date": null,
"status": {
"value": "text",
"label": "text"
},
"tracking_number": null,
"tracking_url": null,
"pickup_date": {
"date": "2026-01-01",
"hour_range": {
"start": "text",
"end": "text"
}
}
},
"quantity": null,
"fully_refund_as_loyalty_money": null,
"cancellation_request_image_set": [
{
"pk": 1,
"cancellation_request": 1,
"image": "https://example.com",
"description": null,
"is_uploaded_by_user": true,
"created_date": "2026-01-01T00:00:00.000Z",
"modified_date": "2026-01-01T00:00:00.000Z"
}
],
"created_date": "2026-01-01T00:00:00.000Z",
"modified_date": "2026-01-01T00:00:00.000Z"
},
"available_easy_return_shipping_companies": [
{
"pk": 1,
"shipping_company": {
"value": "text",
"label": "text"
},
"name": "text"
}
],
"datasource_detailed": null,
"extra_product_stock_detailed": null,
"extra_product_price_detailed": null
}
],
"discountitem_set": [
{
"name": "text",
"amount": "text",
"created_date": "2026-01-01T00:00:00.000Z",
"order_number": "text",
"currency": {
"value": "text",
"label": "text"
}
}
],
"loyaltytransaction_set": [
{
"pk": 1,
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"amount": "text",
"order": null,
"user": null,
"user_email": null,
"reference": null
}
]
}
]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
Cancellation request record (response)
Unique identifier for the cancellation request
Order item ID
Cancellation reason ID
User-provided cancellation description
IBAN for refund (for cash payment orders)
Account holder name for refund
Quantity being cancelled (for mergeable order items)
Whether refund is issued as loyalty points
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)
POST /users/orders/anonymous/cancellation_requests/ HTTP/1.1
Host: sandbox.akinon.com
Content-Type: application/json
Accept: */*
Content-Length: 503
{
"number": "text",
"email": "name@gmail.com",
"order_item": 1,
"reason": 1,
"cancellation_type": "cancel",
"description": "text",
"shipping_company": 1,
"pickup_date": {
"date": "2024-12-25",
"hour_range": {
"start": "09:00",
"end": "12:00"
}
},
"quantity": 1,
"iban": "text",
"holder_name": "text",
"cancellation_request_image_set": [
{
"image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJChQODwwQFxQYGBcUFhYaHSUfGhsjHBYWICwgIyYnKSopGR8tMC0oMCUoKSj/...",
"description": "Product damage on corner"
}
]
}{
"pk": 1,
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"order_item": 1,
"reason": 1,
"cancellation_type": {
"value": "text",
"label": "text"
},
"status": {
"value": "text",
"label": "text"
},
"description": null,
"iban": null,
"holder_name": null,
"easy_return": {
"shipping_company": {
"value": "text",
"label": "text"
},
"code": "text",
"start_date": null,
"end_date": null,
"status": {
"value": "text",
"label": "text"
},
"tracking_number": null,
"tracking_url": null,
"pickup_date": {
"date": "2026-01-01",
"hour_range": {
"start": "text",
"end": "text"
}
}
},
"quantity": null,
"fully_refund_as_loyalty_money": null,
"cancellation_request_image_set": [
{
"pk": 1,
"cancellation_request": 1,
"image": "https://example.com",
"description": null,
"is_uploaded_by_user": true,
"created_date": "2026-01-01T00:00:00.000Z",
"modified_date": "2026-01-01T00:00:00.000Z"
}
],
"created_date": "2026-01-01T00:00:00.000Z",
"modified_date": "2026-01-01T00:00:00.000Z"
}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
Array of created cancellation requests
Unique identifier for the cancellation request
Order item ID
Cancellation reason ID
User-provided cancellation description
IBAN for refund (for cash payment orders)
Account holder name for refund
Quantity being cancelled (for mergeable order items)
Whether refund is issued as loyalty points
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)
POST /users/orders/anonymous/bulk_cancellation_requests/ HTTP/1.1
Host: sandbox.akinon.com
Content-Type: application/json
Accept: */*
Content-Length: 459
{
"number": "text",
"email": "name@gmail.com",
"cancel_order_items": [
{
"order_item": 1,
"reason": 1,
"cancellation_type": "cancel",
"description": "text",
"shipping_company": 1,
"pickup_date": {
"date": "2024-12-25",
"hour_range": {
"start": "09:00",
"end": "12:00"
}
},
"quantity": 1,
"iban": "text",
"holder_name": "text",
"cancellation_request_image_set": [
{
"image": "data:image/jpeg;base64,/9j/4AAQSkZJRg...",
"description": "text"
}
]
}
],
"pickup_address": 1,
"fully_refund_as_loyalty_money": false
}[
{
"pk": 1,
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"order_item": 1,
"reason": 1,
"cancellation_type": {
"value": "text",
"label": "text"
},
"status": {
"value": "text",
"label": "text"
},
"description": null,
"iban": null,
"holder_name": null,
"easy_return": {
"shipping_company": {
"value": "text",
"label": "text"
},
"code": "text",
"start_date": null,
"end_date": null,
"status": {
"value": "text",
"label": "text"
},
"tracking_number": null,
"tracking_url": null,
"pickup_date": {
"date": "2026-01-01",
"hour_range": {
"start": "text",
"end": "text"
}
}
},
"quantity": null,
"fully_refund_as_loyalty_money": null,
"cancellation_request_image_set": [
{
"pk": 1,
"cancellation_request": 1,
"image": "https://example.com",
"description": null,
"is_uploaded_by_user": true,
"created_date": "2026-01-01T00:00:00.000Z",
"modified_date": "2026-01-01T00:00:00.000Z"
}
],
"created_date": "2026-01-01T00:00:00.000Z",
"modified_date": "2026-01-01T00:00:00.000Z"
}
]Last updated
Was this helpful?