# 8、CPL领奖回调 仅适用非爱变现发钱

# 请求方式:

# post

# 应用场景

用户领取完成后,平台会把相关领取结果及用户信息通过数据流的形式发送给媒体,媒体需要接收处理,并按文档规范返回应答。

# 特别提醒 需要实现

​ 1.同样的通知可能会多次发送给媒体系统。媒体系统必须能够正确处理重复的通知。

​ 2.媒体系统对于领取结果通知的内容一定要做签名验证,防止数据泄漏导致出现“假通知”,造成资金损失。

​ 3.当收到通知进行处理时,首先检查对应业务数据的状态,判断该通知是否已经处理过,如果没有处理过再进行处理,如果处理过直接返回结果成功(返回值为 {"code":200},json)。在对业务数据进行状态检查和处理之前,要采用数据锁进行并发控制,以避免函数重入造成的数据混乱。

4.回调处理成功后返回值为 {"code":200}。无返回值或者非200,则认为回调出现异常,会再次进行回调。

# 接口链接 后台自行配置 POST请求

该链接需要自行在媒体后台进行配置(我的应用-->应用列表-->配置---》CPL配置----》回调地址),如果链接无法访问,媒体将无法接收到平台通知。 配置引导如下:

通知url必须为直接可访问的url,不能携带参数。示例:notify_url:"https://pay.xxxxx.com/xxxxx/pay.action"

当接口调用失败后,平台会在5秒,10秒 ,30秒,1分,2分,3分,4分, 5分, 6分,7分,8分,9分,10分, 20分,30分,1小时,2小时分别请求回调接口一直到接口请求成功。

开发完接口以后,请点击上述图片的“点我测试”按钮自行测试接口的正确性。

# 通知参数(formData)

字段名 变量名 必填 类型 示例值 描述
应用id app_key String(32) 142792745 平台的应用id
设备 device String(32) ios ios,安卓
设备号 device_info String(32) 013467007045764 安卓传imei,ios传参idfa值
用户标识 target_id String(128) 13457 接入平台的用户唯一标示
奖励单位 unit String(32) 金币 接入平台的奖励单位
领取时间 time_end String(14) 20141030133525 领取完成时间,格式为yyyyMMddHHmmss,如2009年12月25日9点10分10秒表示为20091225091010
应用方给予用户奖励 user_reward float(10, 2) 100.00 应用方应当给予用户奖励(应用平台币计价)
平台给予应用奖励 app_reward float(10, 2) 200.00 平台给予应用奖励
游戏名字 game_name String(32) 奇奇乐捕鱼 领取奖励的游戏名
游戏编号 game_id int(32) 324 领取奖励的游戏编号
签名 sign String(32) C380BEC2BFD727A4B684 通过签名算法计算得出的签名值,通过签名算法计算得出的签名值,详见签名规则MD5(app_key+device+device_info+target_id+app_secret) .toUpperCase
奖励说明 content String(64) 累计红包0.9元 奖励说明
订单号 order_id int(32) 23974895 订单号
游戏期号 game_order_id int(32) 324 游戏期号
奖励类型 type int(32) 1 1试玩赢金,2充值返利,3冲榜福利,4高额试玩,5活动发奖

app_key及app_secret获取引导,(后台的地址、用户名、密码请联系商务获取)