帮助中心  /  第三方支付

第三方支付

接口功能说明

通过该接口，可以实现将人人秀活动里面的微信支付替换成商家自己的支付系统。

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


注意事项

  • 人人秀平台支付通知接口签名有效期为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

是

活动用户唯⼀标识

phone

否

该字段提取contacts里的手机号，

只有在contacts里有手机号时才有值,方便开发者获取手机号

contacts

否

该字段为开启活动报名填写的信息。

该字段为JSON数组字符串

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

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

body

否

商品简单描述

nonce_str

是

随机字符串串，长度要求在32位以内，主要为了了保证生成的签名不不可预测

order_no

是

人人秀系统内部订单号

total_fee

是

订单支付总金额，单位为元

redirect

是

该字段为支付完成后，页面重定向地址

fail_url

是

该字段为取消支付后，页面重定向地址

params

否

商品参数，json字符串。

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

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

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

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

}],  

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

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

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


请求示例

{

"app_key": "96c84928b1dce057d110ea3b3880fc83",

"time_stamp":"1543999047492",

"sign ":"051BF3517D40AB9D7D6B45EF6E4EB7F9",

"openId": "gb_1543999047492",

"phone": "15811111111",

"contacts ": [

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

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

    ]

"order_no": "1543999047492",

"body": "酒水一件",

"nonce_str": "def3323k23kl4j4h23u2k4l2a323k2e",

"total_fee": 10.01,

"redirect": "https://h.rrxiu.net/v/123456?v=1&p=1",

"fail_url": "https://h.rrxiu.net/v/123456?v=1"，

"params": {

    "products":[

        {    "id":"101",

             "name":"酒水",

             "count":"1",

    }],

    "h5_guid":"123456",

    "activity_guid":"f2f214e3",

    "activity_category":"砍价"

},

}




2. 人人秀平台支付通知接口


开发注意：

  • 接口请求通知时间间隔为：15/15/30/180/1800/1800/1800/1800/3600,单位秒。

  • 由于网络异常等原因，返回结果result不是0，则需商家主动再次推送消息到接口，订单推送有效期最长为24小时，超过最大时间则不在返回。

请求地址

https://open.rrx.cn/api/v1/pay/payresult

请求方式

POST方式，Content-type：application/x-www-form-urlencoded

参数说明

参数名称

是否必须

说明

app_key

是

人人秀平台分配的AppKey

time_stamp

是

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

sign

是

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

openid

是

活动用户唯一标识

transaction_no

否

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

nonce_str

是

随机字符串，长度要求在32位以内，主要为了了保证生成的签名不不可预测

order_no

是

人人秀系统内部订单号

响应参数

参数

是否必须

参数说明

result

是

0：成功   1：失败

msg

否

result为1时，返回错误原因

响应示例

成功

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

失败

{"result":1,"msg":"支付失败原因"}


请求示例

{

    "app_key": "96c84928b1dce057d110ea3b3880fc83",

"time_stamp":"1543999047492",

"sign":"051BF3517D40AB9D7D6B45EF6E4EB7F9",

"openId":"gb_1543999047492",

"transaction_no":"od1235678"',

"nonce_str":"def3323k23kl4j4h23u2k4l2a323k2e",

"order_no":"1543999047492"

}

 

 

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

{

    "result": 0,

    "msg": "ok"

}



相关文档