POST /open/api/v1/after-sales
鉴权:接入方后台 HMAC
调用方:接入方后台
功能描述
同步一笔待审核售后,不会直接退款。未发货默认 refund_only,已发货默认 return_refund。同一渠道售后单号再次提交且内容一致时,返回原来的售后单。
参数
Object object
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
order_no | string | 否 | 小鹅订单号。与 partner_order_no 至少填一个。 | |
partner_order_no | string | 否 | 接入方订单号。与 order_no 至少填一个。 | |
order_item_id | number | 否 | 订单商品 ID。订单有多件商品时必填。 | |
partner_after_sale_no | string | 是 | 接入方售后单号,1 到 64 位,不含空白。 | |
after_sale_type | string | 否 | refund_only 或 return_refund。不填时按是否发货自动选择。 | |
refund_amount_cent | number | 是 | 退款金额,单位分,必须大于 0。 | |
feedback | string | 是 | 用户反馈,1 到 500 字。 | |
feedback_images | Array.<string> | 否 | 反馈图片,最多 6 张 https 地址。 |
返回值
成功时 code 为 0,下面的字段在 data 里。
Object data
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
after_sale_no | string | 是 | 小鹅售后单号。 | |
partner_after_sale_no | string | 是 | 接入方售后单号。 | |
order_no | string | 是 | 小鹅订单号。 | |
status | string | 是 | 售后状态。 | |
after_sale_type | string | 是 | 售后类型。 | |
refund_amount_cent | number | 是 | 退款金额,单位分。 |
示例代码
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": "未发货,申请退款"
}'