# 8. Order

Order — Post-Purchase & Fulfillment Operations

Manage the order lifecycle after checkout: browse orders, view details, make accept/reject decisions, and create pickup/drop-off requests.

NOTES

Decisions apply to pending orders only.
Pickup/Drop-off requests are processed in batches; track via requestId/batchId, with final summaries via webhook.
All responses use the standard envelope; bulk calls include per-item outcomes.

# Endpoints

# Order Status

This section defines the available status and substatus values supported by the Get Store Orders API.
Partners can filter orders using status or substatus query parameters.

# Status (coarse)

Status	Description
`unpaid`	Order created but not yet paid
`awaiting_seller`	Paid, waiting for seller confirmation
`ready_to_ship`	Accepted, waiting for pickup or drop-off
`in_transit`	Package has been dispatched
`completed`	Order successfully finished
`canceled`	Order canceled
`reverse`	Return, complaint, or reverse flow

# Substatus (fine-grained)

Substatus	Description
`payment_expired`	Buyer did not pay before deadline
`auto_cancel_no_confirm`	Auto-cancel: seller didn’t confirm
`auto_cancel_no_deliver`	Auto-cancel: seller didn’t deliver
`rejected_by_seller`	Seller explicitly rejected
`instant_cancel`	Cancelled immediately after create
`buyer_cancel_after_paid`	Buyer cancelled after payment
`seller_approved_cancel`	Seller approved cancellation request
`cancellation_requested`	Buyer requested cancellation
`created`	Order just created
`waiting_buyer_info`	Waiting for buyer to provide details
`waiting_payment`	Waiting for buyer payment
`payment_method_change`	Buyer is changing payment method
`waiting_seller_confirmation`	Waiting for seller confirmation
`confirmed`	Seller confirmed order
`pickup_failed`	Pickup attempt failed
`waiting_pickup`	Waiting for pickup by courier
`waiting_drop_off`	Waiting for drop-off by seller
`in_transit`	Package is in transit
`insurance_claim_requested`	Insurance claim filed
`return_in_transit`	Returned package in transit
`returned_to_seller`	Returned package arrived at seller
`returned_disburse_queued`	Returned package queued for disburse
`delivered`	Package delivered to buyer
`order_completed`	Order marked completed
`complained_open`	Buyer complaint is open
`complaint_resolved`	Complaint resolved
`disbursed`	Seller payout disbursed

# Usage Examples

# Get all unpaid orders
GET /partner/orders?status=unpaid

# Get ready-to-ship orders waiting for pickup
GET /partner/orders?status=ready_to_ship&substatus=waiting_pickup