帮助中心  /  第三方支付退款接口

第三方支付退款接口

接口功能说明

通过该接口,可以实现是第三方接口支付的订单,在数据后台操作退款,请求该接口完成退款。


注意事项

  • 仅支持通过第三方支付接口提交的订单,才会调用此接口退款。

  • 第三方支付退款接口,目前支持商品相关退款场景(表单商品、电商类活动、商城商品、打赏、活动报名、预约)。


第三⽅支付退款接口


开发说明:

  • 该接口由第三方开发者提供给人人秀调用,必须设置该接口地址

  • 开发者接收到参数,必须先将参数urldecode处理,然后计算签名

请求地址

由第三方平台提供

请求方式

POST方式,Content-type:application/x-www-form-urlencoded

参数说明

参数名称

是否必须

说明

app_key

人人秀平台分配的AppKey

time_stamp

1970-01-01开始的时间戳,精确到毫秒

sign

根据签名算法计算所得,如何计算签名

openid

活动用户唯一标识

transaction_no

第三方平台支付完成生成的订单号

order_no

人人秀系统内部订单号

body

商品简单描述

total_fee

订单总金额,单位为元

params

商品参数,json字符串。

{"products":[     // 支付的内容

{"name":"商品名称", // 支付的内容名称 

"id":"101",    // 支付的内容ID

"count":"1",  // 支付的内容数量

}],  

"h5_guid":"123456", // 支付的活动唯一标识

"activity_guid":"f2f214e3",  // 具体互动guid标识  (可能为空)

"activity_category":"砍价"} // 互动类型,例如砍价,秒杀 (可能为空)

contacts

该字段为用户完善信息,活动开启完善信息参与有值。

该字段为JSON数组字符串

[{"id":"1","name":"姓名","value":"张三"},

{"id":"3","name":"手机","value":"13635603333"}]

响应参数

参数

是否必须

参数说明

result

0:成功   1:失败

msg

result为1时,返回错误原因

响应示例

成功

{"result":0,"msg":""}

失败

{"result":1,"msg":"退款失败原因"}



请求示例

{

"app_key""96c84928b1dce057d110ea3b3880fc83",

"time_stamp":"1543999047492",

"sign ":"051BF3517D40AB9D7D6B45EF6E4EB7F9",

"openId""gb_1543999047492",

"order_no""1543999047492",

"transaction_no""def3323k23kl4j4h23u2k4l2a323k2e",

"body""酒水一件",

"total_fee"10.01,

"params"{

    "products":[

        {    "id":"101",

             "name":"酒水",

             "count":"1",

    }],

    "h5_guid":"123456",

    "activity_guid":"f2f214e3",

    "activity_category":"砍价"

},

"contacts ": [

         {"id":101,"name":"姓名","value":"张三"},

         {"id":103,"name":"手机号","value":"15811111111"},

    ]

}



 返回值示例,json格式 Content-type: application/json

{

    "result"0,

    "msg""ok"

}



相关文档