【逆向交易接口】场景一：批量查看退款信息列表

收藏

场景描述：

⽤户在微商城申请退款或退货退款时，如何在微商城查看退款信息？如何通过接⼜查看退款信息？

——微商城后台-订单-所有订单-退款中即可查看用户申请退款或退货退款的订单；

——通过哪个接口可以查看买家申请的退款单列表？

（1）查看退款列表接口：youzan.trade.refund.search

（3）重要字段说明：

》》create_time_end：时间范围查询，退款创建的截止时间时间戳 (单位为秒) 例如:1513868400，时间戳与标准时间格式转换工具：https://tool.lu/timestamp/ ；

》》create_time_start：时间范围查询，退款创建的起始时间时间戳 (单位为秒) 例如:1513785600，工具参考如上；

》》refund_id：退款ID，若不传则返回所有未处理的退款信息，若传了具体的退款ID，只返回该ID对应的退款信息；

》》tid：订单号，操作退款的订单号；如果传了具体的订单号，结果只返回该订单中产生的退款信息；例如E20180903203737007600006；

》》update_time_end：退款状态的更新截止时间，不同于创建截止时间；举例：如果买家在上午10点申请了退款，一直到晚上8点退款的状态都没有进一步更新（比如商家没有处理），此时接口中传入的更新截止时间就算是在晚上8点之后，结果也不会返回该退款消息，因为该退款的退款状态一直未更新；格式同上；

》》update_time_start：退款状态的更新起始时间，不同于退款创建的起始时间，格式同上；

（4）调用格式：

通过（2）中链接访问后：

（5）HTTP调用示例：

（6）JAVA调用示例：

YZClient client = new DefaultYZClient(newToken("token")); //new Sign(appKey, appSecret)

YouzanTradeRefundSearchParams youzanTradeRefundSearchParams= new YouzanTradeRefundSearchParams();

youzanTradeRefundSearchParams.setStatus("SUCCESS");

YouzanTradeRefundSearch youzanTradeRefundSearch = new YouzanTradeRefundSearch();

youzanTradeRefundSearch.setAPIParams(youzanTradeRefundSearchParams);

YouzanTradeRefundSearchResult result =client.invoke(youzanTradeRefundSearch);