銀聯電子支付報文說明

請求報文
Version    版本號
MerId    商戶號
MerOrderNo    必填，變長 32位，同一商戶同一交易日期內不可重復
TranDate    商戶提交交易的日期，例如交易日期為2015年1月2日，則值為20150102
TranTime    商戶提交交易的時間，例如交易時間10點11分22秒，則值為101122
OrderAmt    單位：分
BusiType    0001（注意：字符串類型）
MerPageUrl    0    商戶前台頁面接收交易結果的地址，用於引導使用者支付后返回商戶網站頁面
MerBgUrl    商戶后台接收交易結果的地址
CommodityMsg    0    用來描述購買商品的信息，ChinaPay原樣返回
MerResv    0    商戶自定義，ChinaPay原樣返回

Signature    商戶報文簽名信息，報文中的所有字段都參與簽名（Signature除外）

應答報文
* MerId    商戶號
* MerOrderNo    商戶訂單號
* TranDate    交易日期 年月日
* TranTime    交易時間 時分秒
* OrderAmt    訂單金額 單位分
* OrderStatus    訂單支付狀態 0000為支付成功狀態，0001為未支付，其它為失敗狀態
* MerResv    商戶私有域 自定義原樣返回
* TranReserved    交易擴展域    json格式 原樣返回
* Signature    簽名

1、開發過程中，商戶簽名報SecurityException異常

檢查交易證書密碼是否配置正確，並檢查配置文件security.properties是否配置正確。

需要將security.properties放在類路徑下，並配置如下：

#交易證書路徑

sign.file=D:/cert_cp/000000000000001.pfx

#交易證書密碼

sign.file.password=123456

#交易證書的密鑰容器格式

sign.cert.type=PKCS12

#報文中不參與簽名的字段名稱，多個字段用逗號進行分隔

sign.invalid.fields=Signature,CertId

#驗簽證書路徑

verify.file=D:/cert_cp/cp_test.cer

#簽名值字段名稱

signature.field=Signature

2、開發過程中，商戶簽名報“未初始化配置”異常

檢查簽名或驗簽之前是否調用SecssUtil.init();方法，如果未調用，則調用SecssUtil.init()方法初始化安全簽名配置

3、簽名過程出現 Illegal key size錯誤

請檢查下載的pfx證書是否正確，或者重新申請CFCA交易證書

4、交易失敗！錯誤信息：證書未配置

這個報錯通常有兩個原因，一是沒有申請交易證書，二是交易地址提交錯誤，測試地址和正式地址搞錯了。

5、交易失敗！錯誤信息：驗簽失敗。

需要確認交易證書在Internet選項---內容---證書---頒發給的名字和在商戶服務管理系統里面查到的交易證書的證書名稱是一樣的。
證書確認沒有問題，需要確認參加簽名的字段和傳過來的字段是一樣的。


簽名示例代碼

require 'SecssUtil.class.php';

$securityPropFile="D:/Zend/workspaces/DefaultWorkspace12/chinapaySECSS_PHP/security.properties";

$paramArray=array(

"AcqCode"=>"000000000000014",

"BankInstNo"=>"",

"BusiType"=>"0001",

"CommodityMsg"=>"ChinaPay測試-商品信息",

"CurryNo"=> "CNY",

" AccessType"=>"0",

" MerBgUrl"=>"http://172.16.9.233:9080/CPOA_TEST/mer/receiveStdasServlet",

" MerPageUrl"=>"http://172.16.9.233:9080/CPOA_TEST/receive",

" MerSplitMsg"=>"");

$secssUtil = new SecssUtil();

$secssUtil->init($securityPropFile); //初始化安全控件：

$secssUtil->sign($paramArray);

if("00"!==$secssUtil.getErrCode()){

echo"簽名過程發生錯誤，錯誤信息為-->".$secssUtil.getErrMsg();

return;

}

$signature==$secssUtil->getSign();

echo "簽名數據為:".$signature;

 

驗證簽名示例代碼

require 'SecssUtil.class.php';

$securityPropFile="D:/Zend/workspaces/DefaultWorkspace12/chinapaySECSS_PHP/security.properties";

$paramArray=array(

"AcqCode"=>"000000000000014",

"BankInstNo"=>"",

"BusiType"=>"0001",

"CommodityMsg"=>"ChinaPay測試-商品信息",

"CurryNo"=> "CNY",

" AccessType"=>"0",

" MerBgUrl"=>"http://172.16.9.233:9080/CPOA_TEST/mer/receiveStdasServlet",

" MerPageUrl"=>"http://172.16.9.233:9080/CPOA_TEST/receive",

" MerSplitMsg"=>"",

"Signature"=>"………"

);

$secssUtil = new SecssUtil();

$secssUtil->init($securityPropFile); //初始化安全控件：

$secssUtil->verify($paramArray);

if("00"!==$secssUtil.getErrCode()){

echo"驗簽過程發生錯誤，錯誤信息為-->".$secssUtil.getErrMsg();

return;

}

echo "驗簽通過。";

敏感數據加密示例代碼

require 'SecssUtil.class.php';

$securityPropFile="D:/Zend/workspaces/DefaultWorkspace12/chinapaySECSS_PHP/security.properties";

$plainData="testtest";

$secssUtil = new SecssUtil();

$secssUtil->init($securityPropFile); //初始化安全控件：

$secssUtil->encryptData ($plainData);

if("00"!==$secssUtil.getErrCode()){

echo"加密過程發生錯誤，錯誤信息為-->".$secssUtil.getErrMsg();

return;

}

echo "加密后的密文為：".$secssUtil->getEncValue();

 

密碼加密示例代碼

require 'SecssUtil.class.php';

$securityPropFile="D:/Zend/workspaces/DefaultWorkspace12/chinapaySECSS_PHP/security.properties";

$card="6225882125408888";

$pin="123456";

$secssUtil = new SecssUtil();

$secssUtil->init($securityPropFile); //初始化安全控件：

$secssUtil->encryptPin($pin, $card);

if("00"!==$secssUtil.getErrCode()){

echo"密碼加密過程發生錯誤，錯誤信息為-->".$secssUtil.getErrMsg();

return;

}

echo "加密后的PIN密文為：".$secssUtil->getEncPin();

文件驗簽示例代碼

require ' SecssUtil.class.php';

$securityPropFile="D:/Zend/workspaces/DefaultWorkspace12/chinapaySECSS_PHP/security.properties";

$secssUtil = new SecssUtil();

$secssUtil->init($securityPropFile);

$file="D:/Zend/workspaces/DefaultWorkspace12/ChinaPaySECSS_PHP/測試文件.txt";

echo "verify start time".date('y-m-d h:i:s',time())."\r\n";

$secssUtil->verifyFile($file);

if("00"===$secssUtil->getErrCode()){

echo "文件驗簽成功，errcode=[" .$secssUtil->getErrCode()."]\r\n";

}else{

echo "文件驗簽失敗，errcode=[" .$secssUtil->getErrCode()."]\r\n";

}

echo "verify end time".date('y-m-d h:i:s',time())."\r\n";