首页 > 代码库 > NetPayClient for PHP使用说明

NetPayClient for PHP使用说明

名 称 放置的路径 用 途

SecssUtil.class.php 根据项目工程的需要放置对应路径下 支持PHP5.4.8及以上版本
用于提供商户签名、验签、加密、解密、文件验签等方法调用

Mer.pfx 可以放置到任意路径下,但是需要调用方法指定文件位置和名称 商户签名证书(控台申请)

cp.cer 可以放置到任意路径下,但是需要调用方法指定文件位置和名称 ChinaPay签名证书(公钥)

security.properties 安全配置文件,根据项目工程的需要放置对应路径下 指定签名验签证书文件存放路径等

=====================================================================================================================

类名:SecssUtil

方法简述:

方法名 用途

init 用于创建证书对象,初始化安全加密控件并初始化公私钥信息

sign 用于对商户报文进行签名

getSign 获取商户签名后生成的字符串

verify 验证ChinaPay返回的应答数据

verifyFile 验证ChinaPay返回的结算和对账文件签名

encryptData 对交易过程中的敏感数据进行加密

getEncValue 获取加密后的密文字符串

decryptData 对交易过程中的敏感数据进行解密

getDecValue 获取解密后的明文字符串

encryptPin 对密码进行加密

getEncPin 获取加密后的密码字符串

getErrCode 获取商户签名、验签、加密及解密的处理结果

getErrMsg 获取对响应码的中文描述

=====================================================================================================================

初始化安全控件方法: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中。

NetPayClient for PHP使用说明