h5扫码页面不设定金额

51游戏大约 3 分钟

h5扫码页面不设定金额


接口编码

编码格式密级
UTF-8公开

版本记录

版本修改内容记录人修改时间
1.0.0建立文档高文峰2021-09-01
1.0.5修改文档徐自豪2021-11-20

场景说明

  1. 提供一种不需要在游戏内的扫码页面设定金额的扫码支付方式!即:平台提供固定充值二维码(扫码后选择金额)
  2. 页面中使用img标签进行使用,手机扫码后跳转到充值页面,选择充值金额完成充值(<img src='返回结果'>)

接口说明

URL请求方式
http://passport.51.com/qrcode/api/pay_imgopen in new windowGET

请求参数说明

参数类型必填描述示例值
redirect_urlString充值请求跳转url(只有拼接passport.51.com的redirect_url参数时候,进行urlencode编码,在之前不要urlencode)http://pay.51.com/h5/page?uid=**open in new window
tokenString校验传递参数一致性(规则如下)wewewewewewddedewref

redirect_url参数说明

参数类型必填描述示例值
uidString用户名(同登录接口中user参数)400253473
gidint游戏ID(运营提供)639
gamearea_idint游戏区服ID1
timeint请求时间戳(unix)1637310499
gameroleint角色ID223610094744846927
gamerole_nameString角色名彩艳血
gameorder_noString游戏方订单号(没有传空)
game_order_extString游戏拓展字符串
user_ipString用户客户端IP61.183.116.90
signString签名(规则如下)04bf0e78ced15f3932587552cedcf80a

注意:http://pay.51.com/h5/url/pageopen in new window 这个是固定值,后⾯参数下⾯表格具体说明

拼接http://passport.51.com/qrcode/api/pay_img?redirect_url=open in new window 时,要将api链接编码成字符串(urlencode)

返回结果

说明格式返回示例
正确返回图片返回一个图片URL链接
错误返回字符输出签名错误/非法请求(token错误)

操作步骤

  • 1.参数举例

    $game_order_ext = '';
    $gamearea_id = '1';
    $gameorder_no= '';
    $gamerole  = '223610094744846927';
    $gamerole_name = '彩艳血';
    $gid = '639';
    $time = '1637310499';
    $uid = '400253473';
    $user_ip = '61.183.116.90';
    serect = 'serect值请联系51平台运营薛磊获取';
    
  • 2.redirect_url链接生成案例拼接显示

    sign 生成
    $sign =md5($game_order_ext.$gamearea_id.$gameorder_no.$gamerole.$gamerole_name.$gid.$time.$uid.$user_ip.$serect);
    //其中"."为php字符串连接符,参数值直接拼接!
    //注意md5拼接时是按照参数字母的升序排序后拼接的,即生成sign的md5参数拼接顺序是按照参数名升序排序拼接后加上serect,sign参数不参与签名
    //serect值请联系51平台运营薛磊获取  
    
    redirect_url 生成
       $redirect_url = http://pay.51.com/h5/url/page?uid=400253473&gid=639&gamearea_id=1&time=1637310499&gamerole=223610094744846927&gamerole_name=彩艳血&gameorder_no=&game_order_ext=&user_ip=61.183.116.90&sign=04bf0e78ced15f3932587552cedcf80a
    
  • 3.http://passport.51.com/qrcode/api/pay_imgopen in new window 链接拼接

    token生成规则(php)
    $redirect_url = "http://pay.51.com/h5/url/page?uid=400253473&gid=639&gamearea_id=1&time=1637310499&gamerole=223610094744846927&gamerole_name=彩艳血&gameorder_no=&game_order_ext=&user_ip=61.183.116.90&sign=04bf0e78ced15f3932587552cedcf80a";
    $token = md5($redirect_url.'token生成秘钥找薛磊索要');
    
    //其中"."为php字符串连接符,参数值直接拼接
    //本示例中token值为04bf0e78ced15f3932587552cedcf80a
    
    最终拼接请求的链接示例
    $redirect_url = "http://pay.51.com/h5/url/page?uid=400253473&gid=639&gamearea_id=1&time=1637310499&gamerole=223610094744846927&gamerole_name=彩艳血&gameorder_no=&game_order_ext=&user_ip=61.183.116.90&sign=04bf0e78ced15f3932587552cedcf80a";
    $token = md5($redirect_url.'token生成秘钥找薛磊索要');
     
    $data = urlencode($redirect_url);
    $passport = "http://passport.51.com/qrcode/api/pay_img?redirect_url=$data&token=$token";
    

最终链接: http://passport.51.com/qrcode/api/pay_img?redirect_url=http%3A%2F%2Fpay.51.com%2Fh5%2Furl%2Fpage%3Fuid%3D400253473%26gid%3D639%26gamearea_id%3D1%26time%3D1637310499%26gamerole%3D223610094744846927%26gamerole_name%3D彩艳血%26gameorder_no%3D%26game_order_ext%3D%26user_ip%3D61.183.116.90%26sign%3D04bf0e78ced15f3932587552cedcf80a&token=fe82868a058fe1bd316b65f508af1589open in new window