帮助中心  /  第三方支付提现接口

第三方支付提现接口

接口功能说明

通过该接口，可以实现将人人秀活动里面的自有支付的分销活动，用户提现操作，请求该接口完成提现到账。

需要实现以下两个接口，一个是第三⽅提现落地页，用户在进行提现时会跳转到该页面进行提现操作，提现完成后，第三方平台通过人人秀平台提现通知接口将提现结果回传给人人秀，并且跳转回人人秀我的提现页面。


注意事项

  • 人人秀平台提现通知接口签名有效期为24小时，商户需要在24小时内完成通知请求，由于一些不可抗力的因素，人人秀平台无法保证通知请求一次就能100%成功， 人人秀平台建议商户请求通知为异步请求。

  • 商户需对通知失败的请求通过一定的策略定期重新发起通知，尽可能提高通知的成功率。（建议通知频率为15/15/30/180/1800/1800/1800/1800/3600，单位：秒）

  • 第三方提现接口，目前支持电商相关支付场景（分销）。


1. 第三⽅平台提现落地页


开发注意：

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

  • 开发者接收到参数，必须先将参数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_no":"1990474925439",

    "h5_guid": "123456",

    "activity_guid": "f2f214e3",

}],

}




2. 人人秀平台提现通知接口


开发注意：

  • 接口请求通知时间间隔为：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参数说明

order_list_fail

是

已失败提现的人人秀平台订单列表，详见order_list_fail参数说明

响应参数

参数

是否必须

参数说明

result

是

0：成功   1：失败

msg

否

result为1时，返回错误原因

响应示例

成功

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

失败

{"result":1,"msg":"更新失败原因"}


order_list_success参数说明

参数名称

数据类型

说明

order_no

string(32)

人人秀订单编号

withdrawal_no

string(32)

提现订单编号

order_list_fail参数说明

参数名称

数据类型

说明

order_no

string(32)

人人秀订单编号

withdrawal_no

string(32)

提现订单编号

fail_msg

string(40)

提现失败原因，用户可重新发起提现


请求参数示例

{

    "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"

}



相关文档