本站不支持IE浏览器访问,请升级你的浏览器。 点击升级

请认准绿点支付官方网站:https://www.greenyep.com。请勿对接赌博、色情、网络欺诈等违反国家法律法规的业务! 关闭

接口约定

1. 编码约定

数据编码统一为 utf-8。

2. uid & token

文档中提到的 uid & token,都是指商户 uid & token,可在网站的商户后台查看。

3. 字段选填

对于接口参数标记为 选填 的字段,可传入具体的值或者空字符串。

4. signature

为保障接口安全,系统端会对接收到的所有数据,使用 signature 匹配校验,防止数据被非法篡改。

对于 signature 的拼接规则,举个例子:如某个接口需要提交数据 uid 和 amount 两个字段,且 uid 值为 123456,amount 值为 20。根据 signature 的生成规则:toLowerCase(md5(uid + amount)),则最终提交的 signature 数据为:toLowerCase(md5('12345620')) = 594111f029cbea462f70398257ac0e7f

5. 数据提交

对于有数据提交的接口,统一使用 POST 的方式(查询接口除外)。相关 http 请求头的 content-type 字段为:

        
    application/x-www-form-urlencoded
    

6. 数据返回

对于有数据返回的接口,格式为 json,结构如下:

        
    {
        code: 200,
        content: {}
    }
    

说明

上述数据返回结构中,当 code = 200 时代表成功状态,content 为具体的数据内容。否则为失败状态,content 为相关的错误信息。