Taobao Order Fulfillment Flow: From Creation to After-Sales

API Endpoint: /open/purchase/page
Status Enums: TaoBaoOrderStatusEnum + RefundStatusEnum
Last Updated: May 28, 2026

📋 Order Status Overview

I. Main Order Status (TaoBaoOrderStatusEnum)

Phase	Status Code	Enum Name	Taobao Raw Status	Description	Notes
Creation	12	`ORDER_BULIDING`	BULIDING	Building	Order is being created
Awaiting Payment	0	`TAOBAO_ORDER_WAIT_BUYER_PAY`	WAIT_BUYER_P	Awaiting Payment	Waiting for buyer payment
Payment	1	`ORDER_PAY_STATUS`	ORDER_PAY_STATUS	Paid/Awaiting Finance	Buyer uploaded payment proof
	2	`ORDER_FINANCE_PASS_STATUS`	ORDER_FINANCE_PASS_STATUS	Finance Approved	Finance confirmed payment
	3	`ORDER_FINANCE_REFUSE_STATUS`	ORDER_FINANCE_REFUSE_STATUS	Finance Rejected	Finance rejected confirmation
	5	`WAIT_FINANCE_PAY`	WAIT_FINANCE_PAY	Awaiting Finance Pay	Waiting for finance system payment
Shipping	10	`WAIT_SELLER_SEND_GOODS`	WAIT_SELLER_SEND_GOODS	Awaiting Shipment	Paid, awaiting seller shipment
Logistics	11	`WAIT_BUYER_CONFIRM_GOODS`	WAIT_BUYER_CONFIRM_GOODS	Shipped	Seller shipped, awaiting buyer confirmation
Cancelled	4	`CANCEL`	TRADE_CLOSED	Cancelled	Order closed/cancelled
Other	9	`OTHER_STATUS`	Unenumerated	Other Status	Other unenumerated status

II. Refund/After-Sales Status (RefundStatusEnum)

Location: TaoBaoOrderVO.SubOrderDetailVO2.refundStatus (Integer)

Status Code	Enum Name	Description	Notes
0	`NOT_APPLY_FOR_REFUND`	No refund applied	Sub-order has no refund application
10	`APPLIED_REFUND`	Buyer applied for refund, awaiting seller agreement	Refund application submitted
20	`AGREE_TO_REFUND`	Seller agreed to refund, awaiting buyer return	Seller agreed to refund
30	`WAITING_SELLER_RECEIPT`	Buyer returned goods, awaiting seller receipt confirmation	Buyer returned goods
100	`REFUND_SUCCESSFUL`	Refund successful	Refund completed, funds returned
-10	`SELLER_REFUSES_REFUND`	Seller refused refund	Seller refused refund application
-20	`REFUND_CLOSED`	Refund closed	Refund process closed

🔄 Main Business Flows

Flow 1: Normal Fulfillment (Success)

ORDER_BULIDING(12) 
  ↓
TAOBAO_ORDER_WAIT_BUYER_PAY(0) ← Order creation completed
  ↓
ORDER_PAY_STATUS(1) ← Buyer uploads payment proof
  ↓
ORDER_FINANCE_PASS_STATUS(2) ← Finance approves
  ↓ OR WAIT_FINANCE_PAY(5) → Finance system auto-pays
WAIT_SELLER_SEND_GOODS(10) ← Payment completed, awaiting shipment
  ↓
WAIT_BUYER_CONFIRM_GOODS(11) ← Seller shipped
  ↓
(Trade completed, Taobao platform auto-closes)

Time Requirements:

Finance confirmation: Usually 1-2 business days

Seller shipment: Depending on supplier, usually 1-3 days

Buyer confirmation: Taobao auto-confirmation usually 10-15 days

Flow 2: Finance Rejection Flow

ORDER_PAY_STATUS(1)
  ↓
ORDER_FINANCE_REFUSE_STATUS(3) ← Finance rejects
  ↓
