支付回调

(1) 回调流程

注册小y支付账号,获取CorpId、AppId、小y游戏RSA公钥(注意RSA密钥 是用于服务器端签名,不要在客户端里使用), 如需使用请求时签名,则需CP生成一对公钥后,提交到支付系统.

支付完成后,小y游戏网关系统将把支付信息和订单信息以流的形式发送给商户,商户需要接收处理,并返回应答。

注意:同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。

推荐的做法是,当收到通知进行处理时,首先检查对应业务数据的状态,判断该通知是否已经处理过,如果没有处理过再进行处理,如果处理过直接返回结果成功。在对业务数据
进行状态检查和处理之前,要采用数据锁进行并发控制,以
避免函数重入造成的数据混乱。

别提醒:商户系统对于支付结果通知的内容一定要做签名验证,防止数据泄漏导致出现“假通知”,造成资金损失。

具体流程如下:

注:由于是异步通知模型,(3)和(4)不一定是按序号产生。因此(4)和(5)需要进行轮询处理或者使用接口进行支付结果查询。 相比后面提到的开发者主动查询订单的模式,
我们推荐使用此模式。


(2) 接口及参数说明

接口地址:开发者下单通知地址
回调参数说明:

属性名称 属性描述 必填 类型 长度
corpId

商户ID,字母,数字组合,如:CM001101

string 8
appId

商户的应用ID,如:CA001101

string 8

xiaoyTradeNo

y游戏订单ID


string 32

outTradeNo

商户订单ID


string 8~32

payChannel

支付渠道:

01:y游戏支付

02:微信

03:支付宝


string 2

orderCreateTime

订单生成时间yyyyMMddHHmmss


string 14

orderExpireTime

订单失效时间yyyyMMddHHmmss


string
14

totalFee

订单总金额(单位:分)


int
11

cashFee

现金支付金额(单位:分)


int
11

attach

商户下单附加数据

string
127
sign

签名


string 1024
     

响应参数说明:

属性名称 属性描述 必填 类型 长度

success string 50
     

商户收到支付通知后必须打印输出“success”(不包含引号)。如果商户反馈给小y游戏的字符不是success这7个字符,小y支付服务器会通过一定策略定期重发通知,尽可能提高通知的成功率。
一般情况下,3小时以内完成8次通知(通知的间隔频率一般是:15/15/30/180/1800/1800/3600,单位:秒)。