支持第三方调用
支持沙箱环境调用
禁止个人开发者调用
关于售后价格计算 1、售后单价格 refund_price = 所有商品 price 价格总和 + 运费 + 附件费和 2、对同一订单可以多次发起售后,但所有售后单的总价格,必须小于原订单支付价格 3、售后单必须存在商品,运费、附加费等费用,可以随商品进行退款 4、单个商品的退款价格之和不得超过原订单该商品的实付之和
公共请求参数
名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| app_id | string | 是 | 小程序appid |
| access_token | string | 是 | 小程序调用凭证 |
业务请求参数
名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| out_order_id | string | 否 | 外部订单id(担保支付下日历商品保持与book_id一致) |
| out_after_sales_order_id | string | 是 | 外部售后单id |
| open_id | string | 是 | 用户id |
| type | int32 | 是 | 售后类型:1:退款,2:退款退货 |
| reason | string | 否 | 售后原因 |
| biz_create_time | int64 | 是 | 售后单创建时间,时间戳到秒 |
price_info | struct | 是 | 售后单-退款价格信息 |
refund_price | int64 | 是 | 售后单-退款总价,单位到(分) |
freight_price | int64 | 否 | 售后单-退运费价格,单位到(分) |
extra_price_infos | list_struct | 否 | 售后单-退附加费信息 |
name | string | 是 | 退附加费名称 |
price | int64 | 是 | 退附加费,该项附加费退费之和,单位(分) |
num | int32 | 是 | 退附加费数量,必须大于0 |
product_infos | list_struct | 是 | 售后单商品信息 |
out_product_id | string | 是 | 外部商品id |
out_sku_id | string | 是 | 外部sku商品id |
num | int32 | 是 | 退货数量,必须大于0 |
price | int64 | 是 | 退商品价格,该商品退货价格之和,单位(分) |
refund_voucher_detail | list_struct | 否 | 退款的凭证信息,支持预售券和团购券,注意和refund_book_detail不能同时传 |
voucher_code | string | 是 | 凭证ID |
refund_price | int64 | 是 | 退款价格,单位到(分) |
refund_book_detail | list_struct | 否 | 退款的预约单信息,支持日历商品的预约订单和预售券的预约单,注意和refund_voucher_detail不能同时传 |
book_id | string | 是 | 小红书侧预约单订单ID |
refund_price | int64 | 是 | 退款价格,单位到(分) |
| product_type | int32 | 否 | 本地商品类型,1=团购券,2=预售券,3=日历商品,担保支付必填,电商担保无此限制 |
| auto_confirm | bool | 否 | 本地商家,false-需要二次商家确认 true-不需要商家确认,直接发起退款 |
| refund_rule_type | int32 | 否 | 本地商家:退款规则,0-默认不退资源 1-退资源 |
请求示例
{
"out_order_id":"string",
"out_after_sales_order_id":"string",
"open_id":"string",
"type":0,
"reason":"string",
"biz_create_time":0,
"price_info":{
"refund_price":0,
"freight_price":0,
"extra_price_infos":[
{
"name":"string",
"price":0,
"num":0
}
]
},
"product_infos":[
{
"out_product_id":"string",
"out_sku_id":"string",
"num":0,
"price":0
}
],
"refund_voucher_detail":[
{
"voucher_code":"string",
"refund_price":0
}
],
"refund_book_detail":[
{
"book_id":"string",
"refund_price":0
}
],
"product_type":0,
"auto_confirm":true
}
名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| success | bool | 否 | 是否成功 |
| msg | string | 否 | 说明,正确响应时为 success,错误响应时为错误描述 |
| code | int32 | 否 | 错误码,正确响应时为 0,错误响应时非0 |
{
"success":true,
"msg":"string",
"code":0
}
参见错误码