Cancel order archive
PUT https://{handle}.myshopline.com/admin/openapi/v20260301/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 eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw
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 listorder_status_url stringOrder status page URLExample:https://shoptest.myshoplinestg.com/trade/thank_you?mainOrderMark=xxx&mainOrderSeq=200565776406008509phone stringBuyer contact information, there must be one of the twoExample:12903001000currency stringTransaction currencyExample:USDcancel_reason stringSeller's reason for cancellationExample:" don ' t want to buy "total_weight doubleTotal product weight ( g )Example:100created_at stringOrder creation time (see IOS8601 for the format)Example:2012-05-01T14:22:25-04:00current_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 currencyamount stringAmountExample:8.00currency_code stringCurrencyExample:USDdiscount_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_amounttaxes_included booleanDoes the total include tax?current_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:USDtotal_tax stringSum of taxes, precision 2, commodity tax + shipping taxExample:8.00current_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:USDupdated_at stringOrder update 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:KIN4GNAB2FRHnote_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:Notestags stringorder labelExample:Tagclient_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:c2c4a58186b9d96395d7e6b5c2969577checkout_id stringDiscard idExample:2404785166526352972864deduct_member_point_amount stringCurrent order member point deduction amountExample:3.25checkout_token stringSettlement page tokenExample:c2c4a58186b9d96395d7e6b5c2969577browser_ip stringClient IPExample:157.119.232.35current_total_discounts_setobject
presentment_moneyobject
Currency informationamount stringAmountExample:3.25currency_code stringCurrency informationExample:USDshop_moneyobject
Sell side amountamount stringAmountExample:3.25currency_code stringCurrencyExample:USDuser_id stringBuyer IDExample:4201057495customerobject
Buyer informationemail stringUser mailboxExample:test001@Gmail.comfirst_name stringFirst nameExample:Tomlast_name stringLast nameExample:Washingtonaddressesobject
Buyer address informationlast_name stringFirst nameExample:Washingtonzip stringPostal codeExample:52134country_code stringCountry codeExample:USname stringFull nameExample:Tom Washingtoncountry stringCountryExample:Usafirst_name stringLast nameExample:Tomprovince stringProvinceExample:Californiaaddress2 stringDetailed address 2, optionalExample:Address 2city stringCityExample:New Yorkphone stringPhoneExample:13652133421province_code stringProvince codeExample:4300006address1 stringDetailed address 1Example:Address 1created_at stringBuyer creation time (see IOS8601 for the format)Example:2012-05-01T14:22:25-04:00id stringUser IDExample:4201057495area_code stringPhone area codeExample:+86phone stringUser mobile phone numberExample:19872121232updated_at stringBuyer update timeExample:2012-05-01T14:22:25-04:00currency stringCurrencyExample:USDtotal_outstanding stringSum of unpaid amount, precision 2Example: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:USDcurrent_subtotal_price stringSum of current products, total price of products * quantityExample:78.08cart_token stringShopping cart tokenExample:c2c4a58186b9d96395d7e6b5c2969577customer_locale stringBuyer country, language code + country name abbreviationExample:enCNemail stringBuyer's mailbox, there must be one of the twoExample:test1002@Gmail.comtax_type stringTypes of tax IDExample:typefulfillmentsobject[]
Package informationline_itemsobject[]
Product listname stringSKU title, same as titleExample:Product namegrams doubleWeight ( grams )Example:100product_id stringSPU serial numberExample:16056761559984840457934011fulfillment_service stringLogistics company nameExample:Sfrequires_shipping booleanShipping or notfulfillable_quantity integerAvailable quantityExample:1price stringCommodity price, precision 2Example:23.09attribute stringProduct attributes : name-attribute value multiple comma " , " division like : color-red , size-xExample:redfulfillment_status stringThe shipping status of the product, shipping status, fulfilled-shipped; partial-partially shipped; null-unshipped;Example:fulfilledtitle stringProduct titleExample:Beautiful skirtid 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 taxshop_moneyobject
Sell side amount informationamount stringAmountExample:3.25currency_code stringCurrencyExample:USDpresentment_moneyobject
Currency informationamount stringAmountExample:3.25currency_code stringCurrencyExample:USDrate doubleTax rateExample:1variant_id stringProduct SKU serial numberExample:18056761559987524812644011vendor stringSupplierExample:Suppliertaxable booleanTax or not?Example:truequantity integerQuantity of items in the orderExample:1sku stringProduct code, barCodeExample:18056761559987524812644011variant_title stringCommodity attribute value, multiple divided by " / ", such as: "155 / red / large"Example:bigshipment_status stringPackage trackingExample:fulfilledstatus stringLogistics delivery status, success-shipped; cancelled-cancelled;Example:cancelledtracking_company stringLogistics company nameExample:SF Internationalupdated_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:00id stringPackage numberExample:22046737798141702810214336name stringinvoice short numberExample:1032-F2tracking_number stringThird party tracking numberExample:yun0001tracking_url stringLogistics company URLExample:https://www.sf-international.com/total_discounts stringTotal discount, marketing discount + artificial discountExample:3.25billing_addressobject
billing addresscity stringBilling consignee city ( up to 64 characters )Example:New Yorkcountry_code stringBilling consignee national encodingExample:USname stringBilling nameExample:Tom Washingtonphone stringBill consignee name mobile phone numberExample:13890312312province stringBilling consignee name provinceExample:Californiafirst_name stringBilling consignee nameExample:Tomlast_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 companycountry stringBilling consignee country ( up to 64 characters )Example:Usazip stringBilling consignee name zipExample:521000current_total_tax stringTotal tax, product tax + shipping taxExample:8.00fulfillment_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:fulfilledprocessed_user_id stringorder creatorExample:4201057495shipping_linesobject[]
Logistics informationdiscounted_price stringDiscount amount, precision 2Example:8.00discounted_price_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:USDtax_linesobject[]
Logistics tax listprice_setobject
Multi-currency information of taxpresentment_moneyobject
Buyer side amount informationamount stringAmountExample:8.00currency_code stringCurrencyExample:USDshop_moneyobject
Sell side amount informationcurrency_code stringCurrencyExample:USDamount stringAmount, Precision 2Example:8.00rate doubleTax rateExample:1title stringTax nameExample:taxprice stringtaxExample:8.00title stringLogistics nameExample:SF Internationalcode stringLogistics numberExample:SFphone stringPhoneExample:13243214565requested_fulfillment_service_id stringTransportation service codeExample:LX88888shipping_price stringThe value of the original shipping fee (not the amount after the discount)Example:8.00discount_allocationsobject[]
Discount Detailsamount stringDiscount amount, precision 2Example:8.00amount_setobject
Discount Multi-Currency Amountpresentment_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:USDdiscount_application_index integerDiscount index information : marked in the position of the discount detailsExample:1price stringLogistics freight, precision 2Example:8.00price_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:USDsource stringShipping sourceExample:sourcepayment_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"]cancelled_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.00total_line_items_price stringSum of original prices of goods, precision 2Example:8.00refundsobject[]
Refund listtransactionsobject[]
Refund transaction informationcreated_at stringCreation timeExample:2012-05-01T14:22:25-04:00currency stringCurrencyExample:USDid stringRefund IDExample:2605659027312156877634kind stringTransaction type (authorization, capture, sale, void, refund)Example:authorizationstatus stringHandling status, pending, failure, success, and errorExample:pendingamount 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:4201057495user_id stringUser IDExample:4201057495created_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:2605659027312156877634subtotal 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:302quantity 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:USDtotal_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.25line_itemobject
Refund Product linevariant_title stringCommodity attribute value, multiple divided by " / ", such as: "155 / red / large"Example:bigfulfillment_service stringLogistics company nameExample:Sftitle stringProduct titleExample:Beautiful skirtrequires_shipping booleanShipping or notExample:truesku stringProduct code, barCodeExample:18056761559987524812644011tax_linesobject[]
Tax informationprice_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:taxprice stringTax, precision 2Example:3.25variant_id stringProduct SKU serial numberExample:18056761559987524812644011name stringSKU title, same as titleExample:test-002product_id stringSPU serial numberExample:16056761559984840457934011quantity integerQuantity of items in the orderExample:2taxable booleanTax or not?Example:truevendor stringSupplierExample:Suppliergrams doubleWeight ( grams )Example:100attribute stringProduct attributes : name-attribute value multiple comma " , " division like : color-red , size-xExample:redfulfillment_status stringThe shipping status of the product, shipping status, fulfilled-shipped; partial-partially shipped; null-unshipped;Example:fulfilledfulfillable_quantity integerAvailable quantityExample:2id 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.25total_tax doubleTax amount of refunded goods, precision 2total_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:USDtotal_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:USDpresentment_currency stringBuy side currency, same as sell side currencyExample:USDcurrent_total_discounts stringSum of discounts, precision 2, marketing offers + artificial discountsExample:3.25line_itemsobject[]
Order product snapshot informationrequires_shipping booleanShipping or notExample:truediscount_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:16056761559984840457934011variant_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 titlegrams doubleWeight ( grams )Example:100quantity integerQuantity of items in the orderExample:2title stringProduct titleExample:Nice looking skirtsku stringProduct code, barCodeExample:18056761559987524812644011location_id stringThe location corresponding to the store in the pos sceneExample:5327026538935748524attribute stringProduct attributes : name-attribute value multiple comma " , " division like : color-red , size-xExample:redfulfillment_status stringThe shipping status of the product, shipping status, fulfilled-shipped; partial-partially shipped; null-unshipped;Example:fulfilledtags stringCommodity tags (separated by multiple commas)Example:Tag 1 , cutefulfillable_quantity integerAvailable quantityExample:1taxable booleanTax or not?Example:truevendor stringSupplierExample:Supplierprice stringCommodity price, precision 2Example:3.25propertiesobject[]
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:Sftax_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:taxname stringCustom order numberExample:test1001subtotal_price_setobject
Multi-currency information of total product price after discountpresentment_moneyobject
Buyer side amount informationamount stringAmount, Precision 2Example:3.25currency_code stringCurrencyExample:USDshop_moneyobject
Sell side amount informationamount stringAmount, Precision 2Example:3.25currency_code stringCurrencyExample:USDshipping_addressobject
Shipping addressprovince stringProvinceExample:Californiaaddress1 stringAddress 1Example:Address 1address2 stringDetailed address 2, optionalExample:Address 2country stringCountryExample:Usafirst_name stringLast nameExample:Tomcity stringCityExample:New Yorkname stringFull nameExample:Tom Washingtoncompany stringCompany nameExample:New company namecountry_code stringCountry codeExample:USlast_name stringFirst nameExample:Washingtonphone stringPhoneExample:1320987655latitude stringLatitudeExample:15longitude stringLongitudeExample:41province_code stringProvince codeExample:4200006zip stringPostal codeExample:92503total_tip_received stringTip, precision 2Example:8.00store_id stringstore IDExample:1644828244663app_id stringApp IDExample:222222tax_number stringTINExample:111111payment_detailsobject[]
Payment slip informationstatus_msg stringPayment order status code descriptionExample:PENDING_REVIEWpay_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:unpaidcreate_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:00pay_seq stringPayment slip numberExample:23057287797738260472676128status_code stringpayment status codeExample:RISK_PENDINGid stringOrder number , system customization numberExample:21050224312121887324667162note stringMerchant notesExample:Notestotal_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:unpaidsubtotal_price stringTotal product price after discount, total product price - marketing discount - artificial discountExample:3.25user_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?