http://www.ChinaPay.com Chinapay新一代商户接入手册
3.4 NetPayClient的使用
说明
NetPayClient实现消费者、商户和银行间的网上安全支付。提供如下功能： ? ? ? ?
商户对订单关键信息进行数字签名 商户验证ChinaPay发送的交易应答 商户对一段字符串的签名 商户对一段字符串的签名验证
各语言NetPayClient压缩包见14章。 3.4.1
NetPayClient for Java 使用说明
3.4.1.1 核心文件清单
名 称 chinapaysecure.jar Chinapayfilesecure.jar Mer.pfx 放置的路径 根据项目工程的需要放置对应路径下 用 途 用于提供商户签名、验签、加密、解密方法调用 根据项目工程的需要放置对应路径下 用于提供商户验签结算和对账文件 可以放置到任意路径下，但是需要调用方法指定文件位置和名称 商户签名证书（控台申请） cp.cer 可以放置到任意路径下，但是需要调用方法指定文件位置和名称 ChinaPay签名证书 3.4.1.2 方法说明
类名 方法名 用 途 初始化商户签名、验签配置信息 用于对商户报文进行签名 获取商户签名值 对交易过程中的敏感数据进行加密 对密码进行加密 获取加密后的密码字符串 获取加密后的密文字符串 验证chinapay返回的应答数据 获取商户签名、验签、加密及解密的处理结果 com.chinapay.secss.SecssUtil init sign getSign encryptData encryptPin getEncPin getEncValue verify getErrCode init SecssFileService verifyFile getErrCode 初始化商户签名、验签配置信息 文件验签 获取商户签名、验签、加密及解密的处理结果 第 6 页 共 35 页
http://www.ChinaPay.com Chinapay新一代商户接入手册
?
初始化安全控件方法：init
方法说明：
public boolean init() 作用：
初始化商户签名、验签配置信息。
使用此方法需要将security.properties放在类路径下，并配置如下： #交易证书路径
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 参数说明：
security.properties文件中，商户只需要修改sign.file、sign.file.password、verify.file三项。 返回值：
true ：表示正确初始化证书文件,并且可以调用签名方法签名或者签名验证方法验证签名； false：表示初始化证书文件失败，不可以使用签名方法和签名验证方法。 注：该方法在类com.chinapay.secss.SecssUtil中。
方法说明：
public boolean init(Properties pros) 作用：
初始化商户签名、验签配置信息。 参数说明：
Properties pros 属性配置文件对象，用于加载商户自定义的属性配置文件，需要在该文件中配置商户签名证书文件绝对路径、签名文件密码、密钥容器格式、验证签名证书文件绝对路径、签名值和证书id、签名值字段名称等。
返回值：
true ：表示正确初始化证书文件,并且可以调用签名方法签名或者签名验证方法验证签名； false：表示初始化证书文件失败，不可以使用签名方法和签名验证方法。 注：该方法在类com.chinapay.secss.SecssUtil中。 ?
订单签名方法：sign 方法说明：
public void sign(Map map) 作用：
用于对商户报文进行签名。
第 7 页 共 35 页
http://www.ChinaPay.com Chinapay新一代商户接入手册
参数说明：
Map map 为商户交易数据。 返回值： 无
注：该方法在类com.chinapay.secss.SecssUtil中。 ?
获取签名结果字符串方法：getSign 方法说明：
public String getSign() 作用：
获取商户签名后生成的字符串。 参数说明： 无 返回值：
商户签名结果字符串。
注：该方法在类com.chinapay.secss.SecssUtil中。 ?
敏感数据加密方法：encryptData 方法说明：
public void encryptData(String data) 作用：
对交易过程中的敏感数据进行加密。 参数说明：
String data 待加密的明文字符串 返回值： 无 ?
密码加密方法：encryptPin 方法说明：
public void encryptPin(String pin,String card) 作用：
对密码进行加密。 参数说明：
String pin 银行卡密码 String card 卡号 返回值： 无 ?
获取加密后的密码：getEncPin 方法说明：
public String getEncPin() 作用：
获取加密后的密码字符串。 参数说明： 无 返回值：
第 8 页 共 35 页
http://www.ChinaPay.com Chinapay新一代商户接入手册
加密后的密码字符串。 ?
获取加密后的密文字符串：getEncValue 方法说明：
public String getEncValue() 作用：
获取加密后的密文字符串。 参数说明： 无 返回值：
加密后的密文字符串。 ?
获取商户签名、验签、加密及解密的处理结果的方法：getErrCode 方法说明：
public String getErrCode() 作用：
获取商户签名、验签、加密及解密的处理结果。 参数说明： 无 返回值：
00表示处理成功，其他表示处理失败。
注：该方法在类com.chinapay.secss.SecssUtil中。
第 9 页 共 35 页
http://www.ChinaPay.com Chinapay新一代商户接入手册
?
验证交易应答方法：verify
方法说明：
public void verify(Map map) 作用：
验证chinapay返回的应答数据。 参数说明：
Map map 返回商户报文中的所有参数。 返回值： 无
注：该方法在类com.chinapay.secss.SecssUtil中。 ?
文件验签方法：verifyFile 方法说明：
public void verifyFile(String path) 作用：
验证chinapay返回的文件签名。 参数说明： 文件路径。 返回值： 无 ?
注：该方法在类com.chinapay.secss.SecssUtil中。
3.4.1.3 使用示例代码
（以下代码未经测试，仅供参考）
?
签名示例代码 //初始化安全控件：
public static void main(String[] args) {
Map
myMap.put(\myMap.put(\??
SecssUtil secssUtil = new SecssUtil(); //从默认配置文件初始化安全控件 secssUtil.init();
System.out.println(\未知错误测试-->\secssUtil.sign(myMap);
if(!\ }
String sign = secssUtil.getSign(); System.out.println(\
第 10 页 共 35 页
System.out.println(\签名过程发生错误，错误信息为-->\return;
百度搜索“77cn”或“免费范文网”即可找到本站免费阅读全部范文。收藏本站方便下次阅读，免费范文网，提供经典小说综合文库新一代商户接入手册V2.7(2)在线全文阅读。
相关推荐：