TAOBAO_ORDER_WAIT_BUYER_PAY(0) ← Return to awaiting payment
  ↓
(Buyer re-uploads proof or cancels order)

Flow 3: Order Cancellation Flow

Cancellable Statuses:

TAOBAO_ORDER_WAIT_BUYER_PAY(0) - Awaiting payment ✅

ORDER_PAY_STATUS(1) - Paid/awaiting finance ✅

ORDER_BULIDING(12) - Building ✅

Non-Cancellable Statuses (Payment locked):

ORDER_FINANCE_PASS_STATUS(2) - Finance approved ❌

WAIT_FINANCE_PAY(5) - Awaiting finance payment ❌

WAIT_SELLER_SEND_GOODS(10) - Awaiting shipment ❌

WAIT_BUYER_CONFIRM_GOODS(11) - Shipped ❌

After Cancellation:

Any cancellable status → CANCEL(4) TRADE_CLOSED

Flow 4: Refund/After-Sales Flow ✨

WAIT_SELLER_SEND_GOODS(10) OR WAIT_BUYER_CONFIRM_GOODS(11)
  ↓
Sub-order applies for refund
  ↓
NOT_APPLY_FOR_REFUND(0) → APPLIED_REFUND(10) ← Buyer applies for refund
  ↓
(Seller processes)
  ↓
├─ Agree to refund → AGREE_TO_REFUND(20)
│   ↓
│   WAITING_SELLER_RECEIPT(30) ← Buyer returns goods
│   ↓
│   REFUND_SUCCESSFUL(100) ← Refund successful
│
├─ Refuse refund → SELLER_REFUSES_REFUND(-10)
│   ↓
│   REFUND_CLOSED(-20) ← Refund closed
│
└─ Buyer cancels → REFUND_CLOSED(-20) ← Refund closed

📊 Status Transition Rules

Main Order Status Transitions

From \ To	0	1	2	3	4	5	10	11	12
12 (BUILDING)	✓	-	-	-	-	-	-	-	-
0 (WAIT_PAY)	-	✓	-	-	✓	-	-	-	-
1 (PAY_STATUS)	-	-	✓	✓	✓	✓	-	-	-
2 (FINANCE_PASS)	-	-	-	-	-	✓	✓	-	-
3 (FINANCE_REFUSE)	✓	-	-	-	✓	-	-	-	-
5 (WAIT_FINANCE)	-	-	-	-	✓	-	✓	-	-
10 (WAIT_SENT)	-	-	-	-	-	-	-	✓	-
11 (SENT)	-	-	-	-	-	-	-	-	-

Legend: ✓ = Allowed transition | - = Not allowed

Refund Status Transitions

From \ To	0	10	20	30	100	-10	-20
0 (NOT_APPLY)	-	✓	-	-	-	-	-
10 (APPLIED)	-	-	✓	-	-	✓	✓
20 (AGREE)	-	-	-	✓	-	-	✓
30 (WAIT_RECEIPT)	-	-	-	-	✓	-	-
-10 (REFUSED)	-	-	-	-	-	-	✓

🔍 Customer-Facing Status Descriptions

Fields Visible to Customers

{
  "status": 10,
  "orderStatusDesc": "WAIT_SELLER_SEND_GOODS",
  "subOrderVOS": [
    {
      "subOrderStatus": "WAIT_SELLER_SEND_GOODS",
      "refundStatus": 0,
      "refundId": null
    }
  ]
}

Main Order Status Mapping

status	orderStatusDesc	Customer Understanding
0	`WAIT_BUYER_P`	Awaiting your payment
1	`ORDER_PAY_STATUS`	Paid, awaiting finance confirmation
2	`ORDER_FINANCE_PASS_STATUS`	Finance confirmed, awaiting payment
3	`ORDER_FINANCE_REFUSE_STATUS`	Finance rejected, please re-upload proof
4	`TRADE_CLOSED`	Order cancelled
5	`WAIT_FINANCE_PAY`	Awaiting finance system payment
10	`WAIT_SELLER_SEND_GOODS`	Paid, awaiting seller shipment
11	`WAIT_BUYER_CONFIRM_GOODS`	Seller shipped, awaiting confirmation
12	`BULIDING`	Order being created
9	`Unenumerated:Other`	Order status abnormal, please contact support

