What are the rules for orders and tracking numbers?

Currently, orders cannot be split or merged. Multiple orders can share the same tracking number. And A single order can have multiple packages, each with its own tracking number.

What is the logic behind the total_price field?

Taxes: total_price represents the final amount paid by the customer, including taxes if applicable.

Additional Fees: total_price includes extra charges like additional_total, total_shipping, total_tax, shipping_tax_total, and tips (total_tip_received).

Formula:

📘

Field Explanation

sub_total: Total price of products.

total_shipping: Total shipping fees.

additional_total: Additional charges.

total_tax: Total product tax.

shipping_tax_total: Total shipping tax.

total_tip_received: Total tips received.

total_discount: Total discounts (e.g., product and code discounts).

If sub_total is tax-exclusive (order.config.product_tax_included == false):

total_price = (sub_total + total_shipping + additional_total + total_tax + shipping_tax_total + total_tip_received) - total_discount

If sub_total is tax-inclusive (order.config.product_tax_included == true):

total_price = (sub_total + total_shipping + additional_total + shipping_tax_total + total_tip_received) - total_discount

PayPal Payments: total_price reflects the amount the customer pays, excluding any PayPal transaction fees, which are handled separately by the platform.

What is the purpose of the buyer_accepts_marketing field?

The buyer_accepts_marketing field indicates whether a customer consents to receive marketing promotions:

• Accepted: Merchants can send promotional emails or discount offers.
• Not Accepted: Customers are excluded from marketing campaigns.
  This field does not directly affect the order list or its information.

Does the customer.orders_count field include canceled or unpaid orders?

orders_count includes all orders created by the customer in the current store, regardless of their status (e.g., canceled or unpaid).

Can a customer use different currencies for payments in the same store?

Yes, stores can support multi-currency payments. All payments are converted into the store's primary market currency for consistency.

I created an order via API, but why can't I see it in the shop admin dashboard?​

This is typically because the order lacks a shipping address. The admin dashboard filters out and does not display orders considered "invalid" due to missing address information. However, these orders may still be retrievable via the API.

Why does the id of a line item in an order response change between API calls?​

The line item id for an ​​unpaid (incomplete) order​​ might not be persistent. Once the order is successfully paid for, the line item IDs will become stable and remain unchanged in subsequent API queries.

Why does the create order API return record not found

When you receive this error from the create order API, please check the following steps:

• Verify that the Product ID, Variant ID, and other related parameters are correct.
• If all IDs are confirmed to be accurate but the request still fails, check whether the store has configured at least one payment channel.
• The store must have at least one payment method enabled; otherwise, the order creation will fail with a “record not found” error.