POST /open/api/v1/after-sales

鉴权:接入方后台 HMAC

调用方:接入方后台

功能描述

同步一笔待审核售后,不会直接退款。未发货默认 refund_only,已发货默认 return_refund。同一渠道售后单号再次提交且内容一致时,返回原来的售后单。

参数

Object object

属性类型默认值必填说明
order_nostring否小鹅订单号。与 partner_order_no 至少填一个。
partner_order_nostring否接入方订单号。与 order_no 至少填一个。
order_item_idnumber否订单商品 ID。订单有多件商品时必填。
partner_after_sale_nostring是接入方售后单号,1 到 64 位,不含空白。
after_sale_typestring否refund_only 或 return_refund。不填时按是否发货自动选择。
refund_amount_centnumber是退款金额,单位分,必须大于 0。
feedbackstring是用户反馈,1 到 500 字。
feedback_imagesArray.<string>否反馈图片,最多 6 张 https 地址。

返回值

成功时 code 为 0,下面的字段在 data 里。

Object data

属性类型默认值必填说明
after_sale_nostring是小鹅售后单号。
partner_after_sale_nostring是接入方售后单号。
order_nostring是小鹅订单号。
statusstring是售后状态。
after_sale_typestring是售后类型。
refund_amount_centnumber是退款金额,单位分。

示例代码

curlbash
# 先设置 CHANNEL_ACCESS_KEY、CHANNEL_SECRET_KEY,并按接口说明计算 signature
curl --request POST 'https://api.channel.suiinn.com/open/api/v1/after-sales' \
  --header 'X-Channel-Key: $CHANNEL_ACCESS_KEY' \
  --header 'X-Channel-Timestamp: $timestamp' \
  --header 'X-Channel-Nonce: $nonce' \
  --header 'X-Channel-Signature: $signature' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "order_no": "YD202601010001",
  "partner_after_sale_no": "AS001",
  "after_sale_type": "refund_only",
  "refund_amount_cent": 9900,
  "feedback": "未发货,申请退款"
}'