
通过该接口,可以实现将人人秀活动里面的自有支付的分销活动,用户提现操作,请求该接口完成提现到账。
需要实现以下两个接口,一个是第三⽅提现落地页,用户在进行提现时会跳转到该页面进行提现操作,提现完成后,第三方平台通过人人秀平台提现通知接口将提现结果回传给人人秀,并且跳转回人人秀我的提现页面。
人人秀平台提现通知接口签名有效期为24小时,商户需要在24小时内完成通知请求,由于一些不可抗力的因素,人人秀平台无法保证通知请求一次就能100%成功, 人人秀平台建议商户请求通知为异步请求。
商户需对通知失败的请求通过一定的策略定期重新发起通知,尽可能提高通知的成功率。(建议通知频率为15/15/30/180/1800/1800/1800/1800/3600,单位:秒)
第三方提现接口,目前支持电商相关支付场景(分销)。
开发注意:
该接口由第三方开发者提供给人人秀调用,必须设置该接口地址
开发者接收到参数,必须先将参数urldecode处理,然后计算签名
contacts 参数类型是json字符串,解析时需要注意转化成对象处理
请求地址 | 由第三方平台提供 | |
请求方式 | 重定向 | |
参数说明 | ||
参数名称 | 是否必须 | 说明 |
app_key | 是 | 人人秀平台分配的AppKey |
time_stamp | 是 | 1970-01-01开始的时间戳,精确到毫秒 |
sign | 是 | 根据签名算法计算所得,如何计算签名 |
openid | 是 | 活动用户唯⼀标识 |
nonce_str | 否 | 随机字符串串,长度要求在32位以内,主要为了了保证生成的签名不不可预测 |
type | 是 | 提现类型,1:单次提现;2:批量提现(单次最多100个订单或单次最大金额200元) |
total_amount | 是 | 当前提现的累计金额(元),支持2位小数。 |
| order_list | 是 | 关联的提现订单,详见order_list参数说明 |
redirect | 是 | 该字段为支付完成后,页面重定向地址 |
fail_url | 是 | 该字段为取消提现后,页面重定向地址 |
order_list参数说明
参数名称 | 数据类型 | 说明 |
order_no | string(32) | 人人秀订单编号 |
order_total_amount | float(2) | 订单商品金额,奖品类型为0,单位为元 |
order_pay_amount | float(2) | 订单支付金额,单位为元 |
create_time | datetime | 订单创建时间 |
product_id | int(11) | 订单商品ID |
product_name | string(11) | 订单商品名称 |
withdrawal_amount | float(2) | 提现金额(元)(一级佣金或二级佣金) |
withdrawal_no | string(32) | 提现订单号(提现记录唯一) |
h5_guid | string(6) | 活动唯一标识 |
activity_guid | string(32) | 互动GUID,通过互动产生的数据有值 |
请求参数示例
{
"app_key": "96c84928b1dce057d110ea3b3880fc83",
"time_stamp":"1543999047492",
"sign ":"051BF3517D40AB9D7D6B45EF6E4EB7F9",
"openId": "gb_1543999047492",
"nonce_str": "def3323k23kl4j4h23u2k4l2a323k2e",
"redirect": "https://h.rrxiu.net/v/123456?v=1&p=1",
"fail_url": "https://h.rrxiu.net/v/123456?v=1",
"type": 1,
"total_amount": 0.01,
"order_list": [{
"order_no": "1543999047492",
"order_total_amount": 100,
"order_pay_amount": 10.02,
"create_time": "2099-01-01 12:00:00",
"product_id": 123,
"product_name": "商品1",
"withdrawal_amount": 0.01,
"withdrawal_n0":"1990474925439",
"h5_guid": "123456",
"activity_guid": "f2f214e3",
}],
}
开发注意:
接口请求通知时间间隔为:15/15/30/180/1800/1800/1800/1800/3600,单位秒。
由于网络异常等原因,返回结果result不是0,则需商家主动再次推送消息到接口,订单推送有效期最长为24小时,超过最大时间则不在返回。
请求地址 | https://open.rrx.cn/api/v1/pay/withdrawalresult | |
请求方式 | POST方式,Content-type:application/x-www-form-urlencoded | |
参数说明 | ||
参数名称 | 是否必须 | 说明 |
app_key | 是 | 人人秀平台分配的AppKey |
time_stamp | 是 | 1970-01-01开始的时间戳,精确到毫秒 |
sign | 是 | 根据签名算法计算所得,如何计算签名 |
openid | 是 | 活动用户唯一标识 |
nonce_str | 是 | 随机字符串,长度要求在32位以内,主要为了了保证生成的签名不不可预测 |
order_list_success | 是 | 已成功提现的人人秀平台订单列表,详见order_list_success参数说明 |
响应参数 | ||
参数 | 是否必须 | 参数说明 |
result | 是 | 0:成功 1:失败 |
msg | 否 | result为1时,返回错误原因 |
响应示例 | ||
成功 | {"result":0,"msg":""} | |
失败 | {"result":1,"msg":"更新失败原因"} | |
order_list_success参数说明
参数名称 | 数据类型 | 说明 |
order_no | string(32) | 人人秀订单编号 |
withdrawal_no | string(32) | 提现订单编号 |
请求参数示例
{
"app_key": "96c84928b1dce057d110ea3b3880fc83",
"time_stamp":"1543999047492",
"sign":"051BF3517D40AB9D7D6B45EF6E4EB7F9",
"openId":"gb_1543999047492",
"nonce_str":"def3323k23kl4j4h23u2k4l2a323k2e",
"order_list_success":[{
"order_no": "1543999047492"
"withdrawal_no": "1990474925439"
}]
}
返回值示例,json格式 Content-type: application/json
{
"result": 0,
"msg": "ok"
}