Custom store API / Order object

Order object (Order · Item · Shipment)

These objects appear in order lookup responses. Names match Cafe24; Lillo-only fields say “Extension” in the description.

Order

order_idstringRequired

Order no.

order_datestringRequired

Order time (ISO 8601)

itemsItem[]Required

Order items

member_idstringOptional

Member ID. Omit for guest orders

payment_datestringOptional

Payment time

paidstringOptional

Paid or not, "T"/"F"

payment_methodstring[]Optional

Payment methods (e.g. ["card"])

payment_amountstringOptional

Amount paid

actual_order_amountobjectOptional

shipping_fee and total_amount_due. If payment_amount is 0 because payment hasn't been made yet, Lillo quotes total_amount_due

buyerobjectOptional

Buyer. Mask names and contact details

receiversobject[]Optional

Shipping addresses: name, cellphone, zipcode, address1, address2. Mask names and contact details

shipmentsShipment[]Optional

Shipping info. Include it and you can skip the shipments endpoint

currencystringOptional

Extension. Currency (KRW if omitted)

status / status_labelstringOptional

Extension. Lillo standard status and display label — see status mapping

order_urlstringOptional

Extension. Order detail URL the customer can open

customsobjectOptional

Extension, coming soon. Customs status — see below

FieldTypeRequiredDescription

order_idstringRequiredOrder no.

order_datestringRequiredOrder time (ISO 8601)

itemsItem[]RequiredOrder items

member_idstringOptionalMember ID. Omit for guest orders

payment_datestringOptionalPayment time

paidstringOptionalPaid or not, "T"/"F"

payment_methodstring[]OptionalPayment methods (e.g. ["card"])

payment_amountstringOptionalAmount paid

actual_order_amountobjectOptionalshipping_fee and total_amount_due. If payment_amount is 0 because payment hasn't been made yet, Lillo quotes total_amount_due

buyerobjectOptionalBuyer. Mask names and contact details

receiversobject[]OptionalShipping addresses: name, cellphone, zipcode, address1, address2. Mask names and contact details

shipmentsShipment[]OptionalShipping info. Include it and you can skip the shipments endpoint

currencystringOptionalExtension. Currency (KRW if omitted)

status / status_labelstringOptionalExtension. Lillo standard status and display label — see status mapping

order_urlstringOptionalExtension. Order detail URL the customer can open

customsobjectOptionalExtension, coming soon. Customs status — see below

Item

order_item_codestringRequired

Item code

product_namestringRequired

Product name

quantitynumberRequired

Quantity

order_statusstringRequired

Cafe24 status code (e.g. N30)

product_nostringOptional

Product number

option_valuestringOptional

Option (e.g. Color=Ivory, Size=M)

product_pricestringOptional

Product price. The unit price is product_price + option_price

option_pricestringOptional

Option surcharge

claim_statusstringOptional

Claim status

shipped_date / delivered_datestringOptional

Shipped and delivered times

imagestringOptional

Extension. Absolute https URL of the product photo. Never an empty string — if the option has no photo, use the product's main image

status / status_labelstringOptional

Extension. Lillo standard status and display label per item

FieldTypeRequiredDescription

order_item_codestringRequiredItem code

product_namestringRequiredProduct name

quantitynumberRequiredQuantity

order_statusstringRequiredCafe24 status code (e.g. N30)

product_nostringOptionalProduct number

option_valuestringOptionalOption (e.g. Color=Ivory, Size=M)

product_pricestringOptionalProduct price. The unit price is product_price + option_price

option_pricestringOptionalOption surcharge

claim_statusstringOptionalClaim status

shipped_date / delivered_datestringOptionalShipped and delivered times

imagestringOptionalExtension. Absolute https URL of the product photo. Never an empty string — if the option has no photo, use the product's main image

status / status_labelstringOptionalExtension. Lillo standard status and display label per item

Common mistake — empty item photo

Set item image to an absolute https URL of the product photo. Empty strings ("") aren't allowed. If the ordered option has no photo of its own, use that product's main image. Looking up photos by option ID alone is the usual way this ends up empty.

Item image — good / bad

// Good — the option has no photo, so use the product's main image
"image": "https://cdn.mall.example.com/products/77/main.jpg"

// Bad — empty string or relative path
"image": ""
"image": "/products/77/main.jpg"

Shipment

tracking_nostringRequired

Tracking number

shipping_company_namestringRequired

Carrier name. If missing, Lillo looks it up from shipping_company_code (Cafe24 code)

shipping_codestringOptional

Shipping code

shipping_company_codestringOptional

Cafe24 carrier code

statusstringOptional

standby (waiting) · shipping (in transit) · shipped (delivered)

itemsobject[]Optional

order_item_code of the items in this shipment

tracking_urlstringOptional

Extension. Tracking URL

shipped_datestringOptional

Extension. Ship time

FieldTypeRequiredDescription

tracking_nostringRequiredTracking number

shipping_company_namestringRequiredCarrier name. If missing, Lillo looks it up from shipping_company_code (Cafe24 code)

shipping_codestringOptionalShipping code

shipping_company_codestringOptionalCafe24 carrier code

statusstringOptionalstandby (waiting) · shipping (in transit) · shipped (delivered)

itemsobject[]Optionalorder_item_code of the items in this shipment

tracking_urlstringOptionalExtension. Tracking URL

shipped_datestringOptionalExtension. Ship time

Customs status (coming soon)

For cross-border orders, we've reserved a customs (extension) format for clearance status. We'll announce it in the changelog once Lillo starts reading it.

customs format

"customs": {
  "status": "pending" | "in_progress" | "duty_required" | "cleared" | "failed",
  "label": "Customs clearance in progress",
  "note": "Duty notice sent by SMS"
}

PreviousOrder lookup NextStatus mapping