Cancel order archive
PUT https://{handle}.myshopline.com/admin/openapi/v20261201/orders/:id/cancel_hide_mark.json
handle : The store's unique identifier, which is the prefix of the store's domain name. For example, if a store's domain name is open001.myshopline.com , the store handle is open001 .Opens a closed order.
Path Parameters
- id string requiredOrder numberExample:
21050342939778451436179579
Request Headers
- Content-Type string requiredThe field must be set to the fixed value
application/json; charset=utf-8. - Authorization string requiredThe access token for the API resource. Refer to App authorization to obtain the access token, and then pass the obtained token in the Bearer format.Example:
Bearer eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJhcHBJZCI6MCwiYXBwS2V5IjoiNzU2ZjI1NWE2NjdlZTcwNTk1MzM0ZjVjYzk4NzU5MzBmN2E3NGZjMSIsImV4cCI6MTg3OTQ4MjA3NiwiaXNzIjoieXNvdWwiLCJzZWxsZXJJZCI6IjIwMDAyMzQ4ODAiLCJzdG9yZUlkIjoiMTY3MjM2OTcyOTYwNiIsInRpbWVzdGFtcCI6MTc4NDc4NzY3NjY2MSwidmVyc2lvbiI6IlYyIn0.3ZzbGAH4cLU1QR2VPEvMOQInUDvus-C4amkINSQIPuNVlXsFKj0sAt1c0KnUy9MWUOFV9cHlkf7J90r2y1FzpA
Status Codes
- 200
- 401
- 429
For the complete list of codes and messages, see Http status code.
Response Headers
traceId
A globally unique identifier for the request. It is used to track the request flow throughout the system, allowing for easy location and debugging when issues arise.
Response Body
orderobject
For order information, field descriptions and examples, please refer to the response result of the order listline_itemsobject[]
Order product snapshot informationquantity integerQuantity of items in the orderExample:2location_id stringThe location corresponding to the store in the pos sceneExample:5327026538935748524fulfillment_status stringThe shipping status of the product, shipping status, fulfilled-shipped; partial-partially shipped; null-unshipped;Example:fulfilledtaxable booleanTax or not?Example:trueprice stringCommodity price, precision 2Example:3.25discount_allocationsobject[]
Marketing discount detail amount multi-currencyamount_setobject
Discount Details Amount Multi-Currencyshop_moneyobject
Store currencyamount stringAmount, Precision 2Example:8.00currency_code stringCurrencyExample:USDpresentment_moneyobject
payment currencyamount stringAmount, Precision 2Example:8.00currency_code stringCurrencyExample:USDdiscount_application_index integerIndicate the location in the discount detailsExample:1amount stringDiscount detail amountExample:8.00variant_title stringCommodity attribute value, multiple divided by " / ", such as: "155 / red / large"Example:bigproduct_id stringSPU serial numberExample:16056761559984840457934011fulfillable_quantity integerAvailable quantityExample:1propertiesobject[]
Product customization informationname stringCustom attribute nameExample:Attribute nametype stringAttribute type, text-character, the display format is name: value; picture-picture, the display type is name: get the rendered thumbnail through URLs; link-hyperlink, the display type is name: value, supports clicking on the link to jump to urls FirstExample:texturls arrayURL resource listExample:["https://www.url.com"]value stringCustom attribute valuesExample:Attribute valueadditional stringAdditional Fields for Custom ItemsExample:Additional fieldtax_linesobject[]
Tax informationtitle stringTax nameExample:taxtype stringTax fee type, used to distinguish whether it is commodity tax or freight tax, the enumerated values are as follows product_tax: commodity tax shipping_tax: freight taxExample:shipping_taxprice stringTax, precision 2Example:3.25price_setobject
Multi-currency information of taxpresentment_moneyobject
Buy side currencycurrency_code stringCurrencyExample:USDamount stringAmountExample:3.25shop_moneyobject
Sell side currencyamount stringAmountExample:3.25currency_code stringCurrencyExample:USDrate doubleTax rateExample:1fulfillment_service stringLogistics company nameExample:Sfrequires_shipping booleanShipping or notExample:truegrams doubleWeight ( grams )Example:100sku stringProduct code, barCodeExample:18056761559987524812644011tags stringCommodity tags (separated by multiple commas)Example:Tag 1 , cutevendor stringSupplierExample:Suppliertitle stringProduct titleExample:Nice looking skirtattribute stringProduct attributes : name-attribute value multiple comma " , " division like : color-red , size-xExample:redvariant_id stringProduct SKU serial numberExample:18056761559987524812644011id stringThe ID of the product snapshot table, generated by the system, uniquely confirms a product with the order numberExample:417name stringSKU title, same as titleExample:Product titletotal_weight doubleTotal product weight ( g )Example:100client_detailsobject
Client Detailsuser_agent stringClient ProxyExample:Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/106.0.0.0 Sabrowser_ip stringClient ip addressExample:157.119.232.35session_hash stringMember session encryption informationExample:c2c4a58186b9d96395d7e6b5c2969577cancelled_at stringOrder cancellation time (end) (see IOS8601 for the format), 2012-05-01T14:22:25-04:00Example:2012-05-01T14:22:25-04:00current_total_price stringTotal tax, product tax + shipping taxExample:8.00app_id stringApp IDExample:222222order_status_url stringOrder status page URLExample:https://shoptest.myshoplinestg.com/trade/thank_you?mainOrderMark=xxx&mainOrderSeq=200565776406008509discount_applicationsobject[]
Discount informationallocation_method string1 ) across ( the value is distributed in all authorized lines ) 2 ) the ach ( the value is applied to each authorized line )Example:acrossvalue stringThe specific value of the discount ( it can be n-fold , or it can be the specific amount value )Example:20code stringDiscount codeExample:1Q3UMQM8RBP5title stringautomatic discount titleExample:Discount titletype stringDiscount typeExample:manualdescription stringDescription of custom discountExample:Discount descriptiontarget_type string1)line_item、shipping_lineExample:line_itemtarget_selection string1 ) explicit ( discount distribution to clear selection ) 2 ) all ( discount distribution to all lines ) 3 ) ENTITLED ( discount distribution only to the line that its right to use )Example:explicitvalue_type string% discount , amount discountExample:fixed_amountshipping_addressobject
Shipping addressaddress2 stringDetailed address 2, optionalExample:Address 2name stringFull nameExample:Tom Washingtoncountry_code stringCountry codeExample:USlast_name stringFirst nameExample:Washingtonphone stringPhoneExample:1320987655province stringProvinceExample:Californiaaddress1 stringAddress 1Example:Address 1company stringCompany nameExample:New company namelatitude stringLatitudeExample:15zip stringPostal codeExample:92503country stringCountryExample:Usafirst_name stringLast nameExample:Tomcity stringCityExample:New Yorklongitude stringLongitudeExample:41province_code stringProvince codeExample:4200006tax_number stringTINExample:111111total_tax stringSum of taxes, precision 2, commodity tax + shipping taxExample:8.00note_attributesobject[]
Merchant note log, date contentcreate_time stringRemark creation time (see IOS8601 for the format)Example:2012-05-01T14:22:25-04:00name stringRemark source (seller ID)Example:Notes sourcevalue stringNotesExample:Notescurrent_subtotal_price stringSum of current products, total price of products * quantityExample:78.08total_line_items_price stringSum of original prices of goods, precision 2Example:8.00total_shipping_price_setobject
Order shipping sum, multi-currency informationpresentment_moneyobject
Buyer side amount informationamount stringAmount, Precision 2Example:8.00currency_code stringCurrencyExample:USDshop_moneyobject
Sell side amount informationamount stringAmount, Precision 2Example:8.00currency_code stringCurrencyExample:USDsubtotal_price_setobject
Multi-currency information of total product price after discountshop_moneyobject
Sell side amount informationamount stringAmount, Precision 2Example:3.25currency_code stringCurrencyExample:USDpresentment_moneyobject
Buyer side amount informationamount stringAmount, Precision 2Example:3.25currency_code stringCurrencyExample:USDnote stringMerchant notesExample:Notessubtotal_price stringTotal product price after discount, total product price - marketing discount - artificial discountExample:3.25current_total_price_setobject
Multi-currency information of the sum of taxes, the currency and amount of buyers and sellers are the samepresentment_moneyobject
Buy side currencyamount stringAmountExample:8.00currency_code stringCurrencyExample:USDshop_moneyobject
Sell side currencyamount stringAmountExample:8.00currency_code stringCurrencyExample:USDprocessed_user_id stringorder creatorExample:4201057495total_tip_received stringTip, precision 2Example:8.00current_total_discounts_setobject
presentment_moneyobject
Currency informationamount stringAmountExample:3.25currency_code stringCurrency informationExample:USDshop_moneyobject
Sell side amountamount stringAmountExample:3.25currency_code stringCurrencyExample:USDtotal_outstanding stringSum of unpaid amount, precision 2Example:8.00email stringBuyer's mailbox, there must be one of the twoExample:test1002@Gmail.comfulfillmentsobject[]
Package informationline_itemsobject[]
Product listvariant_title stringCommodity attribute value, multiple divided by " / ", such as: "155 / red / large"Example:bigrequires_shipping booleanShipping or notfulfillable_quantity integerAvailable quantityExample:1fulfillment_status stringThe shipping status of the product, shipping status, fulfilled-shipped; partial-partially shipped; null-unshipped;Example:fulfilledtitle stringProduct titleExample:Beautiful skirtvariant_id stringProduct SKU serial numberExample:18056761559987524812644011taxable booleanTax or not?Example:truename stringSKU title, same as titleExample:Product nameprice stringCommodity price, precision 2Example:23.09quantity integerQuantity of items in the orderExample:1attribute stringProduct attributes : name-attribute value multiple comma " , " division like : color-red , size-xExample:redvendor stringSupplierExample:Suppliersku stringProduct code, barCodeExample:18056761559987524812644011grams doubleWeight ( grams )Example:100product_id stringSPU serial numberExample:16056761559984840457934011fulfillment_service stringLogistics company nameExample:Sfid stringThe ID of the product snapshot table, generated by the system, uniquely confirms a product with the order numberExample:312tax_linesobject[]
Tax informationtitle stringTax nameExample:taxprice stringTax, precision 2Example:3.25price_setobject
Multi-currency information of taxpresentment_moneyobject
Currency informationamount stringAmountExample:3.25currency_code stringCurrencyExample:USDshop_moneyobject
Sell side amount informationamount stringAmountExample:3.25currency_code stringCurrencyExample:USDrate doubleTax rateExample:1shipment_status stringPackage trackingExample:fulfilledtracking_company stringLogistics company nameExample:SF Internationalid stringPackage numberExample:22046737798141702810214336name stringinvoice short numberExample:1032-F2tracking_number stringThird party tracking numberExample:yun0001tracking_url stringLogistics company URLExample:https://www.sf-international.com/status stringLogistics delivery status, success-shipped; cancelled-cancelled;Example:cancelledupdated_at stringUpdate time (see IOS8601 for the format)Example:2012-05-01T14:22:25-04:00order_id stringOrder numberExample:21056577640603870897253153created_at stringCreation time (see IOS8601 for the format)Example:2012-05-01T14:22:25-04:00refundsobject[]
Refund listcreated_at stringRefund form creation time (see IOS8601 for the format)Example:2012-05-01T14:22:25-04:00id stringRefund IDExample:2605659027312156877634note stringRefund NotesExample:Refund Notesorder_id stringOrder numberExample:21056577640603870897253153processed_at stringUpdate time (see IOS8601 for the format)Example:2012-05-02T14:22:25-04:00refund_line_itemsobject[]
Refund Detailsid stringOrder number for this adjustment of the single linkExample:2605659027312156877634quantity integerQuantity, quantity of goodsExample:2restock_type stringInventory return type, no_restock-not returned, cancel-cancelled, return-returned only not returnedExample:no_restocksubtotal_setobject
Total refund amount, multi-currency information, same on seller and buyer sidepresentment_moneyobject
Buy side currencyamount stringAmountExample:3.25currency_code stringCurrencyExample:USDshop_moneyobject
Sell side amount informationamount stringAmount, Precision 2Example:3.25currency_code stringCurrencyExample:USDline_itemobject
Refund Product lineproduct_id stringSPU serial numberExample:16056761559984840457934011grams doubleWeight ( grams )Example:100attribute stringProduct attributes : name-attribute value multiple comma " , " division like : color-red , size-xExample:redfulfillment_service stringLogistics company nameExample:Sfrequires_shipping booleanShipping or notExample:truesku stringProduct code, barCodeExample:18056761559987524812644011variant_id stringProduct SKU serial numberExample:18056761559987524812644011id stringThe ID of the product snapshot table, generated by the system, uniquely confirms a product with the order numberExample:312price stringCommodity price, precision 2Example:3.25variant_title stringCommodity attribute value, multiple divided by " / ", such as: "155 / red / large"Example:bigname stringSKU title, same as titleExample:test-002quantity integerQuantity of items in the orderExample:2fulfillment_status stringThe shipping status of the product, shipping status, fulfilled-shipped; partial-partially shipped; null-unshipped;Example:fulfilledtitle stringProduct titleExample:Beautiful skirttax_linesobject[]
Tax informationprice stringTax, precision 2Example:3.25price_setobject
Multi-currency information of taxpresentment_moneyobject
Buy side currencyamount stringAmount, Precision 2Example:3.25currency_code stringCurrencyExample:USDshop_moneyobject
Sell side amount informationamount stringAmountExample:3.25currency_code stringCurrencyExample:USDrate doubleTax rateExample:1title stringTax titleExample:taxtaxable booleanTax or not?Example:truevendor stringSupplierExample:Supplierfulfillable_quantity integerAvailable quantityExample:2subtotal doubleTotal refund amount, precision 2Example:3.25line_item_id stringThe ID of the product snapshot table, generated by the system, uniquely confirms a product with the order numberExample:302total_tax_setobject
Total tax amount, multi-currency informationpresentment_moneyobject
Buy side currencyamount stringAmountExample:3.25currency_code stringCurrencyExample:USDshop_moneyobject
Sell side currencycurrency_code stringCurrencyExample:USDamount stringAmountExample:3.25total_tax doubleTax amount of refunded goods, precision 2transactionsobject[]
Refund transaction informationamount stringRefund amount , accuracy 2Example:3.25order_id stringOrder numberExample:21056577640603870897253153processed_at stringRefund order update time ( format see IOS8601 )Example:2012-05-01T14:22:25-04:00user_id stringBuyer IDExample:4201057495currency stringCurrencyExample:USDid stringRefund IDExample:2605659027312156877634status stringHandling status, pending, failure, success, and errorExample:pendingcreated_at stringCreation timeExample:2012-05-01T14:22:25-04:00kind stringTransaction type (authorization, capture, sale, void, refund)Example:authorizationuser_id stringUser IDExample:4201057495total_line_items_price_setobject
Sum of original price of goods, multi-currency informationshop_moneyobject
Sell side amount informationamount stringAmount, Precision 2Example:8.00currency_code stringCurrencyExample:USDpresentment_moneyobject
Buyer side amount informationamount stringAmount, Precision 2Example:8.00currency_code stringCurrencyExample:USDprocessed_at stringProcessed_at time , format : 2023-04-12T22 : 59 : 52+08 : 00Example:2023-04-12T22:59:52+08:00financial_status stringPayment status , un pad , authorized , pending , partially_paid , pad , partially_refunded , refundedExample:unpaidtax_type stringTypes of tax IDExample:typepayment_gateway_names arrayList of payment methods, list of payment methods used for this order, SLpayments, Paypal (PayPal payment), Oceanpay (Oceanpayment), TwoCheckout, AsiaBill, Stripe, Pacypay, WorldPay, COD (cash on delivery), CUSTOM (custom), adjustPay (funding adjustment), Xendit (xendit credit card), XenditOtherExample:["PayPal"]name stringCustom order numberExample:test1001currency stringTransaction currencyExample:USDupdated_at stringOrder update time, (see IOS8601 for the format)Example:2012-05-01T14:22:25-04:00shipping_linesobject[]
Logistics informationrequested_fulfillment_service_id stringTransportation service codeExample:LX88888shipping_price stringThe value of the original shipping fee (not the amount after the discount)Example:8.00price stringLogistics freight, precision 2Example:8.00source stringShipping sourceExample:sourcetax_linesobject[]
Logistics tax listrate doubleTax rateExample:1title stringTax nameExample:taxprice stringtaxExample:8.00price_setobject
Multi-currency information of taxpresentment_moneyobject
Buyer side amount informationcurrency_code stringCurrencyExample:USDamount stringAmountExample:8.00shop_moneyobject
Sell side amount informationcurrency_code stringCurrencyExample:USDamount stringAmount, Precision 2Example:8.00code stringLogistics numberExample:SFdiscount_allocationsobject[]
Discount Detailsamount stringDiscount amount, precision 2Example:8.00amount_setobject
Discount Multi-Currency Amountshop_moneyobject
Amount information on the store sidecurrency_code stringCurrencyExample:USDamount stringAmount, Precision 2Example:8.00presentment_moneyobject
Buyer side amount informationamount stringAmount, Precision 2Example:8.00currency_code stringCurrencyExample:USDdiscount_application_index integerDiscount index information : marked in the position of the discount detailsExample:1price_setobject
Logistics freight multi-resource informationpresentment_moneyobject
Buyer side amount informationamount stringAmount, Precision 2Example:8.00currency_code stringCurrencyExample:USDshop_moneyobject
Amount information on the store sideamount stringAmount, Precision 2Example:8.00currency_code stringCurrencyExample:USDdiscounted_price stringDiscount amount, precision 2Example:8.00discounted_price_setobject
Discount Multi-Currency Amountshop_moneyobject
Amount information on the store sideamount stringAmount, Precision 2Example:8.00currency_code stringCurrencyExample:USDpresentment_moneyobject
Buyer side amount informationamount stringAmount, Precision 2Example:8.00currency_code stringCurrencyExample:USDtitle stringLogistics nameExample:SF Internationalphone stringPhoneExample:13243214565current_subtotal_price_setobject
Multi-currency information of the current commodity sum, the buyer's and seller's currency and the amount are the sameshop_moneyobject
Sell side amountamount stringAmount, Precision 2Example:78.08currency_code stringCurrency codeExample:USDpresentment_moneyobject
Buy side currencyamount stringAmountExample:78.08currency_code stringCurrencyExample:USDpresentment_currency stringBuy side currency, same as sell side currencyExample:USDtaxes_included booleanDoes the total include tax?checkout_token stringSettlement page tokenExample:c2c4a58186b9d96395d7e6b5c2969577fulfillment_status stringShipping status, fulfilled-shipped; partial-partially shipped; null-unshipped; Note: the returned enum value is different from the query enumeration value of the input parameterExample:fulfilledcurrent_total_discounts stringSum of discounts, precision 2, marketing offers + artificial discountsExample:3.25tags stringorder labelExample:Tagcart_token stringShopping cart tokenExample:c2c4a58186b9d96395d7e6b5c2969577customer_locale stringBuyer country, language code + country name abbreviationExample:enCNpayment_detailsobject[]
Payment slip informationstatus_msg stringPayment order status code descriptionExample:PENDING_REVIEWcreate_time stringPayment slip creation timeExample:2012-05-01T14:22:25-04:00order_seq stringOrder numberExample:23057287797738260472676128pay_channel_deal_id stringExternal channel payment serial numberExample:pi_3MI897Hezv8FxjBO1uGxMPhXprocessed_at stringPayment creation time , format : 2023-04-12T22 : 59 : 52+08 : 00Example:2023-04-12T22:59:52+08:00status_code stringpayment status codeExample:RISK_PENDINGpay_amount doublePayment amountExample:3.25pay_status stringPayment slip status , unpaid- not paid ; pending- paying ; risking- wind control ; paid-paid ; paid_overtime- payment failed ; paid_failed- payment failure ;Example:unpaidpay_seq stringPayment slip numberExample:23057287797738260472676128current_total_tax_setobject
Multi-currency information of the sum of taxes, the currency and amount of buyers and sellers are the sameshop_moneyobject
Sell side currencyamount stringAmountExample:8.00currency_code stringCurrencyExample:USDpresentment_moneyobject
Buy side currencycurrency_code stringCurrencyExample:USDamount stringAmountExample:8.00total_discounts_setobject
Multi-currency information of discount totalpresentment_moneyobject
Buyer side amount informationcurrency_code stringCurrencyExample:USDamount stringAmount, Precision 2Example:3.25shop_moneyobject
Sell side amount informationamount stringAmount, Precision 2Example:3.25currency_code stringCurrencyExample:USDbilling_addressobject
billing addresscity stringBilling consignee city ( up to 64 characters )Example:New Yorkphone stringBill consignee name mobile phone numberExample:13890312312province stringBilling consignee name provinceExample:Californiafirst_name stringBilling consignee nameExample:Tomcountry stringBilling consignee country ( up to 64 characters )Example:Usacountry_code stringBilling consignee national encodingExample:USname stringBilling nameExample:Tom Washingtonlast_name stringBill consignee last nameExample:Washingtonaddress2 stringBill consignee additional to detailed address ( up to 255 characters )Example:Address 2province_code stringBilling consignee name province encodingExample:4300006address1 stringBilling consignee detailed address ( up to 255 characters )Example:Address 1company stringCompany nameExample:new companyzip stringBilling consignee name zipExample:521000store_id stringstore IDExample:1644828244663created_at stringOrder creation time (see IOS8601 for the format)Example:2012-05-01T14:22:25-04:00discount_codesobject[]
Promo code informationtype stringType of discount, reduced amount; discount; free shipping; fixed price; the lowest price item is free; package price; the Nth item is discounted;Example:deduction amountamount stringDiscount amount, precision 2Example:3.25code stringPromo codeExample:KIN4GNAB2FRHcheckout_id stringDiscard idExample:2404785166526352972864deduct_member_point_amount stringCurrent order member point deduction amountExample:3.25browser_ip stringClient IPExample:157.119.232.35current_total_tax stringTotal tax, product tax + shipping taxExample:8.00tax_linesobject[]
Tax informationprice stringTax amountExample:3.25price_setobject
Multi-currency information of taxpresentment_moneyobject
Buyer side amount informationcurrency_code stringCurrencyamount stringAmount, Precision 2Example:USDshop_moneyobject
Sell side amount informationamount stringAmount, Precision 2Example:3.25currency_code stringCurrencyExample:USDrate doubleTax rateExample:1title stringTax nameExample:taxcustomerobject
Buyer informationphone stringUser mobile phone numberExample:19872121232updated_at stringBuyer update timeExample:2012-05-01T14:22:25-04:00email stringUser mailboxExample:test001@Gmail.comlast_name stringLast nameExample:Washingtonaddressesobject
Buyer address informationcity stringCityExample:New Yorkprovince_code stringProvince codeExample:4300006address1 stringDetailed address 1Example:Address 1last_name stringFirst nameExample:Washingtoncountry_code stringCountry codeExample:USname stringFull nameExample:Tom Washingtoncountry stringCountryExample:Usafirst_name stringLast nameExample:Tomprovince stringProvinceExample:Californiaaddress2 stringDetailed address 2, optionalExample:Address 2phone stringPhoneExample:13652133421zip stringPostal codeExample:52134created_at stringBuyer creation time (see IOS8601 for the format)Example:2012-05-01T14:22:25-04:00currency stringCurrencyExample:USDfirst_name stringFirst nameExample:Tomid stringUser IDExample:4201057495area_code stringPhone area codeExample:+86total_discounts stringTotal discount, marketing discount + artificial discountExample:3.25total_tax_setobject
Tax summation, multi-currency informationpresentment_moneyobject
Buyer side amount informationamount stringAmount, Precision 2Example:8.00currency_code stringCurrencyExample:USDshop_moneyobject
Sell side amount informationamount stringAmount, Precision 2Example:8.00currency_code stringCurrencyExample:USDid stringOrder number , system customization numberExample:21050224312121887324667162phone stringBuyer contact information, there must be one of the twoExample:12903001000cancel_reason stringSeller's reason for cancellationExample:" don ' t want to buy "user_id stringBuyer IDExample:4201057495user_errorsobject[]
Error prompt information in this execution , if the implementation result is wrong , this field will return error informationcode stringWrong codeExample:illegal paramfield arrayPath that causes incorrect input fieldsExample:[""]message stringError message
API Explorer
Debugger
Was this article helpful to you?