发起退款

优质
小牛编辑
142浏览
2023-12-01

发起退款接口

第三方向网盘发起退款请求

接口说明

POST https://pan.baidu.com/rest/2.0/xpan/audit?method=refund

请求参数

参数类型必须描述
business_idint商户号
order_nostring网盘订单号
reasonstring退款原因
moneyint退款金额
signstring签名

请求示例

curl "https://pan.baidu.com/rest/2.0/xpan/audit?method=refund" -d 'business_id=1&order_no=1234&reason=退款&money=800&sign=1234'

备注:

1.签名算法

sign根据business_id、order_no、money字段升序排序,按"$k=$v&"方式拼接,最后拼上"key=$seckey",密钥向平台申请,已接入商家可用之前分配的密钥进行签名。整体使用MD5进行签名。

2.退款请求限制:请求退款且返回成功后,订单进入审核和退款流程。可通过查询接口查询。非驳回状态下不可再次请求退款。

响应示例:

{
 "errmsg": "succ",
 "errno": 0,
 "request_id": "867272960888449253"
}

查询退款订单:供用户查询请求退款的订单退款状态

接口说明

POST https://pan.baidu.com/rest/2.0/xpan/audit?method=query

请求参数

参数类型必须描述
business_idint商户id
order_nostring网盘订单
signint签名

请求示例

curl "https://pan.baidu.com/rest/2.0/xpan/audit?method=query" -d 'business_id=1&order_no=123&sign=abc'

响应参数

参数类型描述
statusint订单退款状态
reject_reasonstring驳回原因
reject_timeint驳回次数

备注:

1.订单状态说明:0为待审核,1为已审核,2为退款中,3为退款成功,4为退款失败,5为已驳回

2.该接口返回该笔订单最近一次退款请求的退款状态。如果该笔订单存在驳回记录,则返回该订单号对应的驳回次数和最近一次的驳回理由。

响应示例

{
    "errmsg": "succ",
    "errno": 0,
    "reject_reason": "unreasonable",
    "reject_time": 2,
    "request_id": "40778535682934048",
    "status": 5
}