【备忘】合付宝-灵工对接测试案例

前言

对于开发者来说，要对接的接口实在太多了，好一点的三方平台会有相关完善的接口文档，有些没有文档或者文档没有对应的demo，这样就给开发制造了很多麻烦。需要开发者把字段一个个的核对，文档仔细的阅读，不能偷懒，对于新手开发来说是个挑战；封装测试都需要花时间，不断试错，有的甚至给的证书都不对，最后测试才发现。

合付宝接口对接案例

由于没有详细的demo，只给了加密方法，和验签方法，所以本人测试通过后记录一下测试例子，方便以后阅读。

代码示例

/**
     * desc：同步用户信息
     * 文档地址：平台提供
     * 
     *
     * 响应码 响应信息
     * 0000 交易成功 0001 交易失败 0002 交易处理中 0003 图片格式有误 0004 请求数据异常，验签失败 1002 需求订单号重复
     * 1003 查无此需求订单号 1004 该需求已经是最终状态，不用进行上传凭证 2001 上传付款凭证图片有误 2002 未付款
     * 2003 待审核 2004 已撤销 2005 审核通过 2006 审核拒绝 2007 该需求订单还未打款成功，请先打款，上传凭证
     * 2008 佣金申请批次金额大于需求金额 2009 没有配置对应的手续费，请联系运营人员 2010 佣金申请的子订单号重复
     *
     * author：
     */
    function syncUserInfo(){
        $orderid = 'ord1234567890';
        if(empty($orderid)) return Tools::set_res(500,'订单错误');
        $phone = input('phone','13508380111');
        if(empty($phone)) return Tools::set_res(500,'手机号错误');
        $bank_no = input('bank_no','6222083100008554222');
        if(empty($bank_no)) return Tools::set_res(500,'订单错误');
        $name = input('name','name');
        if(empty($name)) return Tools::set_res(500,'银行卡号错误');
        $id_card = input('id_card','510230197211295111');
        if(empty($id_card)) return Tools::set_res(500,'收款人身份证号错误');
        $bankPhone = input('bank_phone','13508380333');
        if(empty($bankPhone)) return Tools::set_res(500,'收款人银行预留手机号错误');

        $bankName = '建设银行';

        $cardFrontUrl = input('cardFrontUrl','https://testabc.cn/uploads/20220330/47a55c91659008b637ae44ce0e96fb86.png');
        if(empty($cardFrontUrl)) return Tools::set_res(500,'身份证正面错误');
        $cardBackUrl = input('cardBackUrl','https://testabc.cn/uploads/20220330/255a98c39adb747e3551c0f03071f98f.png');
        if(empty($cardBackUrl)) return Tools::set_res(500,'身份证背面错误');

        $merchantNo = '123000004100';//平台提供的商户号
        
        $SecureUtilObj = (new SecureUtil());//平台提供的工具
        $post_params = [
            //客户编号
            'merchantNo'=>$merchantNo,
            'version'=>'v2',//必输    固定值：v2
            'tranCode'=>'lg1010',//必输    固定值：lg1010
            'tranFlow'=>$orderid,//必输    交易流水号
            'phone'=>$phone,//必输    登陆手机号（用于后期登陆公 众号使用）
            'accNo'=>$SecureUtilObj->encryptData($bank_no),//必输     accNo Char(128) 必输 银行卡号（加密传输）
            'accName'=>$SecureUtilObj->encryptData($name),//必输    姓名（加密传输）
            'certNo'=>$SecureUtilObj->encryptData($id_card),//必输    收款人身份证号（加密传输）
            'bankPhone'=>$bankPhone,//必输 收款人银行预留手机号
            'bankName'=>$bankName,//必输  银行名称
            'imageType'=>'url',
            'imgSuffix'=>$this->getImgSuffix($cardFrontUrl),//必输  图片格式 png/jpg/jpeg
            'cardFrontUrl'=>$cardFrontUrl,
            'cardBackUrl'=>$cardBackUrl,//当 imageType=url 时必输，身 份证背面照片 url 下载链接
        ];
        //特别注意的是，文档中特别标出要加密的字段，
        //必须先使用encryptData方法进行加密，然后再加签
        $post_params['sign'] = $SecureUtilObj->sign($post_params);

        //网关
        $url = 'https://lg.hefupal.com/group/api/lgOpen/lgpay';

        //开始提交请求（网上有很多curl库，自己封装）
        $api_res = Curl::curl_post($url,$post_params);

        dump($post_params);//打印参数
        dump($api_res);die;//打印请求结果

        //响应结果（按自己的业务逻辑处理）
        //客户编号 merchantNo char(16) 必输 原样返回
        // 接口版本号 version char(10) 必输 原样返回
        // 交易码 tranCode char(6) 必输 原样返回
        // 交易流水号 tranFlow char(32) 必输 交易流水号
        // 返回码 rtnCode char(6) 必输 详见：附录 7.2
        // 响应信息 rtnMsg char(100) 必输
        // 签名 sign char(512) 必输 交易签名
    }

小贴士：

这里只列出一个接口的加密、验签案例，其它接口原理都一样。

END