支持第三方调用
支持沙箱环境调用
禁止个人开发者调用
关于售后价格计算 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 }
参见错误码