Guide · AliExpress Open Platform API

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.

What does the WAIT_SELLER_SEND_GOODS status mean?

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.

How do I find new AliExpress orders to fulfill?

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.

How do I upload tracking for an AliExpress order?

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.

What does a frozen order status mean?

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.

Resources

Related pages and references

The AliExpress order API, run for you

Ship-ready orders found automatically, cross-border shipping documents produced, tracking uploaded, issues surfaced. Live in 1–3 business days.

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.

InfiPlex™ is a trademark of InfiPlex. AliExpress is a trademark of Alibaba Group Holding Limited or its affiliates. Temu is a trademark of Whaleco Inc. Amazon and other names are trademarks of their respective owners. InfiPlex is an independent integration provider and is not endorsed by or affiliated with AliExpress or Alibaba Group. Program rules, thresholds, and fees are set by AliExpress, differ by seller account type and category, and change; verify current terms in AliExpress Seller Center before relying on them. ©2026 InfiPlex. All rights reserved.