Refund Status Mapping

refundStatus	Customer Understanding
0	No refund applied
10	Refund application submitted, awaiting seller agreement
20	Seller agreed to refund, please return goods
30	Goods returned, awaiting seller confirmation
100	Refund successful, funds returned
-10	Seller refused refund
-20	Refund closed

⚠️ Important Rules

1. Payment Lock Rules

Orders cannot be cancelled in the following statuses:

ORDER_FINANCE_PASS_STATUS(2) - Finance approved

WAIT_FINANCE_PAY(5) - Awaiting finance payment

WAIT_SELLER_SEND_GOODS(10) - Awaiting shipment

WAIT_BUYER_CONFIRM_GOODS(11) - Shipped

2. Refund Rules

Refunds can only be applied after shipment status

After successful refund, system automatically refunds account balance

Cancellable refund statuses: APPLIED_REFUND(10), AGREE_TO_REFUND(20), WAITING_SELLER_RECEIPT(30), SELLER_REFUSES_REFUND(-10)

3. Finance Confirmation Rules

After buyer uploads payment proof, requires manual finance confirmation

Finance confirmation automatically triggers payment process

After finance rejection, order returns to awaiting payment status

4. Sub-Order Dimension

Refunds are processed at the sub-order dimension

One main order can contain multiple sub-orders

Each sub-order can independently apply for refunds

🎯 Typical Business Scenarios

Scenario 1: Normal Purchase

User places order → ORDER_BULIDING(12) → WAIT_BUYER_P(0)
Upload proof → ORDER_PAY_STATUS(1)
Finance confirms → ORDER_FINANCE_PASS_STATUS(2)
Finance pays → WAIT_FINANCE_PAY(5) → WAIT_SELLER_SEND_GOODS(10)
Seller ships → WAIT_BUYER_CONFIRM_GOODS(11)
Trade completed

Scenario 2: Finance Rejection

Upload proof → ORDER_PAY_STATUS(1)
Finance refuses → ORDER_FINANCE_REFUSE_STATUS(3)
Return to awaiting → WAIT_BUYER_P(0)
Re-upload → ORDER_PAY_STATUS(1)

Scenario 3: After-Sales Refund

Order shipped → WAIT_BUYER_CONFIRM_GOODS(11)
Apply for refund → refundStatus: 0 → 10
Seller agrees → refundStatus: 20
Buyer returns → refundStatus: 30
Refund successful → refundStatus: 100
Funds returned → Auto-completed

Scenario 4: Refund Refused

Apply for refund → refundStatus: 10
Seller refuses → refundStatus: -10
Refund closed → refundStatus: -20
Order continues fulfillment

📝 API Response Example

{
  "code": "200",
  "message": "success",
  "data": {
    "total": 1,
    "data": [
      {
        "id": "12345",
        "purchaseId": 67890,
        "orderNo": "TB20250528001",
        "status": 10,
        "orderStatusDesc": "WAIT_SELLER_SEND_GOODS",
        "purchaseAmount": 15800,
        "createTime": "2025-05-28 10:30:00",
        "payTime": "2025-05-28 11:00:00",
        "supplierNick": "Test Merchant",
        "servicePrice": 158,
        "handlingFee": 50,
        "subOrderVOS": [
          {
            "id": "1001",
            "orderNo": "sub-001",
            "subOrderStatus": "WAIT_SELLER_SEND_GOODS",
            "refundStatus": 0,
            "refundId": null,
            "taobaoPurchaseId": "67890",
            "taobaoSubPurchaseId": "1001",
            "itemImageUrl": "https://example.com/item.jpg"
          },
          {
            "id": "1002",
            "orderNo": "sub-002",
            "subOrderStatus": "WAIT_BUYER_CONFIRM_GOODS",
            "refundStatus": 10,
            "refundId": "refund_123456",
            "taobaoPurchaseId": "67890",
            "taobaoSubPurchaseId": "1002",
            "itemImageUrl": "https://example.com/item2.jpg"
          }
        ]
      }
    ]
  }
}

