使用前必读

请先了解服务端API使用说明文档： 服务端API文档

签名通用规则

VVChat签名生成的通用步骤如下：

第一步，设所有发送或者接收到的数据为集合M，将集合M内非空参数值的参数按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串stringA。

特别注意以下重要规则：

1. ◆ 参数名ASCII码从小到大排序（字典序）；
2. ◆ 如果参数的值为空不参与签名；
3. ◆ 参数名区分大小写；
4. ◆ 验证调用返回或VVChat主动通知签名时，传送的sign参数不参与签名，将生成的签名与该sign值作校验。
5. ◆ 支付接口可能增加字段，验证签名时必须支持增加的扩展字段

第二步，在stringA最后拼接上key得到stringSignTemp字符串，并对stringSignTemp进行MD5运算，再将得到的字符串所有字符转换为大写，得到sign值signValue。

举例：

1
2
3
4
5
6

假设传送的参数如下：
app_id： qyxd930ea5d5a258f4f
store_no： 10000100
title： test
amount： 1
nonce_str： ibuaiVcKdpRxkhJA

第一步：对参数按照key=value的格式，并按照参数名ASCII字典序排序如下：

1
2

stringA="amount=1&app_id=qyxd930ea5d5a258f4f&nonce_str=ibuaiVcKdpRxkhJA&store_no=10000100
&title=test";

第二步：拼接API密钥：

1
2

stringSignTemp=stringA+"&key=192006250b4c09247ec02edce69f6a2d" //注：key为平台下发的
sign=MD5(stringSignTemp).toUpperCase()="9A0A8659F005D6984697E2CA0A9CF3B7" //注：MD5签名方式

基础签名

需要基础签名的接口需要将公共参数设置到http的header里

公共参数

公用参数是在 http的header里,所有接口都需要带公共参数

注意： 基础签名不是key=value的形式 是直接拼接的值

基础签名方式如下：

1

sign = MD5( appKey + noncestr + timestamp).toUpperCase()

一般安全级别的接口，可能只需要基础签名即可。

数据签名

安全级别中等的接口，只需要数据签名即可。

数据签名规则与通用签名规则一致,签名的数据为接口请求数据

联合签名

安全级别要求高的接口，需要进行联合签名。

第一步：

1
2
3
4
5

stringA="amount=1&app_id=qyxd930ea5d5a258f4f&nonce_str=ibuaiVcKdpRxkhJA&store_no=10000100
&title=test";
dataAndBaseSign = MD5 (stringA+"&key=192006250b4c09247ec02edce69f6a2d"+"&basesign=dgce5thdy8t3t6hk89grd3d5").toUpperCase()
//注：key为平台下发的
// basesign 为基础数据签名所得

第二步：

1
2

sign = basesign+"." + dataAndBaseSign  //基础签名 + "." + 数据基础混合签名
// 注意中间需要用“.”隔开

举例说明 （以此例子所示签名方式为准）

以代付接口参数为例：

app_id=test

app_key=123456

store_no=s1234

基础签名：

1

baseSign = MD5( appKey + noncestr + timestamp).toUpperCase()

数据联合签名:

1
2
3
4
5
6
7

// 按照 ASSCI排序请求参数：
dataSignString = "amount=1000&in_open_id=xd8wjr9jr02kjf823jse94kio8&notify_url=http://www.test.com/callback&out_open_id=lJsDBB01QzGpBKOC7uaZB6D0QGZWBMCS&out_order_no=2334234343zz&title=test"
// 拼接appkey和基础签名
dataSign = dataSignString + "&key=123456" + "&basesign=" + baseSign

// 获得联合签名
sign = basesign + "." + MD5(dataSign).toUpperCase()

纯数据签名：

1
2
3
4
5
6
7

// 按照 ASSCI排序请求参数：
onlyDataSignString = agentpay_no=ds99fjjwekwerjfm&app_id=test&out_order_no=lJsDBB01QzGpBKOC7uaZB6D0QGZWBMCS&status=1&time=1517928240

// 拼接appkey
onlyDataSign = onlyDataSignString + "&key=123456"
// 获得数据签名
onlySign = MD5(onlyDataSign).toUpperCase()

接口基础说明

所有接口都是以JSON的形式传参数。Content-Type：application/json

测试基地址: http://dev.vvchat.im

测试数据

app_id: test

app_key: 123456

out_open_id: lJsDBB01QzGpBKOC7uaZB6D0QGZWBMCS // 出款账户

注意：接口使用那种签名会有标记

统一下单接口

此接口采用 数据签名 方式

请求地址

POST /paybusapi/v1/pay/unifiedorder

请求参数

错误返回 400

当http状态为400的时候 将会有如下数据

成功返回 200

当http状态为200时 将会有如下数据

通知返回

第三方业务处理成功后返回 success (不区分大小写)

查询交易信息

无需签名

请求地址

GET /paybusapi/v1/pay/unifiedorder

请求参数

成功返回 200

错误返回 400

代付接口

联合签名

将代付账号的VVChat余额转向指定的用户VVChat账户

请求地址

POST /paybusapi/v1/app/agentpay

公共参数

公用参数是在 http的header里

请求参数

异步通知返回参数

注意 ：回调可能存在重复请求情况，第三方需要做除重处理。 第三方做好返回数据的校验，防止出现恶意请求。

获取访问凭证(token)

无需签名

获取用户调用接口的凭证，拥有此凭证后才能调用特定的接口

http状态码为200 将返回成功返回的参数。http状态码为400 将返回错误返回参数

请求地址

GET /userservices/v2/authorization/token?app_id=APPID&app_key=APPKEY&code=CODE

请求参数

成功返回 200

错误返回 400

获取用户资料

无需签名

获取用户的资料，包括唯一标示，头像，昵称等等

请求地址

GET /userservices/v2/authorization/userinfo

请求参数

成功返回 200

错误返回 400

发送消息

无需签名

可以向用户发送消息

http状态码为200 将返回成功返回的参数。http状态码为400 将返回错误返回参数

请求地址

POST /messageapi/v1/authorization/sendmsg

Content-Type: application/json

请求参数

成功返回 200

无需处理返回参数 判断http状态码为200 必定成功 否则失败。

错误返回 400