二、接口使用说明

2.1 充值回调接口

233游戏平台通过开发商提供的支付通知地址(支付通知地址是通过开发商传递给 app 的serverId 决定，如果传递过来的serverId为空那么就使用默认的支付通知地址)将支付结果发给开发商，使用HTTP协议POST方式，由于安全的考虑需要做 RSA 验证签名和加密。开发商可以查看自己所属游戏的RSA公钥(对于每个游戏只有一个公钥)，用来对下发的通知信息进行验签和解密。

回调接口调用规则:

开发商必须在回调接口中返回小写字母ok, 否则平台会认为回调失败。1分钟后会继续调用回调接口, 最多调用4次。

参数名称

是否必填

说明

备注

gameOrderId

是

游戏方提供的游戏订单号

gameOrderId=123456789

encrypData

是

通过DESede对称加密算法加密交易数据的JSON所得的加密数据。交易数据JSON格式为{"payAmount":25,"uid":"3ce4a44c3774484388db812d0d5d7530","itemName":"钻石大礼包","payStatus":"2","orderId":"20170704152200002"}

每次加密使用的秘钥不同。

加密之后的内容: iKxx7cRN58R85adXNjzR0JJfY5l2/AN15o6lMNJ4/iDTCqHblTJiASbRuy38OeolWNfRBPeLxS908LKfyCnhVH878YlrRLeiJcL3AQgCiwvhnFzpzG/hPZRWafsUIJNxycQYgjhivQAp2Q1SlZbo5aoLFPlY2t11G2fgU+Ar3E0dzctM0R6pxQ==

sign

是

通过RSA非对称加密算法加密DESede算法中使用的秘钥

加密之后的内容: cLxo5YjG4rXerGLINHBk7fiH9AkC9XQaM10O8xy70jTDCcFo+sCWrdkA/YqJdOYBYJK6SwyD3F0qIObI6JkbrXNDcwm6BLpSNCtevChCSfuuWgGT1DlAbAAFf3LcfwdGJS/uZ3sG1gJ/ubZrTR7J6h8EkxdecFpOC99zoCcZjnY=

交易数据解密后参数：

参数名称

是否必填

说明

备注

uid

是

用户ID 32位长

uid=3ce4a44c3774484388db812d0d5d7530

serverId

是

游戏区服ID

一般为数字、字符

serverName

是

游戏区服名

itemName

否

商品名称

itemName=钻石大礼包

orderId

是

内部交易编号(233游戏生成)32位长

orderId=20170704152200002

payAmount

是

商品价格

单位为分

payStatus

是

交易状态

0 等待支付

1 等待回调

2 交易成功

3 交易失败

(注：充值回调接口中参数payAmount 、paystatus分别与充值订单批量查询接口的参数amout、status解释一样，但参数不同。)

开发商接收到来自233游戏平台的支付通知后，可以使用平台提供的解密方法和游戏公钥获取交易数据。如果解密方法返回的交易数据为空, 则数据无效或被篡改。

解密方法调用示例：

2.2 充值订单批量查询接口

开发商可以自主调用233游戏平台提供的游戏订单批量查询接口来查询订单的状态。

请求地址：https://api.233sy.cn/cp/orderinfo

请求参数：

参数名称

是否必填

说明

备注

appKey

是

游戏唯一标识

appKey=123456789

orderId

是

属于该appkey的订单号码，多个订单号码使用英文分号分隔

orderId=123,456,789,890

sign

是

订单号码与游戏的公钥的md5，如：md5(订单号码.游戏公钥)

sign=123,456,789,890.MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBg

返回参数：

参数名称

是否必填

说明

备注

reCode

是

状态码

200标识成功, 其他均为失败

orderCount

否

结果中订单数量

orderCount=1

orderList

否

订单的结果集

订单结果参数：

参数名称

是否必填

说明

备注

gameOrderId

是

游戏的订单号

uid

是

游戏玩家在233平台中的唯一标识符

serverId

是

游戏服务区ID

serverName

是

游戏服务区名称

itemName

是

商品名称

amount

是

商品价格

以分为单位

status

是

订单状态

0 等待支付

1 等待回调

2 交易成功

3 交易失败

2.3 验证用户信息接口

接口说明:

该接口为233合作方服务器对233服务器发起的接口，用于iOS和Android游戏用户信息验证。H5游戏无需调用此接口。此接口为非必须使用接口。

游戏客户端通过233-SDK登录回调中获取到uid和token后，为防止用户篡改客户端而伪造用户uid标示从而登录他人账号，游戏客户端应将此信息传入给游戏服务器。游戏服务器调用此接口向233服务端验证uid的真实性。

若uid通过验证则允许此用户登录，若无法通过验证应拒绝此用户的登录授权。

API地址:

地址: http://check.233sy.cn/sdk/user/loginCheck

请求方式:

GET/POST

参数列表:

参数名称

类型

必要性

说明

token

string

必须

游戏客户端从233-SDK客户端中获取的token值,此值长度32个字符

uid

string

必须

从233-SDK客户端接口获取到的玩家的ID及uid

ext

string

非必须

扩展信息，合作方自行带入

返回结果:

参数名称

类型

必要性

说明

status

bool

必须

接口验证状态，若通过验证为true，否则为false

message

string

必须

message有值，为错误提示语

ext

string

非必须

扩展信息，合作方自行带入

pi

string

非必须

已通过中宣部实名认证用户的唯一标识

接口会返回JSON格式字符串，如:

例1 {"status":false,"message":"实名错误","ext":"自定义内容"}

例2 {"status":true,"message":"ok"," ext ":"自定义内容"}