Hoyo 教你串金流 | hoyo 學習紀錄

Hoyo 提供原廠都沒有的測試工具

金流：綠界串接測試

—

下載綠界串接文件

API/SDK串接下載

需要下載「全方位金流 API 技術文件」以及「PHP SDK」

撰寫文件時為 2018-6-29 , API 文件版本 5.1.17

—

流程

雖然金流 API 文件第 2 章有交易流程說明，可是第一次使用看懂的機率是極低的，所以 Hoyo 另外整理為

送出一個訂單表單送到「介接路徑」
準備接收綠界付款結果的資訊

—

訂單表單

網頁表單 – f.html

<!DOCTYPE html>

<html>

<head>

<style>

label{

display: block;

}

</style>

</head>

<body>

<label>動作 (Action):<input type="text" name="ServiceURL" value="https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5" class="form-control"/></label>

<label>編號 (MerchantTradeNo):

不可重複使用。英數字大小寫混合

</label>

<label class="col-xs-12">時間 (MerchantTradeDate):

yyyy/MM/dd HH:mm:ss

</label>

<label class="col-xs-12">類型 (PaymentType):

aio

</label>

<label class="col-xs-12">金額 (TotalAmount):

請帶整數，不可有小數點僅限新台幣金額不可為 0 元 CVS&BARCODE 最低限制為 30 元，最高限制為 30,000 元

</label>

<label class="col-xs-12">描述 (TradeDesc):

</label>

<label class="col-xs-12">名稱 (ItemName):

商品名稱以符號 # 分

</label>

<label class="col-xs-12">回傳網址 (ReturnURL):

</label>

<label class="col-xs-12">付款方式 (ChoosePayment):

Credit:信用卡及 AndroidPay AndroidPay: AndroidPay WebATM:網路 ATM ATM:自動櫃員機 CVS:超商代碼 BARCODE:超商條碼 ALL:不指定

</label>

<button type="submit" class="btn btn-default">綠界線上支付</button>

</form>

</body>

</html>

MerchantTradeNo : 訂單編號，一個編號只能用一次，所以針對實際情況不能直接將網站的訂單編號送出，必須使用一個對應的變動編號，這個問題後面再討論
ReturnURL : 必須要可以對外訪問的網址，所以沒有自己的網站是不能接線上支付 (沒有意義)
MerchantID : 測試的商家 value 都要根據 API 文件設定
HashKey 同上
HashIV 同上

送給 PHP 計算 CheckMacValue – Ecpay.php

<?php

require_once 'ECPay.Payment.Integration.php';

$obj = new \ECPay_AllInOne();

//服務參數

$obj->ServiceURL = $_POST['ServiceURL'];

$obj->HashKey = $_POST['HashKey'];

$obj->HashIV = $_POST['HashIV'];

$obj->MerchantID = $_POST['MerchantID'];

$obj->Send['MerchantTradeNo'] = $_POST['MerchantTradeNo'];

$obj->Send['MerchantTradeDate'] = $_POST['MerchantTradeDate'];

$obj->Send['PaymentType'] = $_POST['PaymentType'];

$obj->Send['TotalAmount'] = (int)$_POST['TotalAmount'];

$obj->Send['TradeDesc'] = $_POST['TradeDesc'];

$obj->Send['ReturnURL'] = $_POST['ReturnURL'];

$obj->Send['ChoosePayment'] = $_POST['ChoosePayment'];

$obj->Send['CreditInstallment'] = $_POST['CreditInstallment'];

//訂單的商品資料

array_push($obj->Send['Items'], array(

'Name' => 'aaa',

'Price' => 100,

'Currency' => "元",

'Quantity' => (int)"1"

)

);

//產生訂單(auto submit至ECPay)

//$obj->CheckOut();

$Response = (string)$obj->CheckOutString();

echo $Response;

// 自動將表單送出

echo '<script>document.getElementById("__ecpayForm").submit();</script>';

PHP 的作用只有計算 CheckMacValue 這個值之後附加到表單再送到綠界
送出之後的所有錯誤綠界都會清楚的回應

—

接收付款結果資訊

payEcpay.php

<?php

require_once 'ECPay.Payment.Integration.php';

// 將 post 資料轉成字串儲存 SaveData

$String = print_r( $_POST, true );

file_put_contents( '/tmp/ECPay.txt', $String, FILE_APPEND );

define( 'ECPay_MerchantID', '2000132' );

define( 'ECPay_HashKey', '5294y06JbISpM5x9' );

define( 'ECPay_HashIV', 'v77hoKGq4kWxNNIS' );

// 重新整理回傳參數。

$arParameters = $_POST;

foreach ($arParameters as $keys => $value) {

if ($keys != 'CheckMacValue') {

if ($keys == 'PaymentType') {

$value = str_replace('_CVS', '', $value);

$value = str_replace('_BARCODE', '', $value);

$value = str_replace('_CreditCard', '', $value);

}

if ($keys == 'PeriodType') {

$value = str_replace('Y', 'Year', $value);

$value = str_replace('M', 'Month', $value);

$value = str_replace('D', 'Day', $value);

}

$arFeedback[$keys] = $value;

}

// 計算出 CheckMacValue

$CheckMacValue = ECPay_CheckMacValue::generate( $arParameters, ECPay_HashKey, ECPay_HashIV );

// 必須要支付成功並且驗證碼正確

if ( $_POST['RtnCode'] =='1' && $CheckMacValue == $_POST['CheckMacValue'] ){

// 要處理的程式放在這裡，例如將線上服務啟用、更新訂單資料庫付款資訊等

}

// 接收到資訊回應綠界

echo '1|OK';

根據回傳格式說明，至少要成功支付以及驗證碼正確才進行後續處理，否則可能是造假回傳資訊

—

模擬綠界回傳表單

可以自己設計表單模擬綠界回傳送出資訊，方便接收除錯

<!DOCTYPE html>

<html>

<head>

</head>

<body>

</form>

</body>

</html>

—

綠界回傳資訊

使用 print_r($_POST); 把回傳資訊展開大概就是長這樣

Array

(

[MerchantID] => 2000132

[MerchantTradeNo] => ABC1486720783

[PayAmt] => 1000

[PaymentDate] => 2017/02/10 18:00:29

[PaymentType] => Credit_CreditCard

[PaymentTypeChargeFee] => 50

[RedeemAmt] => 0

[RtnCode] => 1

[RtnMsg] => 交易成功

[SimulatePaid] => 0

[TradeAmt] => 1000

[TradeDate] => 2017/02/10 17:59:49

[TradeNo] => 1702101759496095

[CheckMacValue] => 35409F1AAF0509FC055BAE340899F6BBB37AE303D49B3C00CCF264A0645E5DFD

)

—

18,569 total views, 6 views today

hoyo 學習紀錄

PHP 網頁應用 IOT 物聯網自動化

Category Archives: Hoyo 教你串金流

Hoyo 教你串金流 – 綠界

Hoyo 提供原廠都沒有的測試工具

下載綠界串接文件

流程

訂單表單

接收付款結果資訊

模擬綠界回傳表單

綠界回傳資訊