AliExpress Open Platform API: the seller order lifecycle on the wire
Official AliExpress seller integrations run on the AliExpress Open Platform, a partner API with app-level authorization, order and logistics methods, and a defined order state machine. This page follows one order from placement through payment, risk review, dispatch, and tracking upload, with the method name, the state it produces, and the operations a seller can and cannot take at each step.
State Machine14+ order states from placement to archive
Seller Acts OnceOnly two states let the seller send goods or resolve an issue
Tracking RequiredUpload before the order can move to Wait Buyer Accept Goods
Step 0
Authorization: an approved app on a verified seller account
An AliExpress integration is a registered Open Platform app, approved by AliExpress, authorized against a specific seller's Seller Center account. Access is restricted: a business submits its integration purpose and goals as part of approval, and the resulting credentials are scoped to that seller. There is no public self-serve token the way some marketplace APIs allow; the review step is part of why most sellers connect through an approved partner rather than building directly against the raw API.
The order state machine
What each status means and what the seller can do
Order status
Meaning
Seller action
PLACE_ORDER_SUCCESS
Order placed, waiting on buyer payment
None
PAYMENT_PROCESSING
Buyer's payment is processing
None
RISK_CONTROL
Payment succeeded, order under platform risk review
None
WAIT_SELLER_EXAMINE_MONEY
Risk review flagged the payment for seller review
Accept or refuse
WAIT_SELLER_SEND_GOODS
Risk control passed; order is ready to ship
Send goods, then upload tracking
SELLER_PART_SEND_GOODS
Part of the order has shipped
Continue shipping remaining items, upload tracking for each
WAIT_BUYER_ACCEPT_GOODS
All goods shipped, buyer has not yet confirmed receipt
None
IN_CANCEL
Buyer and seller are working toward a cancellation agreement
Accept or refuse
in_issue
A dispute or issue has been raised on the order
Accept, refuse, or negotiate further
FINISH
Funds processing completed; order is closed
None
ARCHIVE
Finished order moved to archive
None
frozen_status / in_frozen
Order frozen; neither party can act
None
WAIT_SELLER_SEND_GOODS is the one state that matters operationally: it is the only point where the seller initiates the next step, and it is where dispatch-time and tracking-upload compliance is earned or lost. Everything before it is the buyer's payment and AliExpress's own risk review; everything after WAIT_BUYER_ACCEPT_GOODS is the buyer's and the platform's to resolve.
Reading orders
List, detail, and single-order lookups
Method
What it returns
When to use it
aliexpress.trade.redefining.findorderlistquery
A list of orders, filterable by status and time window
Polling for new orders in WAIT_SELLER_SEND_GOODS
aliexpress.trade.redefining.findorderbaseinfo
Basic info for a single order: status and logistics status
Quick status check without full line-item detail
aliexpress.trade.redefining.findorderbyid
Full detail for a single order
Pulling line items, buyer info, and amounts before shipping
A short polling cycle on the list method, filtered to orders sitting in WAIT_SELLER_SEND_GOODS, is how an integration finds work to do. Detail calls fill in the line items and buyer information needed to pick, pack, and produce a customs-ready shipment.
Shipping and tracking
Uploading tracking and handling partial shipments
Once goods ship, all or in part, the seller updates the order with tracking through aliexpress.logistics.sellershipmentfortop, supplying the carrier service name exactly as it appears in AliExpress's own carrier list and the tracking number. A partial shipment moves the order to SELLER_PART_SEND_GOODS rather than WAIT_BUYER_ACCEPT_GOODS, and each remaining shipment needs its own tracking update before the order can complete. For cross-border shipments, aliexpress.logistics.querylogisticsorderdetail returns the international logistics number and label detail needed before a label can be printed, which is the customs-and-carrier layer that domestic order fulfillment does not require.
Step
API method
Produces
Poll for new orders
findorderlistquery
Orders in WAIT_SELLER_SEND_GOODS
Pull order detail
findorderbyid
Line items, buyer info, amounts
Get logistics / label detail
querylogisticsorderdetail
International logistics number, required before printing
Ship and upload tracking
sellershipmentfortop
SELLER_PART_SEND_GOODS or WAIT_BUYER_ACCEPT_GOODS
When something goes wrong
Cancellations and issues
A buyer-initiated cancellation request moves the order to IN_CANCEL, where the seller can accept or refuse before funds are released back; a raised dispute moves it to in_issue, with the same accept, refuse, or negotiate options. Orders can also enter a frozen state where neither party can act, typically while AliExpress resolves a platform-level hold. An integration that only watches for WAIT_SELLER_SEND_GOODS will miss these states entirely, so polling needs to cover the full status list, not just the ship-ready one.
Automation
How InfiPlex runs the AliExpress API
InfiPlex is authorized against your verified AliExpress seller account, polls for orders in WAIT_SELLER_SEND_GOODS on a short cycle, pulls full order detail before releasing it to your pick queue, produces the international logistics and customs documentation the shipment needs, uploads tracking through the shipment API, and watches for cancellations and issues so they reach a person rather than sitting unresolved. Set-up and the seller-account side are on the official seller requirements guide; the program page is AliExpress integration.
Frequently asked
Questions, answered
Questions from developers and operations teams connecting an official AliExpress seller account.
Through the AliExpress Open Platform, where a business submits its integration purpose for approval and receives credentials scoped to a specific verified seller account. Access is reviewed, not self-serve.
The order has passed payment and AliExpress's risk review and is ready for the seller to ship. It is the one status where the seller initiates the next action, either sending goods and uploading tracking, or, for orders flagged earlier, accepting or refusing an examine-money or cancellation request.
Poll aliexpress.trade.redefining.findorderlistquery filtered to orders in WAIT_SELLER_SEND_GOODS, then pull full detail with findorderbyid or a quick status check with findorderbaseinfo before releasing the order to fulfillment.
Through aliexpress.logistics.sellershipmentfortop, supplying the carrier service name exactly as AliExpress lists it and the tracking number. Partial shipments move the order to SELLER_PART_SEND_GOODS and each remaining shipment needs its own tracking update.
A cross-border tracking identifier returned by aliexpress.logistics.querylogisticsorderdetail, required before a shipping label can be printed on international orders.
The order moves to IN_CANCEL, and the seller can accept or refuse the request before any refund is finalized. A raised dispute works the same way under the in_issue status.
Neither the buyer nor the seller can act on the order while it is frozen, usually while AliExpress resolves a platform-level hold. It requires no seller action, but should still be visible in your order dashboard rather than silently ignored.
Yes. InfiPlex polls for ship-ready orders, pulls full detail, produces cross-border shipping and customs documentation, uploads tracking, and surfaces cancellations and issues so a person can act on them.
Connecting an AliExpress account and hitting API approval or tracking errors?
Our team has connected verified AliExpress seller accounts across categories. Tell us where the connection stalls and we will get orders flowing. Contact us, email info@infiplex.com, or call 888‑770‑0857.
Our website uses cookies to help provide the best user experience. By continuing to use this site, you consent to the use of cookies as described in our Privacy Policy. OK