全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
查询卖家收到的退款列表
接口地址： http://api.vv-tool.com/tool/erps/egetreceive
接口介绍： 查询卖家收到的退款列表
请求方式： POST
返回格式： JSON
接口收费： 联系客服
频率限制： 10 次/秒
请求头参数
| 参数 | 类型 | 必选 | 值 | 示例 |
|---|---|---|---|---|
| Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请使用新的生成 token 接口 点击查看详情
请求参数
| 参数 | 类型 | 必选 | 描述 |
|---|---|---|---|
| shop_id | Number | 是 | 店铺 id |
| fields | String[] | 是 | 需要返回的字段。目前支持有：refund_id, tid, title, buyer_nick, seller_nick, total_fee, status, created, refund_fee, oid, good_status, company_name, sid, payment, reason, desc, has_good_return, modified, order_status,refund_phase |
| status | String | 否 | 退款状态，默认查询所有退款状态的数据，除了默认值外每次只能查询一种状态。WAIT_SELLER_AGREE(买家已经申请退款，等待卖家同意)WAIT_BUYER_RETURN_GOODS(卖家已经同意退款，等待买家退货)WAIT_SELLER_CONFIRM_GOODS(买家已经退货，等待卖家确认收货)SELLER_REFUSE_BUYER(卖家拒绝退款) CLOSED(退款关闭) SUCCESS(退款成功) |
| buyer_nick | String | 否 | 买家昵称 |
| buyer_open_uid | String | 否 | AXADSASDSDSDSSS |
| type | String | 否 | 交易类型列表，一次查询多种类型可用半角逗号分隔，默认同时查询 guarantee_trade, auto_delivery 这两种类型的数据，查看可选值 |
| start_modified | Date | 否 | 查询修改时间开始。格式： yyyy-MM-dd HH:mm:ss |
| end_modified | Date | 否 | 查询修改时间结束。格式： yyyy-MM-dd HH:mm:ss |
| page_no | Number | 否 | 页码。取值范围：大于零的整数; 默认值：1 |
| page_size | Number | 否 | 每页条数。取值范围：大于零的整数; 默认值：40;最大值：100 |
| use_has_next | Boolean | 否 | 是否启用 has_next 的分页方式，如果指定 true,则返回的结果中不包含总记录数，但是会新增一个是否存在下一页的的字段，通过此种方式获取增量退款，接口调用成功率在原有的基础上有所提升。 |
| ouid | String | 否 | 系统自动生成 |
| vvtype | Number | 否 | 2 高级版（必须填 2,不填默认是 2） |
请求示例
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
响应参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| total_results | Number | 100 | 搜索到的退款信息总数 |
| has_next | Boolean | true | 是否存在下一页 |
| refunds | Refund [] | 搜索到的退款信息列表 | |
| --refund_id | String | 83477 | 退款单号 |
| --tid | Number | 2231884277 | 淘宝交易单号 |
| --oid | Number | 2231884277 | 子订单号。如果是单笔交易 oid 会等于 tid |
| --total_fee | String | 10.00 | 交易总金额。精确到 2 位小数;单位：元。如：200.07，表示：200 元 7 分 |
| --buyer_nick | String | tbtest561 | 买家昵称 |
| --seller_nick | String | tbtest869 | 卖家昵称 |
| --created | Date | 2000-01-01 00:00:00 | 退款申请时间。格式：yyyy-MM-dd HH:mm:ss |
| --modified | Date | 2000-01-01 00:00:00 | 更新时间。格式：yyyy-MM-dd HH:mm:ss |
| --order_status | String | BUYER_RECEIVED | 退款对应的订单交易状态。可选值 TRADE_NO_CREATE_PAY(没有创建支付宝交易) WAIT_BUYER_PAY(等待买家付款) WAIT_SELLER_SEND_GOODS(等待卖家发货，即：买家已付款) WAIT_BUYER_CONFIRM_GOODS(等待买家确认收货，即：卖家已发货) TRADE_BUYER_SIGNED(买家已签收，货到付款专用) TRADE_FINISHED(交易成功) TRADE_CLOSED(交易关闭) TRADE_CLOSED_BY_TAOBAO(交易被淘宝关闭) ALL_WAIT_PAY(包含：WAIT_BUYER_PAY、TRADE_NO_CREATE_PAY) ALL_CLOSED(包含：TRADE_CLOSED、TRADE_CLOSED_BY_TAOBAO) 取自"http://open.taobao.com/dev/index.php/%E4%BA%A4%E6%98%93%E7%8A%B6%E6%80%81" |
| --status | String | SUCCESS | 退款状态。可选值 WAIT_SELLER_AGREE(买家已经申请退款，等待卖家同意) WAIT_BUYER_RETURN_GOODS(卖家已经同意退款，等待买家退货) WAIT_SELLER_CONFIRM_GOODS(买家已经退货，等待卖家确认收货) SELLER_REFUSE_BUYER(卖家拒绝退款) CLOSED(退款关闭) SUCCESS(退款成功) |
| --good_status | String | BUYER_RECEIVED | 货物状态。可选值 BUYER_NOT_RECEIVED (买家未收到货) BUYER_RECEIVED (买家已收到货) BUYER_RETURNED_GOODS (买家已退货) |
| --has_good_return | Boolean | true | 买家是否需要退货。可选值：true(是),false(否) |
| --refund_fee | String | 10.00 | 退还金额(退还给买家的金额)。精确到 2 位小数;单位：元。如：200.07，表示：200 元 7 分 |
| --payment | String | 200.07 | 支付给卖家的金额(交易总金额-退还给买家的金额)。精确到 2 位小数;单位：元。如：200.07，表示：200 元 7 分 |
| --reason | String | 退还邮费 | 退款原因 |
| --desc | String | hello world | 退款说明 |
| --title | String | 天堂伞龙井茶 | 商品标题 |
| --num | Number | 1 | 商品购买数量 |
| --company_name | String | 申通快递 | 物流公司名称 |
| --sid | String | 123456789 | 退货运单号 |
| --refund_phase | String | onsale | 退款阶段，可选值：onsale/aftersale |
| --refund_version | Number | 1411375308927 | 退款版本号（时间戳） |
| --sku | String | 30004447689 | 颜色分类：军绿色;尺码：XS |
| --attribute | String | {"key1":"value1", "key2":"value2"} | 退款扩展属性 |
| --outer_id | String | ISBN-001 | 商品外部商家编码 |
| --operation_contraint | String | refund_onweb | 退款约束，可选值：cannot_refuse（不允许操作），refund_onweb（需要到网页版操作） |
| --ouid | String | iuwekjhffd | ouid |
| withholding_money | Number | 该接口扣费金额（点券） |
返回数据
{"code": 0, "msg": "操作成功", "msec": 1469, "time": 1617270403, "data": {"withholding_money": 1,"refunds_receive_get_response": {"total_results": 100, "has_next": true, "refunds": {"refund": [{"refund_id": "83477", "tid": 2231884277, "oid": 2231884277, "total_fee": "10.00", "buyer_nick": "tbtest561", "seller_nick": "tbtest869", "created": "2000-01-01 00:00:00", "modified": "2000-01-01 00:00:00", "order_status": "BUYER_RECEIVED", "status": "SUCCESS", "good_status": "BUYER_RECEIVED", "has_good_return": true, "refund_fee": "10.00", "payment": "200.07", "reason": "退还邮费", "desc": "hello world", "title": "天堂伞龙井茶", "num": 1, "company_name": "申通快递", "sid": "123456789", "refund_phase": "onsale", "refund_version": 1411375308927, "sku": "30004447689|颜色分类:军绿色;尺码:XS", "attribute": "{"key1":"value1", "key2":"value2"}", "outer_id": "ISBN-001", "operation_contraint": "refund_onweb", "ouid": "iuwekjhffd"}]}}}}
响应代码
| 代码 | 代码描述 | 解决方案 |
|---|---|---|
| 0 | 成功 | |
| 100 | 请求参数错误 | 检查您的请求参数是否正确 |
| 101 | 请求超时，请重试 | 检查您的网络情况或者联系客服解决 |
| 103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
| 200 | 系统错误，请联系客服 | 检查您的接口地址填写是否正确，其他问题联系客服解决 |
| 203 | 暂不支持当前接口 | |
| 204 | 请求异常：无该接口权限，请前往官网开通正式接口。 | 前往官网开通该接口权限 |
| 204 | 请求异常：API 调用次数不足，请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
| 302 | 未授权店铺 | 根据返回链接进行扫码授权 |