PHPackages earnp/zmxy - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Framework](/categories/framework) 4. / 5. earnp/zmxy ActiveLibrary[Framework](/categories/framework) earnp/zmxy ========== Laravel 5 Zmxy Package 111144[3 issues](https://github.com/earnp/laravel5-zmxy/issues)PHP Since Sep 1Pushed 8y ago1 watchersCompare [ Source](https://github.com/earnp/laravel5-zmxy)[ Packagist](https://packagist.org/packages/earnp/zmxy)[ RSS](/packages/earnp-zmxy/feed)WikiDiscussions master Synced today READMEChangelogDependenciesVersions (1)Used By (0) 芝麻信用是支付宝根据用户信息返回风控风险以及用户信用评分，主要用于：`P2P网贷`,`租车`,`共享经济信用评分`,`旅行或者酒店类`等中，芝麻信用接口比较多，如果自己单独去开发，会浪费一定的时间，所以我集成了Laravel芝麻信用拓展，方便大家学习管理，如果由任何疑问，欢迎 #### 开发前的准备 [](#开发前的准备) 1. 安装Laravel 2. 申请通过[芝麻商家](https://b.zmxy.com.cn/login/index.htm) 3. 创建一个应用并且获取基本配置信息，详细流程[开始接入](https://b.zmxy.com.cn/technology/openDoc.htm?relInfo=MERCHANT_ENTERING) #### 安装拓展 [](#安装拓展) 1.在 `composer.json` 的 `require` 里面加入以下内容： ``` composer require "earnp/zmxy:dev-master" ``` 2.等待下载安装完成，需要在`config/app.php`中注册服务提供者同时注册下相应门面： ``` 'providers' => [ //........ Earnp\Zmxy\ZmxyServiceprovider::class, ], 'aliases' => [ //.......... 'Zmxy' => Earnp\Zmxy\Facades\Zmxy::class, ], ``` 服务注入以后，如果要使用自定义的配置，还可以发布配置文件到config目录： ``` php artisan vendor:publish ``` #### 使用方法 [](#使用方法) ##### 获取登陆授权链接 [](#获取登陆授权链接) ``` Zmxy::ZhimaAuthInfoAuthorize($name,$idcard); ``` 参数说明： - $name为用户姓名 - $idcard为用户身份证号码 返回参数： ``` https://zmopenapi.zmxy.com.cn/openapi.do?app_id=1000000&channel=apppc&charset=UTF-8&method=zhima.auth.info.authorize&platform=zmop&sign=sign&version=1.0¶ms=params ``` 将会返回授权链接，你将链接设置为a标签，给用户点击使用，注意：授权成功以后会返回您授权的地址，将会给你返回`$sign`和`$params`参数用于下面的获取参数 ##### 根据获取的`$params`换取`open_id` [](#根据获取的params换取open_id) ``` Zmxy::getResult($params,$sign); ``` 参数说明： - $params为上一部中授权返回的参数 - $sign为上一部中授权返回的参数 返回参数： ``` [ "open_id" => "", "error_message" => "操作成功", "state" => "您传入的身份证号码", "error_code" => "SUCCESS", "app_id" => "1004070", "success" => "true", ] ``` **注意**：state你可以自定义传入参数，用于判断用户，默认我返回的是用户身份证 ##### 芝麻信用评分 [](#芝麻信用评分) ``` Zmxy::ZhimaCreditScoreGetRequest($open_id); ``` 请求参数: - $open\_id为上一步获取到的$open\_id 返回参数(对象)： ``` [ "success"=>true, "biz_no"=>"", // 以后芝麻分 "zm_score"=>"750", ] ``` ##### 行业关注名单 [](#行业关注名单) ``` Zmxy::ZhimaCreditWatchlistiiGet($open_id); ``` 请求参数: - $open\_id为上面授权获取到的$open\_id 返回参数(对象)： 返回参数比较多，具体可以参考官方文档： #### 申请欺诈评分 [](#申请欺诈评分) ``` $data = array("idcard"=>"必须","name"=>"必须","phone"=>"必须","email"=>"选填","bankcard"=>"选填:银行卡号","address"=>"选填:不要包含特殊字符","ip"=>"ip地址:选填","mac"=>"物理地址:选填","wifimac"=>"wifi的物理地址:选填","imei"=>"国际移动设备标志:选填"); // 调取接口 Zmxy::ZhimaCreditAntifraudScoreGet($data); ``` 请求参数： - $data,包含查询用户基本信息，无需授权，姓名身份证必须准确，更多描述查看[芝麻信用](https://b.zmxy.com.cn/technology/openDoc.htm?relInfo=zhima.credit.antifraud.score.get@1.0@1.1&relType=API_DOC&LEFT_MENU_MODE=null&view_mode=null) 返回参数(对象)： ``` [ "success"=>true, "biz_no"=> "", "score"=>88, ] ``` `score` 为信用评分，分值越高，欺诈越小 #### 欺诈信息验证 [](#欺诈信息验证) ``` $data = array("idcard"=>"必须","name"=>"必须","phone"=>"必须","email"=>"选填","bankcard"=>"选填:银行卡号","address"=>"选填:不要包含特殊字符","ip"=>"ip地址:选填","mac"=>"物理地址:选填","wifimac"=>"wifi的物理地址:选填","imei"=>"国际移动设备标志:选填"); // 调取接口 Zmxy::ZhimaCreditAntifraudVerify($data); ``` 请求参数： - $data,包含查询用户基本信息，无需授权，姓名身份证必须准确，更多描述查看[芝麻信用](https://b.zmxy.com.cn/technology/openDoc.htm?relInfo=zhima.credit.antifraud.score.get@1.0@1.1&relType=API_DOC&LEFT_MENU_MODE=null&view_mode=null) 返回参数（对象）： ``` [ "success"=>true, "biz_no"=> "", "verify_code"=> [ 0 => "V_CN_NM_MA", 1 => "V_PH_CN_MA_UL30D", 2 => "V_EM_CN_MA", 3 => "V_AD_CN_MA_UL180D", 4 => "V_AD_CN_MA_HOME", ] ] ``` verify\_code中的参数说明如下： 在`config/zmxy.php`中 #### 欺诈关注清单 [](#欺诈关注清单) ``` $data = array("idcard"=>"必须","name"=>"必须","phone"=>"必须","email"=>"选填","bankcard"=>"选填:银行卡号","address"=>"选填:不要包含特殊字符","ip"=>"ip地址:选填","mac"=>"物理地址:选填","wifimac"=>"wifi的物理地址:选填","imei"=>"国际移动设备标志:选填"); // 调取接口 Zmxy::ZhimaCreditAntifraudRiskList($data); ``` 参数说明： - 如上所说 返回参数： ``` [ "success"=>true, "biz_no"=>"", "hit"=>"yes", "risk_code"=>[ 0 => "R_CN_JJ_02", 1 => "R_CN_JJ_03", 2 => "R_PH_006", 3 => "R_PH_JJ_02", 4 => "R_PH_JJ_03", ] ] ``` verify\_code代表风险级别，其中的参数说明如下： 在`config/zmxy.php`中 #### 芝麻认证 [](#芝麻认证) ##### 1、芝麻认证初始化 [](#1芝麻认证初始化) ``` Zmxy::ZhimaCustomerCertificationInitialize("name","idcard"); ``` 请求参数： - `name`代表用户姓名 - `idcard`代表身份证号码 返回参数： ``` { "success"=>true, "biz_no"=>"ZM2017123123123123100500333662", } ``` ##### 2、芝麻认证开始认证 [](#2芝麻认证开始认证) ``` Zmxy::ZhimaCustomerCertificationCertify($biz_no,$returnurl); ``` 请求参数： - `biz_no`为上一部中获取到的`biz_no` - `returnurl`代表验证后转到的网址，可在下一步中获取参数 返回参数： ``` https://zmopenapi.zmxy.com.cn/openapi.do?app_id=1004070&channel=apppc&charset=UTF-8&method=zhima.customer.certification.certify&platform=zmop&sign=2&version=1.0¶ms=2 ``` 将会返回授权链接，你将链接设置为a标签，给用户点击使用，注意：授权成功以后会返回您授权的地址，将会给你返回`$sign`和`$params`参数用于下面的获取参数 ##### 3、根据获取的`$params`解密验签 [](#3根据获取的params解密验签) ``` Zmxy::getResult($params,$sign); ``` 本步也为第二步认证后返回结果，解密获取到基本参数,到这里可以存储，后期长期使用查询 参数说明： - $params为上一部中授权返回的参数 - $sign为上一部中授权返回的参数 返回参数： ``` [ "passed" => "true", "biz_no" => "ZM201708023000000123400501230048", ] ``` ##### 4、芝麻认证查询 [](#4芝麻认证查询) ``` Zmxy::ZhimaCustomerCertificationQuery($biz_no); ``` 请求参数： - `biz_no`为上一部中验证后解密验签获取到的`biz_no` 返回参数：[参数说明](https://b.zmxy.com.cn/technology/openDoc.htm?relInfo=zhima.customer.certification.query@1.0@1.3) ``` { "success"=>true "channel_statuses"=>"[{"name"=>"FACE","status"=>"PASS"}]" "identity_info"=>"{"cert_name"=>"姓名","cert_no"=>"身份证","cert_type"=>"IDENTITY_CARD"}" "passed"=>"true" } ``` 好的，到这里全部接口完毕，注意：`open_id`，`biz_no`可以长期使用，做好留存，除非用户取消授权或者重新授权；后期会持续迭代，欢迎讨论以及给星！ ### Health Score 23 — LowBetter than 27% of packages Maintenance15 Infrequent updates — may be unmaintained Popularity19 Limited adoption so far Community9 Small or concentrated contributor base Maturity41 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://avatars.githubusercontent.com/u/6835447?v=4)[lusong](/maintainers/lusong)[@Lusong](https://github.com/Lusong) --- Top Contributors [![kuwo88](https://avatars.githubusercontent.com/u/19774487?v=4)](https://github.com/kuwo88 "kuwo88 (10 commits)") ### Embed Badge ![Health badge](/badges/earnp-zmxy/health.svg) ``` [![Health](https://phpackages.com/badges/earnp-zmxy/health.svg)](https://phpackages.com/packages/earnp-zmxy) ``` ### Alternatives [laravel/telescope An elegant debug assistant for the Laravel framework. 5.2k67.8M192](/packages/laravel-telescope)[spiral/roadrunner RoadRunner: High-performance PHP application server and process manager written in Go and powered with plugins 8.4k12.2M84](/packages/spiral-roadrunner)[nolimits4web/swiper Most modern mobile touch slider and framework with hardware accelerated transitions 41.8k177.2k1](/packages/nolimits4web-swiper)[laravel/dusk Laravel Dusk provides simple end-to-end testing and browser automation. 1.9k36.7M259](/packages/laravel-dusk)[laravel/prompts Add beautiful and user-friendly forms to your command-line applications. 708181.8M596](/packages/laravel-prompts)[cakephp/chronos A simple API extension for DateTime. 1.4k47.7M121](/packages/cakephp-chronos) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)