NetPayClient for PHP使用說明

標籤：安全   參與   password   字元   加密   使用   client   欄位   data   

名 稱 放置的路徑 用 途

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使用說明