发布时间 : 星期一 文章新一代商户接入手册V2.7更新完毕开始阅读2bb1ce79b0717fd5370cdc2d
http://www.ChinaPay.com Chinapay新一代商户接入手册
3.4.2.2 方法说明
类名 SecssUtil 方法名 init sign getSign verify verifyFile encryptData encryptPin getEncPin getEncValue getErrCode getErrMsg 用途 用于创建证书对象，初始化安全加密控件并初始化公私钥信息 用于对商户报文进行签名 获取商户签名后生成的字符串 验证ChinaPay返回的应答数据 验证ChinaPay返回的结算和对账文件签名 对交易过程中的敏感数据进行加密 对密码进行加密 获取加密后的密码字符串 获取加密后的密文字符串 获取商户签名、验签、加密及解密的处理结果 获取对响应码的中文描述 ?
初始化安全控件方法：init 方法说明：
public function init($securityPropFile) 作用：
用于创建证书对象，初始化安全加密控件并初始化公私钥信息。
使用此方法需要将security.properties放在PHP项目路径下，并配置如下： #交易证书路径
sign.file=D:/cert_cp/000000000000001.pfx #交易证书密码
sign.file.password=XXXXXX #交易证书的密钥容器格式 sign.cert.type=PKCS12
#报文中不参与签名的字段名称，多个字段用逗号进行分隔 sign.invalid.fields=Signature,CertId #验签证书路径
verify.file=D:/cert_cp/cp_test.cer #签名值字段名称
signature.field=Signature 参数说明：
securityPropFile：security.properties文件全路径
security.properties文件中，商户只需要修改sign.file、sign.file.password、verify.file三项。 返回值：
true ：表示正确初始化证书文件,并且可以调用签名方法签名或者签名验证方法验证签名； false：表示初始化证书文件失败，不可以使用签名方法和签名验证方法。 注：该方法在类SecssUtil中。 ?
订单签名方法：sign
第 13 页 共 35 页
http://www.ChinaPay.com Chinapay新一代商户接入手册
方法说明：
public function sign($paramArray) 作用：
用于对商户报文进行签名。 参数说明：
$paramArray 为数组形式的商户交易数据。数组格式如： array(\MerOrderNo \
返回值： 无 ?
获取签名结果字符串方法：getSign 方法说明：
public function getSign() 作用：
获取商户签名后生成的字符串。 参数说明： 无 返回值：
商户签名结果字符串。
注：该方法在类SecssUtil中。 ?
验证交易应答方法：verify 方法说明：
public function verify($paramArray) 作用：
验证chinapay返回的应答数据。 参数说明：
$paramArray 返回商户报文中的所有参数。 返回值： 无
注：该方法在类SecssUtil中。 ?
验证文件方法：verifyFile 方法说明：
public function verifyFile($file) 作用：
验证结算和对账文件签名。 参数说明： $file文件路径 返回值： 无
注：该方法在类SecssUtil中。 ?
敏感数据加密方法：encryptData 方法说明：
public function encryptData($data) 作用：
第 14 页 共 35 页
http://www.ChinaPay.com Chinapay新一代商户接入手册
对交易过程中的敏感数据进行加密。 参数说明：
$data 待加密的明文字符串 返回值： 无
注：该方法在类SecssUtil中。 ?
密码加密方法：encryptPin 方法说明：
public function encryptPin($pin, $card) 作用：
对密码进行加密。 参数说明： $pin 银行卡密码 $card 卡号 返回值： 无
注：该方法在类SecssUtil中。 ?
获取加密后的密码：getEncPin 方法说明：
public function getEncPin() 作用：
获取加密后的密码字符串。 参数说明： 无 返回值：
加密后的密码字符串。
注：该方法在类SecssUtil中。 ?
获取加密后的密文字符串：getEncValue 方法说明：
public function getEncValue() 作用：
获取加密后的密文字符串。 参数说明： 无 返回值：
加密后的密文字符串。
注：该方法在类SecssUtil中。 ?
获取商户签名、验签、加密及解密的处理结果的方法：getErrCode 方法说明：
public function getErrCode() 作用：
获取商户签名、验签、加密及解密的处理结果。 参数说明：
第 15 页 共 35 页
http://www.ChinaPay.com Chinapay新一代商户接入手册
无 返回值：
00表示处理成功，其他表示处理失败。 注：该方法在类SecssUtil中。 ?
响应码描述信息：getErrMsg 方法说明：
public function getErrMsg() 作用：
获取对响应码的中文描述。 参数说明： 无 返回值：
响应码的中文描述。
注：该方法在类SecssUtil中。
3.4.2.3 使用示例代码
（以下代码未经测试，仅供参考）
?
签名示例代码
require 'SecssUtil.class.php';
$securityPropFile=\perties\
$paramArray=array(
\\\
\测试-商品信息\\\ AccessType\
\ MerBgUrl\\ MerPageUrl\\
$secssUtil = new SecssUtil();
$secssUtil->init($securityPropFile); //初始化安全控件： $secssUtil->sign($paramArray); if(\
echo\签名过程发生错误，错误信息为-->\ }
$signature==$secssUtil->getSign(); echo \签名数据为:\ ?
验证签名示例代码
第 16 页 共 35 页
return;