V兔API开放平台

参数	类型	必选	描述
shop_id	Number	是	店铺 id
fields	String[]	是	需要返回的字段。目前支持有：refund_id, alipay_no, tid, oid, buyer_nick, seller_nick, total_fee, status, created, refund_fee, good_status, has_good_return, payment, reason, desc, num_iid, title, price, num, good_return_time, company_name, sid, address, shipping_type, refund_remind_timeout, refund_phase, refund_version, operation_contraint, attribute, outer_id, sku
refund_id	Number	是	退款单号
vvtype	Number	否	2 高级版（必须填 2,不填默认是 2）

请求示例

vvtype:2
refund_id:123456
fields:refund_id, alipay_no, tid, oid, buyer_nick, seller_nick, total_fee, status, created, refund_fee, good_status, has_good_return, payment
shop_id:123

请求代码示例

cURL请求代码示例

PHP请求代码示例

JAVA请求代码示例

响应参数

名称	类型	示例值	描述
refund	Refund		退款详情
--shipping_type	String	free	物流方式。可选值：free(卖家包邮),post(平邮),express(快递),ems(EMS).
--cs_status	Number	1	不需客服介入 1;需要客服介入 2;客服已经介入 3;客服初审完成 4;客服主管复审失败 5;客服处理完成 6;
--advance_status	Number	1	退款先行垫付默认的未申请状态 0;退款先行垫付申请中 1;退款先行垫付，垫付完成 2;退款先行垫付，卖家拒绝收货 3;退款先行垫付，垫付关闭 4;退款先行垫付，垫付分账成功 5;
--split_taobao_fee	String	1.25	分账给淘宝的钱
--split_seller_fee	String	1.25	分账给卖家的钱
--refund_id	String	83477	退款单号
--tid	Number	2231884277	淘宝交易单号
--oid	Number	2231884277	子订单号。如果是单笔交易 oid 会等于 tid
--alipay_no	String	2009101504179117	支付宝交易号
--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	天堂伞龙井茶	商品标题
--price	String	200.07	商品价格。精确到 2 位小数;单位：元。如：200.07，表示：200 元 7 分
--num	Number	1	商品购买数量
--good_return_time	Date	2000-01-01 00:00:00	退货时间。格式：yyyy-MM-dd HH:mm:ss
--company_name	String	申通快递	物流公司名称
--sid	String	123456789	退货运单号
--address	String	杭州市西湖区华星路 99 号	卖家收货地址
--refund_remind_timeout	RefundRemindTimeout		退款超时结构 RefundRemindTimeout
----remind_type	Number	1	提醒的类型（退款详情中提示信息的类型）
----exist_timeout	Boolean	true	是否存在超时。可选值：true(是),false(否)
----timeout	Date	2000-01-01 00:00:00	超时时间。格式：yyyy-MM-dd HH:mm:ss
----num_iid	Number	4345345	申请退款的商品数字编号
----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（需要到网页版操作）
----buyer_open_uid	String	324324324	买家账号的 OpenUID
----ouid	String	iuwekjhffd	ouid
withholding_money	INT	11	该接口扣费金额（点券）

返回数据

{
    "code": 0,
    "msg": "操作成功",
    "msec": 480,
    "time": 1661322228,
    "data": {
        "refund": {
            "alipay_no": "4214125215123131512444",
            "buyer_nick": "~FWSGGEGEW+sTX7w==~TPeRFDWGWEGEWGx/Dblols2P~1~~",
            "buyer_open_uid": "AGEWGEWGEMACTcPvmDrSVI2sW7",
            "created": "2022-08-24 11:39:06",
            "good_status": "BUYER_NOT_RECEIVED",
            "has_good_return": false,
            "oid": "123",
            "operation_contraint": "null",
            "ouid": "GWGWGEWGWE",
            "payment": "0.00",
            "refund_fee": "1.00",
            "refund_id": "123",
            "seller_nick": "你好旗舰店",
            "status": "SUCCESS",
            "tid": "123",
            "total_fee": "2.00"
        },
        "request_id": "123",
        "withholding_money": 1
    }
}

响应代码

代码	代码描述	解决方案
0	成功
100	请求参数错误	检查您的请求参数是否正确
101	请求超时，请重试	检查您的网络情况或者联系客服解决
103	旺旺账号不存在	检查您输入的旺旺号是否正确
200	系统错误，请联系客服	检查您的接口地址填写是否正确，其他问题联系客服解决
203	暂不支持当前接口
204	请求异常：无该接口权限，请前往官网开通正式接口。	前往官网开通该接口权限
204	请求异常：API 调用次数不足，请前往网站兑换次数。	前往官网充值该接口调用次数
302	未授权店铺	根据返回链接进行扫码授权

获取单笔退款详情

请求头参数

请使用新的生成 token 接口 点击查看详情

请求参数

请求示例

请求代码示例

响应参数

返回数据

响应代码

请使用新的生成 token 接口点击查看详情