📌 Status Flow Diagrams

Main Order Flow

Create Order
   ↓
ORDER_BULIDING(12)
   ↓
TAOBAO_ORDER_WAIT_BUYER_PAY(0) ────────→ CANCEL(4)
   ↓                                      ↑
ORDER_PAY_STATUS(1) ──────────────────────┤
   ↓         ↓                            ↑
   ↓   ORDER_FINANCE_REFUSE(3)            ↑
   ↓         ↓                            ↑
ORDER_FINANCE_PASS(2) ────────────────────┤
   ↓                                      ↑
WAIT_FINANCE_PAY(5) ──────────────────────┤
   ↓                                      
WAIT_SELLER_SEND_GOODS(10)
   ↓
WAIT_BUYER_CONFIRM_GOODS(11)

Refund Status Flow

NOT_APPLY_FOR_REFUND(0)
   ↓ (Apply for refund)
APPLIED_REFUND(10) ──→ REFUND_CLOSED(-20)
   ↓                    ↑
AGREE_TO_REFUND(20) ────┘
   ↓
WAITING_SELLER_RECEIPT(30)
   ↓
REFUND_SUCCESSFUL(100)

✅ Checklist

Check the following during development/testing:

Main order status transitions comply with rules matrix

Finance confirmation flow is correct

Cancellable statuses are correctly restricted

Refund status transitions are correct

Refunds are processed at sub-order dimension

Status description fields return Taobao raw status

Refund ID is correctly populated

🆚 Comparison with KA Orders

Feature	Taobao Order	KA Order
Status Enum	TaoBaoOrderStatusEnum (10)	PoolOrderStatusEnum (12)
Status Description	Taobao raw status string	English enum name
Refund Status	✅ Independent enum RefundStatusEnum (7)	❌ Integrated into main status
Finance Confirmation	✅ Has finance confirmation flow	❌ No finance confirmation
Payment Proof	✅ Requires proof upload	❌ System auto-deduction
Dimension	Main order + Sub-order	Trade + Order + Sub-order
Cancellation Limit	Cannot cancel after finance confirmation	Can cancel before shipment

Summary: The Taobao order system uses 10 main order statuses + 7 refund statuses, covering the complete lifecycle from order creation, finance confirmation, payment, shipping to after-sales. Compared to KA orders, Taobao orders add a finance confirmation process and independent refund status enum, better aligning with Taobao platform business characteristics.

Taobao-Order-EN.md

Taobao Order Fulfillment Flow: From Creation to After-Sales#

📋 Order Status Overview#

I. Main Order Status (TaoBaoOrderStatusEnum)#

II. Refund/After-Sales Status (RefundStatusEnum)#

🔄 Main Business Flows#

Flow 1: Normal Fulfillment (Success)#

Flow 2: Finance Rejection Flow#

Flow 3: Order Cancellation Flow#

Flow 4: Refund/After-Sales Flow ✨#

📊 Status Transition Rules#

Main Order Status Transitions#

Refund Status Transitions#

🔍 Customer-Facing Status Descriptions#

Fields Visible to Customers#

Main Order Status Mapping#

Refund Status Mapping#

⚠️ Important Rules#

1. Payment Lock Rules#

2. Refund Rules#

3. Finance Confirmation Rules#

4. Sub-Order Dimension#

🎯 Typical Business Scenarios#

Scenario 1: Normal Purchase#

Scenario 2: Finance Rejection#

Scenario 3: After-Sales Refund#

Scenario 4: Refund Refused#

📝 API Response Example#

📌 Status Flow Diagrams#

Main Order Flow#

Refund Status Flow#

✅ Checklist#

🆚 Comparison with KA Orders#