取消订单
POST https://{handle}.myshopline.com/admin/openapi/v20261201/orders/:id/cancel.json
handle :店铺的唯一标识符,值为店铺域名的前缀。例如,域名为 open001.myshopline.com 的店铺,其 handle 是 open001 。取消订单
路径参数
- id string required订单号例子:
"21050342939778451436179579"
请求头
- Content-Type string required字段值固定为
application/json; charset=utf-8。 - Authorization string required资源的访问令牌。参考 应用授权 获取访问令牌,然后将获取到的访问令牌以 Bearer 格式传入。例子:
Bearer eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJhcHBJZCI6MCwiYXBwS2V5IjoiNzU2ZjI1NWE2NjdlZTcwNTk1MzM0ZjVjYzk4NzU5MzBmN2E3NGZjMSIsImV4cCI6MTg3OTQ4MjA3NiwiaXNzIjoieXNvdWwiLCJzZWxsZXJJZCI6IjIwMDAyMzQ4ODAiLCJzdG9yZUlkIjoiMTY3MjM2OTcyOTYwNiIsInRpbWVzdGFtcCI6MTc4NDc4NzY3NjY2MSwidmVyc2lvbiI6IlYyIn0.3ZzbGAH4cLU1QR2VPEvMOQInUDvus-C4amkINSQIPuNVlXsFKj0sAt1c0KnUy9MWUOFV9cHlkf7J90r2y1FzpA
请求体
- email boolean是否发送邮件例子:
true - processed_at string取消订单实际发生时间例子:
2023-04-12T22:59:52+08:00 - refund_type string退款类型:
OriginalPayment Refund:原路退款Manual:手动标记退款
当支付渠道为Paypal,不传时默认值为:OriginalPayment Refund。其他支付渠道默认值:Manual。 - restock boolean库存是否回退 ture:库存回退 false和空字段为不回退库存例子:
true - amount double金额例子:
100 - cancel_reason string取消原因例子:
" don ' t want to buy " - currency string币种例子:
"CNY"
状态码
- 200
- 401
- 429
更多状态码信息,参考 HTTP 状态码。
响应头
traceId
请求的全局唯一标识符。用于追踪请求在系统中的流转,以便于问题发生时进行定位和调试。
响应体
orderobject
订单信息,字段描述、示例请参考订单列表响应结果current_subtotal_price_setobject
当前商品总和多币种信息, 买卖家币种和金额一致presentment_moneyobject
买家侧币种amount string金额例子:8.00currency_code string币种例子:USDshop_moneyobject
卖家侧金额amount string金额,精度2例子:8.00currency_code string币种code例子:USDcurrent_total_discounts_setobject
presentment_moneyobject
买家侧金额amount string金额例子:8.00currency_code string币种信息例子:USDshop_moneyobject
卖家侧金额amount string金额例子:8.00currency_code string币种例子:USDfinancial_status string支付状态,unpaid,authorized, pending,partially_paid,paid,partially_refunded,refunded例子:"paid"total_tip_received_setobject
小费,多币种信息presentment_moneyobject
买家侧币种信息amount string金额例子:8.00currency_code string币种例子:USDshop_moneyobject
卖家侧币种信息amount string金额例子:8.00currency_code string币种例子:USDcurrent_total_price string订单总额,以店铺币种金额展示。例子:8.00current_total_tax_setobject
税费总和多币种信息, 买卖家币种和金额一致presentment_moneyobject
买家侧币种amount string金额例子:8.00currency_code string币种例子:USDshop_moneyobject
卖家侧币种amount string金额例子:8.00currency_code string币种例子:USDdiscount_codesobject[]
优惠码信息code string优惠码例子:1Q3UMQM8RBP5type string优惠类型,减金额;打折;免运费;固定售价;最低价商品免费;打包价;第N件打折;例子:Reduction amountamount string优惠金额,精度2例子:8.00amount_setobject
优惠金额,多币种信息presentment_moneyobject
买家侧币种amount string金额例子:8.00currency_code string币种例子:USDshop_moneyobject
卖家侧币种amount string金额例子:8.00currency_code string币种例子:USDpayment_detailsobject[]
支付单信息order_seq string订单号例子:23057287797738260472676128pay_amount double支付金额例子:8.23pay_status string支付单状态, unpaid-未支付;pending-支付中;risking-风控中;paid-已支付;paid_overtime-支付失败;paid_failed-支付失败;例子:unpaidstatus_msg string支付单状态码描述例子:PENDING_REVIEWcreate_time string支付单创建时间(格式见IOS8601)例子:2012-05-01T14:22:25-04:00pay_channel_deal_id string外部渠道支付流水号例子:pi_3MI897Hezv8FxjBO1uGxMPhXpay_seq string支付单号例子:23057287797738260472676128processed_at string支付创建时间,格式:2023-04-12T22:59:52+08:00例子:2023-04-12T22:59:52+08:00status_code string支付状态码例子:RISK_PENDINGstore_id string店铺id例子:1644828244663tax_linesobject[]
税费信息rate double税率例子:1title string税费名称例子:taxesprice string税费金额,精度2例子:8.00price_setobject
税费多币种信息presentment_moneyobject
买家侧金额信息amount string金额例子:8.00currency_code string币种例子:USDshop_moneyobject
卖家侧金额信息amount string金额例子:8.00currency_code string币种例子:USDtax_number string税号例子:11111111taxes_included boolean总计额是否包含税额例子:truetotal_discounts string折扣总额,营销优惠+人工折扣例子:8.00current_subtotal_price string当前商品总和,商品总价*数量例子:8.00fulfillmentsobject[]
包裹信息created_at string创建时间(格式见IOS8601)例子:2012-05-01T14:22:25-04:00id string包裹编号例子:22046737798141702810214336order_id string订单号