交易expiredate

MPG技術串接手冊智通數位科技股份有限公司網路互聯.
通道整合.
支付金流.
核心技術智付通第三方支付金流服務平台MPG技術串接手冊金流版程式版本號:1.
4文件版本號:MPG_1.
1.
0(文件為智通數位科技股份有限公司版權所有)MPG技術串接手冊智通數位科技股份有限公司1網路互聯.
通道整合.
支付金流.
核心技術版本異動說明列表異動序號文件版本號修改內容日期1MPG_1.
0.
0初版2016/06/012MPG_1.
0.
1修正[測試串接網址]與[正式串接網址]2016/06/133MPG_1.
0.
2第六章新增[條碼繳費]付款人繳費時,收款超商的代碼.
2016/08/084MPG_1.
0.
31.
新增[銀聯卡]支付流程說明與相關參數.
2.
移除國旅卡相關說明與參數.
2016/10/245MPG_1.
0.
41.
程式版號變更為1.
42.
第四章新增參數[MerchantID]、[TradeInfo]、[TradeSha]與相對應說明(第17頁)3.
第六章新增參數[Status]、[MerchantID]、[TradeInfo]、[TradeSha]、[Result]與相對應說明,及範例程式(第27頁)4.
第七章增參數[Status]、[MerchantID]、[TradeInfo]、[TradeSha]、[Result]與相對應說明,及範例程式(第32頁)5.
新增[八、交易資料AES加解密]說明(第36頁)6.
新增[九、交易資料SHA256加密]說明(第37頁)2017/02/086MPG_1.
0.
51.
新增支付項目[信用卡紅利折抵]與相關參數說明2017/05/08MPG技術串接手冊智通數位科技股份有限公司2網路互聯.
通道整合.
支付金流.
核心技術2.
第四章[信用卡分期付款啟用]新增分30功能參數7MPG_1.
0.
61.
修改第三章[測試交易注意事項]中[ATM轉帳、超商代碼繳費、超商條碼繳費]說明2.
修改第三章第(三)項範例程式3.
新增支付項目[Pay2go電子錢包]與相關參數說明4.
第六章[履保銀行]參數中文名稱更改為[款項保管銀行],並新增華南銀行對應英文代碼5.
第八章新增.
netc#程式範例2017/08/228MPG_1.
0.
71.
第五章新增[指定付款人信用卡快速結帳必填欄位][TokenTermDemand]參數2.
第八章新增PHP版本[strippadding程式範例]2017/09/139MPG_1.
0.
81.
第六章新增[StoreType繳費門市類別]、[StoreID繳費門市代號]參數2017/09/1810MPG_1.
0.
91.
第二章新增超商取貨付款、超商取貨不付款之交易流程說明2.
第三章新增物流設定與測試環境說明3.
第四章新增物流啟用參數與參數說明4.
第六章新增超商物流回傳參數說明2017/11/0111MPG_1.
1.
01.
第二章超商取貨不付款之交易流程說明,新增訂單成立、交易完成觸發CustomerURL與NotifyURL說明2.
新增支付項目[GooglePay]、[SamsungPay]與相關參數說明2018/06/04MPG技術串接手冊智通數位科技股份有限公司3網路互聯.
通道整合.
支付金流.
核心技術3.
第六章與第七章新增超商取貨付款不回傳欄位註記說明MPG技術串接手冊智通數位科技股份有限公司4網路互聯.
通道整合.
支付金流.
核心技術目錄一、串接目的.
5二、交易支付流程說明.
6三、串接環境與作業流程.
19四、MPG參數設定說明.
23五、信用卡快速結帳參數設定說明.
28六、交易支付系統回傳參數說明.
33七、取號完成系統回傳參數說明.
44八、交易資料AES加解密.
49九、交易資料SHA256加密.
54十、錯誤代碼.
56一、支付方式對照說明.
58MPG技術串接手冊智通數位科技股份有限公司5網路互聯.
通道整合.
支付金流.
核心技術一、串接目的智付通結合各種支付方式金流工具,讓商店簡易快速串接使用,提供商店消費者多元支付工具,商店整合帳務輕鬆收款.
智付通提供付款方支付頁面採「響應式網頁設計(Responsivewebdesign,簡稱RWD)」,不論付款方使用之裝置為電腦、平版、手機等不同上網設備,智付通付款方支付頁將視付款方瀏覽器之螢幕大小,自動調整至最適合付款方瀏覽及操作之介面,讓交易資訊在不同大小螢幕上都能一目了然,使操作介面更友善、支付更快速,提升良好的使用者經驗.
信用卡(CREDIT)1.
提供一次付清(包含:GooglePay、SamsungPay)、分期付款、紅利折抵方式2.
支援Visa、Master、JCB、銀聯等卡別3.
提供信用卡快速結帳功能,可提供付款人選擇是否讓智付通記憶信用卡卡號,作為下次支付時使用.
4.
分期付款、紅利扣抵之請款與退款為全額請退款,無法部分請退款.
WebATM(WEBATM)ATM轉帳(VACC)超商代碼繳費(CVS)超商條碼繳費(BARCODE)Pay2go電子錢包(P2G)超商取貨付款(CVSCOM)MPG技術串接手冊智通數位科技股份有限公司6網路互聯.
通道整合.
支付金流.
核心技術二、交易支付流程說明(一)信用卡交易流程-Visa/Master/JCBMPG技術串接手冊智通數位科技股份有限公司7網路互聯.
通道整合.
支付金流.
核心技術(二)信用卡紅利折抵交易流程-Visa/Master/JCBMPG技術串接手冊智通數位科技股份有限公司8網路互聯.
通道整合.
支付金流.
核心技術(三)信用卡交易流程-銀聯卡若為銀聯卡交易,此交易是否付款成功需以NotifyURL幕後通知為主,ReturnURL前景導回不會傳遞任何參數.
MPG技術串接手冊智通數位科技股份有限公司9網路互聯.
通道整合.
支付金流.
核心技術(四)WebATM交易流程MPG技術串接手冊智通數位科技股份有限公司10網路互聯.
通道整合.
支付金流.
核心技術(五)ATM轉帳交易流程MPG技術串接手冊智通數位科技股份有限公司11網路互聯.
通道整合.
支付金流.
核心技術(六)超商代碼繳費交易流程MPG技術串接手冊智通數位科技股份有限公司12網路互聯.
通道整合.
支付金流.
核心技術(七)超商條碼繳費交易流程MPG技術串接手冊智通數位科技股份有限公司13網路互聯.
通道整合.
支付金流.
核心技術(八)Pay2go電子錢包支付交易流程MPG技術串接手冊智通數位科技股份有限公司14網路互聯.
通道整合.
支付金流.
核心技術(九)超商取貨付款交易流程註1:超商取貨付款為物流與金流結合的支付方式,因此若買方選擇了超商取貨付款,賣方在傳送交易參數時,請參考以下設定1.
開啟超商取貨付款2.
其他支付方式設定為不開啟.
註2:超商取貨付款會以下列方式回傳訂單成立與交易完成訊息1.
訂單成立回傳CutomerURL:若POST參數中有帶此參數值,則訂單成立時將會回傳訂單資訊至CutomerURL,並且頁面也將會導到CutomerURL,將不會停留在智付通,商店收到CutomerURL參數,與自行組成頁面資訊供付款人參閱,設定方式請參考章節七.
2.
訂單成立回傳NotifyURL:若POST參數中有帶此參數值,則訂單成立時將會背景回傳NotifyURL,設定方式請參考章節六.
MPG技術串接手冊智通數位科技股份有限公司15網路互聯.
通道整合.
支付金流.
核心技術3.
若商店POST參數中同時帶有CutomerURL與NotifyURL,則兩個URL皆會收到訂單成立的回傳資訊.
4.
交易完成回傳NotifyURL:若POST參數中有帶此參數值,當買方於超商完成取貨付款後,系統將會背景回傳付款完成資訊,設定方式請參考章節六.
MPG技術串接手冊智通數位科技股份有限公司16網路互聯.
通道整合.
支付金流.
核心技術(十)超商取貨不付款交易流程註:超商取貨不付款為物流服務,買方仍需以MPG既有之支付方式進行支付.
因此若買方選擇超商取貨不付款,賣方在傳送交易參數時,請參考以下設定1.
將超商取貨付款設為不開啟.
2.
將其他支付方式設定為開啟.
MPG技術串接手冊智通數位科技股份有限公司17網路互聯.
通道整合.
支付金流.
核心技術(十一)GooglePay交易流程-MPG技術串接手冊智通數位科技股份有限公司18網路互聯.
通道整合.
支付金流.
核心技術(十二)SamsungPay交易流程-MPG技術串接手冊智通數位科技股份有限公司19網路互聯.
通道整合.
支付金流.
核心技術三、串接環境與作業流程(一)測試串接網址:https://ccore.
spgateway.
com/MPG/mpg_gateway1.
請於智付通測試平台註冊會員並建立測試商店.
(1)請至智付通測試平台https://cwww.
spgateway.
com/於頁面右上方點選「註冊」按鈕.
(2)填寫資料註冊成為會員並依平台導引建立測試商店.
【備註】:商店於智付通測試平台註冊的會員帳號密碼及測試資料,有效使用天期為註冊完成日起算30天.
2.
取得API串接金鑰HashKey及HashIV.
(1)請登入智付通測試平台,於【銷售中心】單元點選目錄【商店管理/商店資料設定】.
(2)點選「詳細資料」,查看商店API串接金鑰HashKey及HashIV.
3.
確認支付方式已啟用.
(1)若需使用Pay2go電子錢包,請先確認該商店為[智付雙寶商店],方能使用,若需設定[智付雙寶商店]請至Pay2go電子支付平台[會員專區]中進行設定.
(2)若需使用超商取貨付款,請至:智付通會員專區/銷售中心/商店管理/商店資料設定/物流設定,啟用物流服務,並勾選超商取貨付款選項與填寫退貨門市資訊後儲存,即完成設定.
(3)於商店建立時,預設啟用的支付方式僅包含WebATM、ATM轉帳、超商代碼繳費、超商條碼繳費.
(4)如商店欲測試信用卡一次付清、信用卡分期付款、信用卡紅利折抵、GooglePay、SamsungPay等支付方式,則需進行申請,申請步驟如下:MPG技術串接手冊智通數位科技股份有限公司20網路互聯.
通道整合.
支付金流.
核心技術A.
請登入智付通測試平台,於【銷售中心】單元點選目錄【商店管理/商店資料設定】.
B.
點選「詳細資料」,並於您欲啟用的支付方式欄位中,點選「申請啟用」,點選後即自動開通.
4.
於測試環境完成串接後,進行交易測試,歩驟如下:(1)建立交易訂單(2)選擇支付方式及測試付款代碼中文名稱測試交易注意事項CREDIT信用卡1.
測試環境僅接受以下的測試卡號.
4000-2211-1111-1111(一次付清與分期付款)4003-5511-1111-1111(紅利折抵)2.
測試卡號有效月年及卡片背面末三碼,請任意填寫.
3.
系統在執行測試刷卡後,以測試授權碼回應模擬付款完成.
4.
以測試卡號之外的卡號資料進行交易都會失敗.
5.
銀聯卡交易不開放測試.
WEBATMWebATM測試交易不會引導至金融機構轉帳畫面,系統將立刻完成交易並傳送交易完成訊息.
VACCATM轉帳可測試是否取號並回傳正常,可至[會員專區/銷售記錄查詢]中針對該筆測試交易執行[模擬觸發],系統將立刻傳送付款完成訊息至NotifyURL,但會員專區之付款狀態仍為[未付款].
CVS超商代碼繳費可測試是否取號並回傳正常,可至[會員專區/銷售記錄查詢]中針對該筆測試交易執行[模擬觸發],系統將立刻傳送付款完成訊息至NotifyURL,但會員專區之付款狀態仍為[未付款].
BARCODE超商條碼繳費可測試是否取號並回傳正常,可至[會員專區/銷售記錄查詢]中針對該筆測試交易執行[模擬觸發],系統將立刻傳送付款完成訊息至NotifyURL,但會員專區之付款狀態仍為[未付款].
P2GPay2go電子錢包可測試是否直接扣除帳戶金額.
CVSCOM物流服務測試環境可測試物流訂單收單與透過寄件管理介面列印寄件代碼;列印寄件單與實際包裹貨態改變,需在正式環境並實際進行包裹交寄.
ANDROIDPAYGooglePay1.
GooglePay無法提供測試卡號,請自行使用真實的信用卡,至Android裝置上進行綁定與支付測試.
2.
測試區之信用卡(含GooglePay)授權、取消授權、請款、退款,皆為模擬作業,並未實際發動至收單機構.
MPG技術串接手冊智通數位科技股份有限公司21網路互聯.
通道整合.
支付金流.
核心技術SAMSUNGPAYSamsungPay1.
SamsungPay無法提供測試卡號,請自行使用真實的信用卡,至Samsung裝置上進行綁定與支付測試.
2.
測試區之信用卡(含SamsungPay)授權、取消授權、請款、退款,皆為模擬作業,並未實際發動至收單機構.
5.
測試交易查詢:於【銷售中心】單元點選目錄【銷售記錄查詢】進行查看.
(二)正式串接網址:https://core.
spgateway.
com/MPG/mpg_gateway1.
請於智付通平台註冊會員並建立商店.
(1)請至智付通平台https://www.
spgateway.
com/於頁面右上方點選「註冊」按鈕.
(2)填寫資料註冊成為會員並依平台導引建立商店.
2.
取得API串接金鑰HashKey及HashIV.
(1)請登入智付通平台,於【銷售中心】單元點選目錄【商店管理/商店資料設定】.
(2)點選「詳細資料」,查看商店API串接金鑰HashKey及HashIV.
3.
確認支付方式已啟用.
(1)若需使用Pay2go電子錢包,請先確認該商店為[智付雙寶商店],方能使用,若需設定[智付雙寶商店]請至Pay2go電子支付平台[會員專區]中進行設定.
(2)於商店建立時,預設啟用的支付方式僅包含WebATM、ATM轉帳、超商代碼繳費、超商條碼繳費.
(3)如商店欲啟用信用卡一次付清、信用卡分期付款、信用卡紅利折抵、GooglePay、SamsungPay等支付方式,則需進行申請,申請步驟如下:A.
請登入智付通平台,於【銷售中心】單元點選目錄【商店管理/商店資料設定】.
B.
點選「詳細資料」,並於您欲啟用的支付方式欄位中,點選「申請啟MPG技術串接手冊智通數位科技股份有限公司22網路互聯.
通道整合.
支付金流.
核心技術用」,點選後將由智付通審核商店資料後,為商店進行開通.
4.
正式開始使用智付通平台服務.
(三)資料交換方式1.
商店以前景「FormPost」方式傳送交易資料至智付通進行交易.
2.
支付完成後,智付通會以背景「FormPost」方式回應支付完成訊息至商店設定的NotifyURL.
3.
編碼格式為UTF-8.
4.
範例:MerchantID:(.
.
.
欄位參數內容)5.
支付頁面整頁均須為由智付通帶入之頁面,且必須完整呈現由智付通所帶入之頁面(含網址),切勿以iframe或其他後端Post方式進行串接,否則支付頁面將無法正常顯示.
MPG技術串接手冊智通數位科技股份有限公司23網路互聯.
通道整合.
支付金流.
核心技術四、MPG參數設定說明(一)支付方式說明:請參考一.
(二)適用所有支付方式Post參數說明:參數名稱參數中文名稱必填型態備註MerchantID商店代號VVarchar(15)智付通商店代號.
TradeInfo交易資料AES加密V1.
將交易資料參數(下方列表中參數)透過商店Key及IV進行AES加密.
2.
範例請參考八、交易資料AES加解密TradeSha交易資料SHA256加密V1.
將交易資料經過上述AES加密過的字串,透過商店Key及IV進行SHA256加密.
2.
範例請參考九、交易資料SHA256加密Version串接程式版本VVarchar(5)請帶1.
4.
交易資料參數參數名稱參數中文名稱必填型態備註MerchantID商店代號VVarchar(15)智付通商店代號.
RespondType回傳格式VVarchar(6)JSON或是String.
TimeStamp時間戳記VVarchar(50)自從Unix纪元(格林威治時間1970年1月1日00:00:00)到當前時間的秒數,若以php程式語言為例,即為呼叫time()函式所回傳的值.
例:2014-05-1515:00:00(+08:00時區)這個時間的時間戳記為1400137200.
Version串接程式版本VVarchar(5)請帶1.
4.
LangType語系Varchar(5)1.
設定MPG頁面顯示的文字語系.
英文版參數為en繁體中文版參數為zh-tw2.
當未提供此參數或此參數數值錯誤時,將預設為繁體中文版.
MerchantOrderNo商店訂單編號VVarchar(20)1.
商店自訂訂單編號,限英、數字、"_"格式.
例:201406010001.
MPG技術串接手冊智通數位科技股份有限公司24網路互聯.
通道整合.
支付金流.
核心技術2.
長度限制為20字.
3.
同一商店中此編號不可重覆.
Amt訂單金額Vint(10)1.
純數字不含符號,例:1000.
2.
幣別:新台幣.
ItemDesc商品資訊VVarchar(50)1.
限制長度為50字.
2.
編碼為Utf-8格式.
TradeLimit交易限制秒數Int(3)1.
限制交易的秒數,當秒數倒數至0時,交易當做失敗.
2.
僅可接受數字格式.
3.
秒數下限為60秒,當秒數介於1~59秒時,會以60秒計算.
4.
秒數上限為900秒,當超過900秒時,會以900秒計算.
5.
若未帶此參數,或是為0時,會視作為不啟用交易限制秒數.
ExpireDate(適用於非即時交易)繳費有效期限Varchar(10)1.
格式為date('Ymd'),例:201406202.
此參數若為空值,系統預設為7天.
自取號時間起算至第7天23:59:59.
例:2014-06-2314:35:51完成取號,則繳費有效期限為2014-06-2923:59:59.
3.
可接受最大值為180天.
ReturnURL支付完成返回商店網址Varchar(50)1.
交易完成後,以FormPost方式導回商店頁面.
2.
若為空值,交易完成後,消費者將停留在智付通付款或取號完成頁面.
3.
只接受80與443Port.
NotifyURL支付通知網址Varchar(50)1.
以幕後方式回傳給商店相關支付結果資料;請參考六、交易支付系統回傳參數說明.
2.
只接受80與443Port.
CustomerURL商店取號網址Varchar(50)1.
系統取號後以formpost方式將結果導回商店指定的網址,請參考七、取號完成系統回傳參數說明.
2.
此參數若為空值,則會顯示取號結果在智付通頁面.
ClientBackURL支付取消返回商店網址Varchar(50)1.
當交易取消時,平台會出現返回鈕,使消費者依以此參數網址返回商店指定的頁面.
2.
此參數若為空值時,則無返回鈕.
MPG技術串接手冊智通數位科技股份有限公司25網路互聯.
通道整合.
支付金流.
核心技術Email付款人電子信箱VVarchar(50)於交易完成或付款完成時,通知付款人使用.
EmailModify付款人電子信箱是否開放修改Int(1)1.
設定於MPG頁面,付款人電子信箱欄位是否開放讓付款人修改.
1=可修改0=不可修改2.
當未提供此參數時,將預設為可修改.
LoginType智付通會員VInt(1)1=須要登入智付通會員0=不須登入智付通會員OrderComment商店備註Varchar(300)1.
限制長度為300字.
2.
若有提供此參數,將會於MPG頁面呈現商店備註內容.
CREDIT信用卡一次付清啟用Int(1)1.
設定是否啟用信用卡一次付清支付方式.
1=啟用0或者未有此參數=不啟用ANDROIDPAYGooglePay啟用Int(1)1.
設定是否啟用GooglePay支付方式.
1=啟用0或者未有此參數=不啟用SAMSUNGPAYSamsungPay啟用Int(1)1.
設定是否啟用SamsungPay支付方式.
1=啟用0或者未有此參數=不啟用InstFlag信用卡分期付款啟用Varchar(18)1.
此欄位值=1時,即代表開啟所有分期期別,且不可帶入其他期別參數.
2.
此欄位值為下列數值時,即代表開啟該分期期別.
3=分3期功能6=分6期功能12=分12期功能18=分18期功能24=分24期功能30=分30期功能3.
同時開啟多期別時,將此參數用","(半形)分隔,例如:3,6,12,代表開啟分3、6、12期的功能.
4.
此欄位值=0或無值時,即代表不開啟分期.
CreditRed信用卡紅利啟用Int(1)1.
設定是否啟用信用卡紅利支付方式.
1=啟用0或者未有此參數=不啟用MPG技術串接手冊智通數位科技股份有限公司26網路互聯.
通道整合.
支付金流.
核心技術UNIONPAY信用卡銀聯卡啟用Int(1)1.
設定是否啟用銀聯卡支付方式.
1=啟用0或者未有此參數=不啟用WEBATMWEBATM啟用Int(1)1.
設定是否啟用WEBATM支付方式.
1=啟用0或者未有此參數,即代表不開啟.
VACCATM轉帳啟用Int(1)1.
設定是否啟用ATM轉帳支付方式.
1=啟用0或者未有此參數,即代表不開啟.
CVS超商代碼繳費啟用Int(1)1.
設定是否啟用超商代碼繳費支付方式1=啟用0或者未有此參數,即代表不開啟.
2.
當該筆訂單金額小於30元或超過2萬元時,即使此參數設定為啟用,MPG付款頁面仍不會顯示此支付方式選項.
BARCODE超商條碼繳費啟用Int(1)1.
設定是否啟用超商條碼繳費支付方式1=啟用0或者未有此參數,即代表不開啟.
2.
當該筆訂單金額小於20元或超過4萬元時,即使此參數設定為啟用,MPG付款頁面仍不會顯示此支付方式選項.
P2GPay2go電子錢包啟用Int(1)1.
設定是否啟用Pay2go電子錢包支付方式.
1=啟用0或者未有此參數,即代表不開啟.
CVSCOM物流啟用Int(1)1.
使用前,須先登入智付通會員專區啟用物流並設定退貨門市與取貨人相關資訊.
1=啟用超商取貨不付款2=啟用超商取貨付款3=啟用超商取貨不付款及超商取貨付款0或者未有此參數,即代表不開啟.
2.
當該筆訂單金額小於30元或大於2萬元時,即使此參數設定為啟用,MPG付款頁面仍不會顯示此支付方式選項.
ANDROIDPAYGooglePayInt(1)1.
設定是否啟用GooglePay支付方式.
1=啟用0或者未有此參數,即代表不開啟.
SAMSUNGPAYSamsungPayInt(1)1.
設定是否啟用SamsungPay支付方式.
1=啟用MPG技術串接手冊智通數位科技股份有限公司27網路互聯.
通道整合.
支付金流.
核心技術0或者未有此參數,即代表不開啟.
【備註1】當下列所有參數CREDIT、ANDROIDPAY、SAMSUNGPAY、InstFlag、CreditRed、UNIONPAY、WEBATM、VACC、CVS、BARCODE、P2G、CVSCOM、ANDROIDPAY、SAMSUNGPAY皆未以API指定啟用時,則以商店設定值為準.
【備註2】NotifyURL及ReturnURL參數補充說明:1.
商店欲接收支付完成訊息,請務必設定NotifyURL.
2.
商店欲支付完成後引導消費者回商店網頁,請務必設定ReturnURL.
3.
NotifyURL及ReturnURL可以下列兩種方式設定方式如下:(1)API參數設定:每筆交易建立時以API參數提供.
(2)商店於智付通平台設定:於智付通平台【銷售中心】單元,【商店管理】目錄【商店資料設定】子目錄,於該商店詳細資料中設定API應用URL.
(3)當兩種方式皆有設定時,會以API參數設定為主.
4.
ReturnURL與NotifyURL均會攜帶回應參數回傳,請勿設定相同網址進而造成交易誤判.
例:ReturnURL與NotifyURL設定相同網址,則該網址會接收到兩次付款完成資訊,但實際付款完成只有一次,將會影響商店出貨及帳務的正確性.
MPG技術串接手冊智通數位科技股份有限公司28網路互聯.
通道整合.
支付金流.
核心技術五、信用卡快速結帳參數設定說明(一)信用卡快速結帳適用參數說明:當商店欲提供信用卡快速結帳功能,需於傳送交易參數時同步提供下列參數.
參數名稱參數中文名稱必填型態備註TokenTerm付款人綁定資料VVarchar(20)1.
可對應付款人之資料,用於綁定付款人與信用卡卡號時使用,例:會員編號、Email.
2.
限英、數字,「.
」、「_」、「@」、「-」格式.
TokenTermDemand指定付款人信用卡快速結帳必填欄位Int(1)可指定付款人需填寫的信用卡資訊,不同的參數值對應填寫不同的資訊,參數值與對應資訊說明如下:1=必填信用卡到期日與背面末三碼2=必填信用卡到期日3=必填背面末三碼未有此參數或帶入其他無效參數,系統預設為參數1.
(二)信用卡快速結帳功能說明:1.
首次設定信用卡快速結帳:信用卡快速結帳功能,是以商店提供的TokenTerm參數,作為付款人對應資料,當商店有提供TokenTerm參數時,付款人可於智付通支付頁面勾選將此次交易之信用卡卡號加入快速結帳,智付通會以商店提供的TokenTerm參數對應此次交易之信用卡卡號,作為付款人下次快速結帳時使用.
2.
使用信用卡快速結帳:(1)付款人於下次交易時,當商店提供同一個TokenTerm參數,智付通則視為同一個付款人,並以該TokenTerm參數對應付款人於智付通支付頁面填寫之信用卡卡號(前六碼及後四碼)自動帶入於智付通支付頁面,付款人填寫信用卡到期日及背面末三碼,即可支付完成.
(2)付款人如欲變更快速結帳紀錄之信用卡卡號,可於智付通支付頁面顯示之信用卡填寫卡號欄位進行修改,輸入新卡號資料、到期日及背面末三碼,並勾選加入快速結帳,智付通會將此付款人之新卡號資料紀錄為最近一次啟用快速結帳之信用卡卡號.
MPG技術串接手冊智通數位科技股份有限公司29網路互聯.
通道整合.
支付金流.
核心技術(3)付款人如於變更快速結帳紀錄之信用卡卡號時,因故不進行變更,可將信用卡填寫卡號欄位資料全部刪除,平台會自動重新帶入最近一次快速結帳紀錄之信用卡卡號.
(4)智付通僅保留最近一次加入快速結帳且成功交易的卡號資料.
3.
指定付款人信用卡快速結帳必填欄位:(1)若未帶入TokenTermDemand或TokenTermDemand為無效參數,則付款人必須填入信用卡到期日與背面末三碼.
(2)因發卡行規定,富邦銀行信用卡必須填入背面末三碼,若TokenTermDemand帶入參數2(指定付款人只需填信用卡到期日),則系統仍會出現背面末三碼欄位要求付款人填入信用卡到期日與背面末三碼,方能進行付款.
4.
取消信用卡快速結帳:付款人如欲取消快速結帳,可於智付通支付頁面勾選取消快速結帳,智付通會將此付款人之TokenTerm參數紀錄的卡號資料清除.
【備註】1.
同一個會員中,各家商店的TokenTerm參數仍不可重複.
2.
如付款人選擇使用銀聯卡交易,則不適用快速結帳功能.
MPG技術串接手冊智通數位科技股份有限公司30網路互聯.
通道整合.
支付金流.
核心技術(三)信用卡快速結帳交易流程1.
首次設定信用卡快速結帳流程【備註】1.
信用卡授權成功之交易,此張信用卡卡號才會啟用快速結帳功能.
2.
此流程適用於變更快速結帳紀錄之信用卡卡號.
MPG技術串接手冊智通數位科技股份有限公司31網路互聯.
通道整合.
支付金流.
核心技術2.
使用信用卡快速結帳流程MPG技術串接手冊智通數位科技股份有限公司32網路互聯.
通道整合.
支付金流.
核心技術3.
取消信用卡快速結帳流程【備註】1.
此次交易如勾選取消快速結帳功能,於下一次交易時,才正式取消快速結帳功能.
MPG技術串接手冊智通數位科技股份有限公司33網路互聯.
通道整合.
支付金流.
核心技術六、交易支付系統回傳參數說明(一)適用交易類別:1.
即時交易支付方式:信用卡(CREDIT)、WebATM(WEBATM)、Pay2go電子錢包(P2G)、GooglePay(ANDROIDPAY)、SamsungPay(SAMSUNGPAY).
2.
非即時交易支付方式:超商代碼繳費(CVS)、ATM轉帳(VACC)、超商條碼繳費(BARCODE)、超商取貨付款(CVSCOM).
(一)商店欲以背景方式接收支付完成訊息,請務必設定NotifyURL.
(二)商店欲以前景方式接收支付完成訊息,且於支付完成後引導消費者回商店網頁,請務必設定ReturnURL.
(不適用於銀聯卡與非即時交易支付)(三)ReturnURL所回傳之參數值主要用途為支付結果頁面顯示,建議使用NotifyURL回傳之參數值來確認訂單是否有效.
(四)回應訊息格式為依TradeInfo所帶的參數回傳對應格式,回傳格式為兩種:Json及String:1.
若RespondType=JSON,則請參考以下「JSON回傳參數說明」.
2.
若RespondType=String,則請參考以下「String回傳參數說明」.
參數名稱參數中文名稱型態備註Status回傳狀態Varchar(10)1.
若交易付款成功,則回傳SUCCESS.
2.
若交易付款失敗,則回傳錯誤代碼.
錯誤代碼請參考十、錯誤代碼.
MerchantID回傳訊息Varchar(20)商店代號.
TradeInfo交易資料AES加密1.
將交易資料參數(下方列表中參數)透過商店Key及IV進行AES加密.
2.
範例請參考八、交易資料AES加解密TradeSha交易資料SHA256加密1.
將交易資料經過上述AES加密過的字串,透過商店Key及IV再進行SHA256加密.
2.
範例請參考九、交易資料SHA256加密MPG技術串接手冊智通數位科技股份有限公司34網路互聯.
通道整合.
支付金流.
核心技術Version串接程式版本Varchar(5)串接程式版本(1)JSON回傳參數說明:參數名稱參數中文名稱型態備註Status回傳狀態Varchar(10)1.
若交易付款成功,則回傳SUCCESS.
2.
若交易付款失敗,則回傳錯誤代碼.
錯誤代碼請參考十、錯誤代碼.
3.
若使用新增自訂支付欄位之交易,則回傳CUSTOM.
Message回傳訊息Varchar(50)文字,敘述此次交易狀態.
Result回傳參數當RespondType為JSON時,回傳參數會放至此陣列下.
所有支付方式共同回傳參數MerchantID商店代號Varchar(15)智付通商店代號.
Amt交易金額Int(10)1.
純數字不含符號,例:1000.
2.
幣別:新台幣.
TradeNo智付通交易序號Varchar(20)智付通在此筆交易取號成功時所產生的序號.
MerchantOrderNo商店訂單編號Varchar(20)商店自訂訂單編號.
PaymentType支付方式Varchar(10)請參考一.
RespondType回傳格式Varchar(10)JSON格式.
PayTime支付完成時間DateTime回傳格式為:2014-06-2516:43:49註:若為超商取貨付款的訂單成立時,notifyUR不回傳此參數.
IP交易IPVarchar(15)付款人取號或交易時的IP.
EscrowBank款項保管銀行Varchar(10)1.
該筆交易履約保證銀行.
2.
如商店是直接與銀行簽約的信用卡特約商店,當使用信用卡支付時,本欄位的值會以空值回傳.
3.
履保銀行英文代碼與中文名稱對應如下:[Esun]:玉山銀行[Taishin]:台新銀行[HNCB]:華南銀行信用卡支付回傳參數(包含:GooglePay、SamaungPay)RespondCode金融機構回應碼Varchar(5)1.
由收單機構所回應的回應碼.
2.
若交易送至收單機構授權時已是失敗狀態,則本欄位的值會以空值回傳.
Auth授權碼Varchar(6)1.
由收單機構所回應的授權碼.
MPG技術串接手冊智通數位科技股份有限公司35網路互聯.
通道整合.
支付金流.
核心技術2.
若交易送至收單機構授權時已是失敗狀態,則本欄位的值會以空值回傳.
Card6No卡號前六碼Varchar(6)1.
信用卡卡號前六碼.
2.
若交易送至收單機構授權時已是失敗狀態,則本欄位的值會以空值回傳.
Card4No卡號末四碼Varchar(4)1.
信用卡卡號後四碼.
2.
若交易送至收單機構授權時已是失敗狀態,則本欄位的值會以空值回傳.
Inst分期-期別Int(10)信用卡分期交易期別.
InstFirst分期-首期金額Int(10)信用卡分期交易首期金額.
InstEach分期-每期金額Int(10)信用卡分期交易每期金額.
ECIECI值Varchar(2)1.
3D回傳值eci=1,2,5,6,代表為3D交易.
2.
若交易送至收單機構授權時已是失敗狀態,則本欄位的值會以空值回傳.
TokenUseStatus信用卡快速結帳使用狀態Int(1)0=該筆交易為非使用信用卡快速結帳功能1=該筆交易為首次設定信用卡快速結帳功能2=該筆交易為使用信用卡快速結帳功能9=該筆交易為取消信用卡快速結帳功能功能RedAmt紅利折抵後實際金額Int(5)1.
扣除紅利交易折抵後的實際授權金額.
例:1000元之交易,紅利折抵60元,則紅利折抵後實際金額為940元.
2.
若紅利點數不足,會有以下狀況:2-1紅利折抵交易失敗,回傳參數數值為0.
2-2紅利折抵交易成功,回傳參數數值為訂單金額.
2-3紅利折抵交易是否成功,視該銀行之設定為準.
3.
僅有使用紅利折抵交易時才會回傳此參數.
WEBATM、ATM繳費回傳參數PayBankCode付款人金融機構代碼Varchar(10)由代收款金融機構所回應的付款人金融機構代碼.
PayerAccount5Code付款人金融機構帳號末五碼Varchar(5)由代收款金融機構所回應的付款人金融機構帳號末五碼.
超商代碼繳費回傳參數CodeNo繳費代碼Varchar(30)繳費代碼.
StoreType繳費門市類別Int(1)1=7-11統一超商2=全家便利商店MPG技術串接手冊智通數位科技股份有限公司36網路互聯.
通道整合.
支付金流.
核心技術3=OK便利商店4=萊爾富便利商店StoreID繳費門市代號Varchar(10)繳費門市代號(全家回傳門市中文名稱)超商條碼繳費回傳參數Barcode_1第一段條碼Varchar(20)繳費條碼第一段條碼資料.
Barcode_2第二段條碼Varchar(20)繳費條碼第二段條碼資料.
Barcode_3第三段條碼Varchar(20)繳費條碼第三段條碼資料.
PayStore繳費超商Varchar(8)付款人至超商繳費,該收款超商的代碼,SEVEN:7-11FAMILY:全家OK:OK超商HILIFE:萊爾富Pay2go電子錢包回傳參數P2GTradeNoP2G交易序號Varchar(25)P2G在此筆交易所產生的序號.
P2GPaymentTypeP2G支付方式Varchar(10)可參考一.
但前面會為P2G_開頭,說明如下:P2G信用卡交易P2GPaymentType=P2G_CREDITP2GWEBATM交易P2GPaymentType=P2G_WEBATMP2GATM轉帳交易P2GPaymentType=P2G_VACCP2G超商代碼繳費交易P2GPaymentType=P2G_CVSP2G電子帳戶交易P2GPaymentType=P2GEACCP2GAmtP2G交易金額Int(10)1.
純數字不含符號,例:1000.
2.
幣別:新台幣.
超商物流回傳參數StoreCode超商門市編號Varchar(10)取貨門市編號StoreName超商門市名稱Varchar(15)取貨門市中文名稱StoreType超商類別名稱Varchar(10)回傳[全家]、[OK]、[萊爾富]StoreAddr超商門市地址Varchar(100)取貨門市地址TradeType取件交易方式Int(1)1=取貨付款3=取貨不付款MPG技術串接手冊智通數位科技股份有限公司37網路互聯.
通道整合.
支付金流.
核心技術CVSCOMName取貨人Varchar(20)取貨人姓名CVSCOMPhone取貨人手機號碼Varchar(10)取貨人手機號碼原始接收資料:[Status]=>SUCCESS[MerchantID]=>3430112[TradeInfo]=>3716aa2a929c1b40071a732f1b8c57c3ecb6a6aeefed4061705dba662c14d0ecd5ae3aa9ed14e96745b3542fdda87c89ad4e9909e9b7f8d05288dae032526e7e0825b39b9e4df97b7b70e50866a71b6f9e17c6514e56cf5e3befee9c3371df308e3554e0713c07f7042818f24b8100ccc3728e2b590310416eff8a53a9d807d94a1df600f76c6931afab103ffc9e551d54974d59b3a54f255fed4062fb5da8470f127077979c60070a6a6f1793cddf3d34c521817ba26e78394dec16cbda8ded9b21f977be42ad4946ec9c4481e130ef812888df401cb0ab40d4f8348f848b6f5f4473184dd6a0d86916b3ccb1198eee41014554196628c74a22e7d7e3183cd8c2270a1236fed34102f7c71fb44913d5edd87f1b5432d3532786c83ad12fc341a2c45e9b8294605e50059d3792d7a6cb76ecaab7e6d0209ea65cc5bb2371ef177a5e869d0ae306fce2210b59bf90c6f6e7cf4807d069c1fed3bb199eb89f25556aebbe0dd8d384481c452a807762685537239fff06e2bf5bd3fb1d612e55fceb34b1425e458ba5b6b946ba943a7e42598f2f0a9713d8cf2327a2bd0d7d7952053f109ea896d2c88c4f1fc7680ff12af9877a9c3e888367d65fdb69d13b3e7a3f955ef1e286ae94a183652b4c36b3639ba39d3affb1833feef1797874a61b57bc3247e4cb9b30532a7c92b6997e2476e9b90aebaab2367a25ff1fa33f1b380c772822fea4f34b7b8002d537e8944e91a9045c328e21eaaec80fbbb5d6bbf067e7936f18a1ecd1e3a0c8db44c8215e8ba2624894ef4c31fab41e537157b206a0a7ea26ad326aae5b07856b3e7be32c0f0dddd4e8275f09d90a2233aecb0470409b7d67b6d4b6778faa7dd26f6143130786b8a4cfc9b05ae76976b709474c34d409605cd32c4c5e0f6c341349efc2ed002fdf74f35a559fff6dd1dc4c138629bc02b96edb06c48cf6b4976f5379576a2eec897094a2460781ea251859b72a2fc3339ff66a56c8737e9a79ad25ae9e4cd8febc5c9ac1632e8706bcf4b0dda66ff9f6[TradeSha]=>3052314E7E9A6418128705697ECA25DE3381FF603B9614291DBD9F19FF93F8A9TradeInfoAES解密(JSON):{"Status":"SUCCESS","Message":"\u6388\u6b0a\u6210\u529f","Result":{"MerchantID":"MS140446","Amt":183,"TradeNo":"17101313263408279","MerchantOrderNo":"T15078722832443","RespondType":"JSON","IP":"59.
124.
92.
194","EscrowBank":"HNCB","PaymentType":"CREDIT","PayTime":"2017-10-13MPG技術串接手冊智通數位科技股份有限公司38網路互聯.
通道整合.
支付金流.
核心技術13:26:34","RespondCode":"00","Auth":"930637","Card6No":"400022","Card4No":"1111","Exp":"2104","TokenUseStatus":1,"InstFirst":0,"InstEach":0,"Inst":0,"ECI":"","StoreID":"L002421","StoreType":"\u840a\u723e\u5bcc","StoreName":"\u840a\u723e\u5bcc\u5317\u5e02\u5b89\u5fa9\u5e97","StoreAddr":"\u53f0\u5317\u5e02\u5927\u5b89\u5340\u5fa9\u8208\u5357\u8def\u4e00\u6bb5135\u5df721\u865f","TradeType":"3","CVSCOMName":"\u738b\u5c0f\u660e","CVSCOMPhone":"0900000123"}}MPG技術串接手冊智通數位科技股份有限公司39網路互聯.
通道整合.
支付金流.
核心技術(2)String回傳參數說明:參數名稱參數中文名稱型態備註Status回傳狀態Varchar(10)1.
若交易付款成功,則回傳SUCCESS.
2.
若交易付款失敗,則回傳錯誤代碼.
錯誤代碼請參考十、錯誤代碼.
Message回傳訊息Varchar(50)文字,敘述此次交易狀態.
所有支付方式共同回傳參數MerchantID商店代號Varchar(15)智付通商店代號.
Amt交易金額Int(10)1.
純數字不含符號,例:1000.
2.
幣別:新台幣.
TradeNo智付通交易序號Varchar(20)智付通在此筆交易取號成功時所產生的序號.
MerchantOrderNo商店訂單編號Varchar(20)商店自訂訂單編號.
PaymentType支付方式Varchar(10)請參考一.
RespondType回傳格式Varchar(10)String格式.
PayTime支付完成時間DateTime回傳格式為:2014-06-2516:43:49註:若為超商取貨付款的訂單成立時,notifyUR不回傳此參數.
IP交易IPVarchar(15)付款人取號或交易時的IP.
EscrowBank款項保管銀行Varchar(10)1.
該筆交易履約保證銀行.
2.
如商店是直接與銀行簽約的信用卡特約商店,當使用信用卡支付時,本欄位的值會以空值回傳.
3.
履保銀行英文代碼與中文名稱對應如下:[Esun]:玉山銀行[Taishin]:台新銀行[HNCB]:華南銀行信用卡支付回傳參數(包含:GooglePay、SamaungPay)RespondCode金融機構回應碼Varchar(5)1.
由收單機構所回應的回應碼.
2.
若交易送至收單機構授權時已是失敗狀態,則本欄位的值會以空值回傳.
Auth授權碼Varchar(6)1.
由收單機構所回應的授權碼.
2.
若交易送至收單機構授權時已是失敗狀態,則本欄位的值會以空值回傳.
Card6No卡號前六碼Varchar(6)1.
信用卡卡號前六碼.
2.
若交易送至收單機構授權時已是失敗狀態,則本欄位的值會以空值回傳.
MPG技術串接手冊智通數位科技股份有限公司40網路互聯.
通道整合.
支付金流.
核心技術Card4No卡號末四碼Varchar(4)1.
信用卡卡號後四碼.
2.
若交易送至收單機構授權時已是失敗狀態,則本欄位的值會以空值回傳.
Inst分期-期別Int(10)信用卡分期交易期別.
InstFirst分期-首期金額Int(10)信用卡分期交易首期金額.
InstEach分期-每期金額Int(10)信用卡分期交易每期金額.
ECIECI值Varchar(2)1.
3D回傳值eci=1,2,5,6,代表為3D交易.
2.
若交易送至收單機構授權時已是失敗狀態,則本欄位的值會以空值回傳.
TokenUseStatus信用卡快速結帳使用狀態Int(1)0=該筆交易為非使用信用卡快速結帳功能1=該筆交易為首次設定信用卡快速結帳功能2=該筆交易為使用信用卡快速結帳功能9=該筆交易為取消信用卡快速結帳功能功能RedAmt紅利折抵後實際金額Int(5)1.
扣除紅利交易折抵後的實際授權金額.
例:1000元之交易,紅利折抵60元,則紅利折抵後實際金額為940元.
2.
若紅利點數不足,會有以下狀況:2-1紅利折抵交易失敗,回傳參數數值為0.
2-2紅利折抵交易成功,回傳參數數值為訂單金額.
2-3紅利折抵交易是否成功,視該銀行之設定為準.
3.
僅有使用紅利折抵交易時才會回傳此參數.
WEBATM、ATM繳費回傳參數PayBankCode付款人金融機構代碼Varchar(10)由代收款金融機構所回應的付款人金融機構代碼.
PayerAccount5Code付款人金融機構帳號末五碼Varchar(5)由代收款金融機構所回應的付款人金融機構帳號末五碼.
超商代碼繳費回傳參數CodeNo繳費代碼Varchar(30)繳費代碼.
StoreType繳費門市類別Int(1)1=7-11統一超商2=全家便利商店3=OK便利商店4=萊爾富便利商店StoreID繳費門市代號Varchar(10)繳費門市代號(全家回傳門市中文名稱)超商條碼繳費回傳參數MPG技術串接手冊智通數位科技股份有限公司41網路互聯.
通道整合.
支付金流.
核心技術Barcode_1第一段條碼Varchar(20)繳費條碼第一段條碼資料.
Barcode_2第二段條碼Varchar(20)繳費條碼第二段條碼資料.
Barcode_3第三段條碼Varchar(20)繳費條碼第三段條碼資料.
PayStore繳費超商Varchar(8)付款人至超商繳費,該收款超商的代碼,SEVEN:7-11FAMILY:全家OK:OK超商HILIFE:萊爾富Pay2go電子錢包回傳參數P2GTradeNoP2G交易序號Varchar(25)P2G在筆交易所產生的序號.
P2GPaymentTypeP2G支付方式Varchar(10)可參考一.
但前面會為P2G_開頭,說明如下:P2G信用卡交易P2GPaymentType=P2G_CREDITP2GWEBATM交易P2GPaymentType=P2G_WEBATMP2GATM轉帳交易P2GPaymentType=P2G_VACCP2G超商代碼繳費交易P2GPaymentType=P2G_CVSP2G電子帳戶交易P2GPaymentType=P2GEACCP2GAmtP2G交易金額Int(10)1.
純數字不含符號,例:1000.
2.
幣別:新台幣.
超商物流回傳參數StoreCode超商門市編號Varchar(10)取貨門市編號StoreName超商門市名稱Varchar(15)取貨門市中文名稱StoreType超商類別名稱Varchar(10)回傳[全家]、[OK]、[萊爾富]StoreAddr超商門市地址Varchar(100)取貨門市地址TradeType取件交易方式Int(1)1=取貨付款3=取貨不付款CVSCOMName取貨人Varchar(20)取貨人姓名CVSCOMPhone取貨人手機號碼Varchar(10)取貨人手機號碼範例:MPG技術串接手冊智通數位科技股份有限公司42網路互聯.
通道整合.
支付金流.
核心技術原始接收資料:[Status]=>SUCCESS[MerchantID]=>MS140446[TradeInfo]=>3716aa2a929c1b40071a732f1b8c57c3ecb6a6aeefed4061705dba662c14d0ecd5ae3aa9ed14e96745b3542fdda87c89ad4e9909e9b7f8d05288dae032526e7e0825b39b9e4df97b7b70e50866a71b6f9e17c6514e56cf5e3befee9c3371df309a2a780fc113daad47417a3ff8a6846665b074a59d360ad58c1e078571d544831e37a9dc21b3a1c4c8ccda88f3dbe8cab97e90ebd2e1f9b803bac5d08e8d34473080de6b94662d88092a1892f171f70285d3e5c6d9cf3c776eabf3340225994901be66d77b58603fe8d6251699c6d831a511ed928980e0588cab94cd355380bf6ceb7d8acac68fd5491d4b12c350c4fac1acae9ce9baa3021220b1bc18b552a13b24f70d19e895f169753789fb115966f15a9c0f3e8b55fdeaea1d6306d971a85f18b0607c8450e3cc38860bfcfee06ddcc08913b7bbbc5092adbc7c27f4b149ddafb49e30718e0d447696faf3deb721d16740271786bf271600a5ec2f61f52373c8d474898815f08990535dd3f99cc1209ce7572a0973c66f79b84a2893e1d18b798c19df714f223cd6451b88019ae04a73d75817b0cf03127c538fc84e67bf12edfcb23b5820dd691bb52d815f362759a4cdae12e5b71bcc4d2209ad7f36ed4a48886777c92251e54edd9a65214da3a0db1763acb7e41f33ef7f36aa91b0c197131418df75d19e9e383f0fd2e7357dec0c8aacb2edf77de46dc5a653ea96deb1d3eced87cf048b61985f8911afbddeefb05cea8dea2153b1845d902d02611ca761392e157ac79096fdaf6dfb1173a0e80fdb97160db1ca7b12ac0a40b452878fd50aa71a18eaddf8e619259495c61636e926b997d41828d783e7d60932f826e5b0c2e74e3650ce938d0b7e7da4a54532ef62d53ed195f5353a44bb5ad495dd51fbdc13f705f0d1617d370077a6983fe135eaa16de394e02159dd256e79accc226decb2556b14230633b53db80965c27ec6dd1172261ed59272de417787b98e[TradeSha]=>FF6D97B2AE2CB80859E8AC413A4272DEAF33CDCC3C60B434AA9470401A32822DTradeInfoAES解密(String):[Status]=>SUCCESS[Message]=>授權成功[Result]=>Array([MerchantID]=>MS140446[Amt]=>241[TradeNo]=>17101313213284148[MerchantOrderNo]=>T15078720262026[RespondType]=>JSON[IP]=>59.
124.
92.
194[EscrowBank]=>HNCB[PaymentType]=>CREDIT[PayTime]=>2017-10-1313:21:33[RespondCode]=>00[Auth]=>930637[Card6No]=>400022[Card4No]=>1111[Exp]=>2204[TokenUseStatus]=>1[InstFirst]=>0[InstEach]=>0[Inst]=>0[ECI]=>[StoreID]=>F002952[StoreType]=>全家[StoreName]=>全家重陽店[StoreAddr]=>MPG技術串接手冊智通數位科技股份有限公司43網路互聯.
通道整合.
支付金流.
核心技術台北市南港區重陽路183號1樓[TradeType]=>3[CVSCOMName]=>王小明[CVSCOMPhone]=>0900000123MPG技術串接手冊智通數位科技股份有限公司44網路互聯.
通道整合.
支付金流.
核心技術七、取號完成系統回傳參數說明(一)適用的交易類別:非即時交易支付方式:ATM轉帳(VACC)、超商代碼繳費(CVS)、超商條碼繳費(BARCODE)、超商取貨付款(CVSCOM).
(二)回傳參數說明:1.
完成取號後,將結果導回商店設定的CustomerURL頁面.
2.
當CustomerURL為空值時,取號結果會顯示在智付通付款頁面上.
(三)回應訊息格式為依TradeInfo所帶的參數回傳對應格式.
回傳格式為兩種:Json及String:1.
若RespondType=JSON,則請參考以下「JSON回傳參數說明」.
2.
若RespondType=String,則請參考以下「String回傳參數說明」.
參數名稱參數中文名稱型態備註Status回傳狀態Varchar(10)1.
若交易付款成功,則回傳SUCCESS.
2.
若交易付款失敗,則回傳錯誤代碼.
錯誤代碼請參考十、錯誤代碼.
MerchantID回傳訊息Varchar(20)智付通商店代號.
TradeInfo交易資料AES加密1.
將交易資料參數(下方列表中參數)透過商店Key及IV進行AES加密.
2.
範例請參考八、交易資料AES加解密TradeSha交易資料SHA256加密1.
將交易資料經過上述AES加密過的字串,透過商店Key及IV再進行SHA256加密.
2.
範例請參考九、交易資料SHA256加密Version串接程式版本Varchar(5)串接程式版本(1)JSON回傳參數說明:參數名稱參數中文名稱型態備註Status回傳狀態Varchar(10)1.
若取號成功,則回傳SUCCESS.
2.
若取號失敗,則回傳錯誤代碼.
錯誤代碼請參考十、錯誤代碼.
Message回傳訊息Varchar(50)文字,敘述此次交易狀態.
MPG技術串接手冊智通數位科技股份有限公司45網路互聯.
通道整合.
支付金流.
核心技術Result回傳參數當RespondType為JSON時,回傳參數會放至此陣列下.
ATM轉帳、超商代碼繳費、超商條碼繳費、超商取貨付款共同回傳參數MerchantID商店代號Varchar(15)智付通商店代號.
Amt支付金額Int(10)本次交易金額,例:1000.
TradeNo智付通交易序號Varchar(20)智付通在此筆交易取號成功時所產生的序號.
MerchantOrderNo商店訂單編號Varchar(20)1.
商店自訂訂單編號,限英、數字、"_"格式.
例:201406010001.
2.
同一商店中此編號不可重覆.
PaymentType支付方式Varchar(10)請參考一.
ExpireDate繳費截止日期DateTime回傳格式為yyyy-mm-dd.
註:超商取貨付款不回傳此參數.
ATM轉帳回傳參數BankCode金融機構代碼Varchar(10)1.
若取號成功,此欄位呈現數值.
2.
若取號失敗,此欄位呈現空值.
CodeNo繳費代碼Varchar(30)1.
若取號成功,此欄位呈現數值.
2.
若取號失敗,此欄位呈現空值.
超商代碼繳費回傳參數CodeNo繳費代碼Varchar(30)1.
若取號成功,此欄位呈現數值.
2.
若取號失敗,此欄位呈現空值.
超商條碼繳費回傳參數Barcode_1第一段條碼Varchar(20)1.
若取號成功,此欄位呈現數值.
2.
若取號失敗,此欄位呈現空值.
Barcode_2第二段條碼Varchar(20)1.
若取號成功,此欄位呈現數值.
2.
若取號失敗,此欄位呈現空值.
Barcode_3第三段條碼Varchar(20)1.
若取號成功,此欄位呈現數值.
2.
若取號失敗,此欄位呈現空值.
超商物流回傳參數StoreCode超商門市編號Varchar(10)取貨門市編號StoreName超商門市名稱Varchar(15)取貨門市中文名稱StoreType超商類別名稱Varchar(10)回傳[全家]、[OK]、[萊爾富]StoreAddr超商門市地址Varchar(100)取貨門市地址TradeType取件交易方式Int(1)1=取貨付款3=取貨不付款MPG技術串接手冊智通數位科技股份有限公司46網路互聯.
通道整合.
支付金流.
核心技術CVSCOMName取貨人Varchar(20)取貨人姓名CVSCOMPhone取貨人手機號碼Varchar(10)取貨人手機號碼範例:原始接收資料:[Status]=>SUCCESS[MerchantID]=>3430112[TradeInfo]=>545c49e585b9ed22e5b4ecf4061a362fec3d1a449ee315ad86405e6f32a3b71f27d2f910ba42b49d4768f843349f7c99497ef4d53616a64bf85d8550b459587dfd8b0104a1642cb742e3becb6094b1b7351182575db14fc0b90bd07df5f831e5682f1d40e9c481419c70f1e36265c8cfe127bbe0b9904d8a8e8f166b56a6e4702a31b7453615f2c5c49f11dac2362a8f4248b9f5f480d59d43f42e40e6c509ba761cbdddeb8f1fbf9e5396150984de6bcc3389a614e918758b6828774d953a3d5105bd8777aa81d3639dd0cf656280ce4c2e0d5bef75c3d02ea1533c64bfeab6a99545e83044692130fc45abcae17fcc66d22fa676e24086664636e54de70df302c711515db10049d97a8d4ec31d586668d84c87ab53ea3994a0af0a6b50f544122f592d89f45f1f081c74b15cf1faeb05c27ba61548ca410a6f56a9766316825ce16729a3061473eeaf023d105b1d5d02aa6ad3b56525925609ec2a958a9d77[TradeSha]=>5615081069F6A40563E4704B149FD1AEF63964CE19C431BD27E2F4C1DD2A6484TradeInfoAES解密(JSON):{"Status":"SUCCESS","Message":"\u53d6\u865f\u6210\u529f","Result":{"MerchantID":"3430112","Amt":40,"TradeNo":"17012412015573044","MerchantOrderNo":"S_1485230508","CheckCode":"5DDD45141A73460637D9B464A3F800997EB0C21D7483F354F3674474FB7D064A","PaymentType":"CVS","ExpireDate":"2017-01-31","ExpireTime":"23:59:59","CodeNo":"LCB70124004332"}}MPG技術串接手冊智通數位科技股份有限公司47網路互聯.
通道整合.
支付金流.
核心技術(2)String回傳參數說明:參數名稱參數中文名稱型態備註Status回傳狀態Varchar(10)1.
若取號成功,則回傳SUCCESS.
2.
若取號失敗,則回傳錯誤代碼.
錯誤代碼請參考十、錯誤代碼.
Message回傳訊息Varchar(50)文字,敘述此次交易狀態.
ATM轉帳、超商代碼繳費、超商條碼繳費共同回傳參數MerchantID商店代號Varchar(15)智付通商店代號.
Amt支付金額Int(10)本次交易金額,例:1000.
TradeNo智付通交易序號Varchar(20)智付通在此筆交易取號成功時所產生的序號.
MerchantOrderNo商店訂單編號Varchar(20)1.
商店自訂訂單編號,限英、數字、"_"格式.
例:201406010001.
2.
同一商店中此編號不可重覆.
PaymentType支付方式Varchar(10)請參考一.
ExpireDate繳費截止日期DateTime回傳格式為yyyy-mm-dd.
註:超商取貨付款不回傳此參數.
ATM轉帳回傳參數BankCode金融機構代碼Varchar(10)1.
若取號成功,此欄位呈現數值.
2.
若取號失敗,此欄位呈現空值.
CodeNo繳費代碼Varchar(30)1.
若取號成功,此欄位呈現數值.
2.
若取號失敗,此欄位呈現空值.
超商代碼繳費回傳參數CodeNo繳費代碼Varchar(30)1.
若取號成功,此欄位呈現數值.
2.
若取號失敗,此欄位呈現空值.
超商條碼繳費回傳參數Barcode_1第一段條碼Varchar(20)1.
若取號成功,此欄位呈現數值.
2.
若取號失敗,此欄位呈現空值.
Barcode_2第二段條碼Varchar(20)1.
若取號成功,此欄位呈現數值.
2.
若取號失敗,此欄位呈現空值.
Barcode_3第三段條碼Varchar(20)1.
若取號成功,此欄位呈現數值.
2.
若取號失敗,此欄位呈現空值.
超商物流回傳參數StoreCode超商門市編號Varchar(10)取貨門市編號MPG技術串接手冊智通數位科技股份有限公司48網路互聯.
通道整合.
支付金流.
核心技術StoreName超商門市名稱Varchar(15)取貨門市中文名稱StoreType超商類別名稱Varchar(10)回傳[全家]、[OK]、[萊爾富]StoreAddr超商門市地址Varchar(100)取貨門市地址TradeType取件交易方式Int(1)1=取貨付款3=取貨不付款CVSCOMName取貨人Varchar(20)取貨人姓名CVSCOMPhone取貨人手機號碼Varchar(10)取貨人手機號碼範例:原始接收資料:[Status]=>SUCCESS[MerchantID]=>3430112[TradeInfo]=>94a909dab41266966a3330d12116c59a091ebae6bdb57dce952fe6c53ab5b0d5392aaf14e3755a04321d15493f46e66610a1c0fda7ef36d89c8d510964359a485638f87dcbc52630c19f507d3304df70887f0d3a92a5a14612cd7e9870d432266c9d3e076a724e031ca3b5624d6a6c3fba77b90a78ac887a51e0695468fdf185d4d41abe60d72d0a23c1781fa98b2e022d372d1941c3f4f24f3008ce622c805dd4327e34f850de67427bec774cd6fa39f27c87de3ff5da137f0ac6094ba300e113fd6550e3ee613c63b3afe3bb5462380a70cc00ec01c9296c78190334e1aa6aa09e7fa3b8be4a5c2f76abd9bded1f528a4a1f947cd3051ecd075cd951448663ad2ff6be73f9483293b5346d86a5a634956e2e271db96bbd1fd1394f29b0d6a0c79c6041e6de8ff2683403de903ed064ed22aeb44ff526aac8a3747075d42827[TradeSha]=>3E7C73947643EC4D3CE518516DC9E5391830487E1B5B19C72E0AD9757F27A057TradeInfoAES解密(String):[Status]=>SUCCESS[Message]=>取號成功[MerchantID]=>3430112[Amt]=>30[TradeNo]=>17012412032407658[MerchantOrderNo]=>S_1485230597[CheckCode]=>08B031DB0F8005198456F613F7D24F7CFE9C2E9ADE645DD3103BB66B29AA530E[PaymentType]=>CVS[ExpireDate]=>2017-01-31[ExpireTime]=>23:59:59[CodeNo]=>LCB70124004348MPG技術串接手冊智通數位科技股份有限公司49網路互聯.
通道整合.
支付金流.
核心技術八、交易資料AES加解密將交易資料透過商店專屬加密HashKey與商店專屬加密HashIV,產生AES256加密交易資料.
範例資料:[MerchantID]=>3430112[RespondType]=>JSON[TimeStamp]=>1485232229[Version]=>1.
4[MerchantOrderNo]=>S_1485232229[Amt]=>40[ItemDesc]=>UnitTestKey='12345678901234567890123456789012';IV='1234567890123456';以下提供PHP版本程式語言編寫AES256加密語法範例以供參考:functioncreate_mpg_aes_encrypt($parameter="",$key="",$iv=""){$return_str='';if(!
empty($parameter)){//將參數經過URLENCODEDQUERYSTRING$return_str=http_build_query($parameter);}returntrim(bin2hex(openssl_encrypt(addpadding($return_str),'aes-256-cbc',$key,OPENSSL_RAW_DATA|OPENSSL_ZERO_PADDING,$iv)));}functionaddpadding($string,$blocksize=32){$len=strlen($string);$pad=$blocksize-($len%$blocksize);$string.
=str_repeat(chr($pad),$pad);return$string;}MPG技術串接手冊智通數位科技股份有限公司50網路互聯.
通道整合.
支付金流.
核心技術$trade_info_arr=array('MerchantID'=>3430112,'RespondType'=>'JSON','TimeStamp'=>1485232229,'Version'=>1.
4,'MerchantOrderNo'=>'S_1485232229','Amt'=>40,'ItemDesc'=>'UnitTest');$mer_key='12345678901234567890123456789012';$mer_iv='1234567890123456';//交易資料經AES加密後取得TradeInfo$TradeInfo=create_mpg_aes_encrypt($trade_info_arr,$mer_key,$mer_iv);加密後字串(TradeInfo)為:ff91c8aa01379e4de621a44e5f11f72e4d25bdb1a18242db6cef9ef07d80b0165e476fd1d9acaa53170272c82d122961e1a0700a7427cfa1cf90db7f6d6593bbc93102a4d4b9b66d9974c13c31a7ab4bba1d4e0790f0cbbbd7ad64c6d3c8012a601ceaa808bff70f94a8efa5a4f984b9d41304ffd879612177c622f75f4214fa解密程式:functioncreate_aes_decrypt($parameter="",$key="",$iv=""){returnstrippadding(openssl_decrypt(hex2bin($parameter),'AES-256-CBC',$key,OPENSSL_RAW_DATA|OPENSSL_ZERO_PADDING,$iv));}functionstrippadding($string){$slast=ord(substr($string,-1));$slastc=chr($slast);$pcheck=substr($string,-$slast);if(preg_match("/$slastc{".
$slaststring)){$string=substr($string,0,strlen($string)-$slast);return$string;}else{returnfalse;}}MPG技術串接手冊智通數位科技股份有限公司51網路互聯.
通道整合.
支付金流.
核心技術以下提供.
netc#版本程式語言編寫AES256加密語法範例以供參考:publicstringEncryptAES256(stringsource)//加密{stringsSecretKey="12345678901234567890123456789012";stringiv="1234567890123456";byte[]sourceBytes=AddPKCS7Padding(Encoding.
UTF8.
GetBytes(source),32);varaes=newRijndaelManaged();aes.
Key=Encoding.
UTF8.
GetBytes(sSecretKey);aes.
IV=Encoding.
UTF8.
GetBytes(iv);aes.
Mode=CipherMode.
CBC;aes.
Padding=PaddingMode.
None;ICryptoTransformtransform=aes.
CreateEncryptor();returnByteArrayToHex(transform.
TransformFinalBlock(sourceBytes,0,sourceBytes.
Length)).
ToLower();}publicstringDecryptAES256(stringencryptData)//解密{stringsSecretKey="12345678901234567890123456789012";stringiv="1234567890123456";varencryptBytes=HexStringToByteArray(encryptData.
ToUpper());varaes=newRijndaelManaged();aes.
Key=Encoding.
UTF8.
GetBytes(sSecretKey);aes.
IV=Encoding.
UTF8.
GetBytes(iv);aes.
Mode=CipherMode.
CBC;aes.
Padding=PaddingMode.
None;ICryptoTransformtransform=aes.
CreateDecryptor();returnEncoding.
UTF8.
GetString(RemovePKCS7Padding(transform.
TransformFinalBlock(encryptBytes,0,encryptBytes.
Length)));}privatestaticbyte[]AddPKCS7Padding(byte[]data,intiBlockSize){intiLength=data.
Length;bytecPadding=(byte)(iBlockSize-(iLength%iBlockSize));MPG技術串接手冊智通數位科技股份有限公司52網路互聯.
通道整合.
支付金流.
核心技術varoutput=newbyte[iLength+cPadding];Buffer.
BlockCopy(data,0,output,0,iLength);for(vari=iLength;i>4));c[i*2]=(char)(b>9b+0x37:b+0x30);b=((byte)(barray[i]&0xF));c[i*2+1]=(char)(b>9b+0x37:b+0x30);}returnnewstring(c);}privatestaticbyte[]HexStringToByteArray(stringhexString){inthexStringLength=hexString.
Length;byte[]b=newbyte[hexStringLength/2];for(inti=0;i0x40hexString[i]-0x37:hexString[i]-0x30)0x40hexString[i+1]-0x37:hexString[i+1]-0x30;b[i/2]=Convert.
ToByte(topChar+bottomChar);}returnb;MPG技術串接手冊智通數位科技股份有限公司53網路互聯.
通道整合.
支付金流.
核心技術}MPG技術串接手冊智通數位科技股份有限公司54網路互聯.
通道整合.
支付金流.
核心技術九、交易資料SHA256加密1.
將交易資料的AES加密字串前後加上商店專屬加密HashKey與商店專屬加密HashIV.
2.
將串聯後的字串用SHA256壓碼後轉大寫.
範例程式:1.
交易資料AES加密字串ff91c8aa01379e4de621a44e5f11f72e4d25bdb1a18242db6cef9ef07d80b0165e476fd1d9acaa53170272c82d122961e1a0700a7427cfa1cf90db7f6d6593bbc93102a4d4b9b66d9974c13c31a7ab4bba1d4e0790f0cbbbd7ad64c6d3c8012a601ceaa808bff70f94a8efa5a4f984b9d41304ffd879612177c622f75f4214fa2.
前後加上商店專屬的HashKey及HashIVHashKey=12345678901234567890123456789012&ff91c8aa01379e4de621a44e5f11f72e4d25bdb1a18242db6cef9ef07d80b0165e476fd1d9acaa53170272c82d122961e1a0700a7427cfa1cf90db7f6d6593bbc93102a4d4b9b66d9974c13c31a7ab4bba1d4e0790f0cbbbd7ad64c6d3c8012a601ceaa808bff70f94a8efa5a4f984b9d41304ffd879612177c622f75f4214fa&HashIV=12345678901234563.
使用SHA256壓碼過後並轉大寫strtoupper(hash("sha256","上面字串"));壓碼結果為:EA0A6CC37F40C1EA5692E7CBB8AE097653DF3E91365E6A9CD7E91312413C7BB8MPG技術串接手冊智通數位科技股份有限公司55網路互聯.
通道整合.
支付金流.
核心技術以下提供VB.
net版本程式語言,sha256加密範例以供參考:以下提供C#版本程式語言,sha256加密範例以供參考:PublicFunctionSHA256_Encrypt(ByValContentAsString)AsStringDimsha256AsNewSecurity.
Cryptography.
SHA256CryptoServiceProviderDimByteString()AsByte=System.
Text.
Encoding.
ASCII.
GetBytes(Content)ByteString=sha256.
ComputeHash(ByteString)DimReturnStringAsString=NothingForEachbtAsByteInByteStringReturnString&=bt.
ToString("x2")NextReturnReturnStringEndFunctionusingSystem.
Security.
Cryptography;publicvoidMain(){Console.
WriteLine(getHashSha256("HashKey=1A2B3C4D5E&Amt=78&MerchantID=13415434&MerchantOrderNo=1450940783&TimeStamp=1450940783&Version=1.
1&HashIV=5E4D3C2B1A"));}publicstaticstringgetHashSha256(stringtext){byte[]bytes=Encoding.
UTF8.
GetBytes(text);SHA256Managedhashstring=newSHA256Managed();byte[]hash=hashstring.
ComputeHash(bytes);stringhashString=string.
Empty;foreach(bytexinhash){hashString+=String.
Format("{0:x2}",x);}returnhashString.
ToUpper();}MPG技術串接手冊智通數位科技股份有限公司56網路互聯.
通道整合.
支付金流.
核心技術十、錯誤代碼商店可能遭遇下列錯誤狀況,其錯誤代碼與對應的錯誤原因如下表所示:錯誤代碼錯誤原因備註MPG01001會員參數不可空白/設定錯誤LoginTypeMPG01002時間戳記不可空白TimeStampMPG01005TokenTerm不可空白/設定錯誤TokenTermMPG01008分期參數設定錯誤InstFlagMPG01009商店代號不可空白MerchantIDMPG01010程式版本設定錯誤VersionMPG01011回傳規格設定錯誤RespondTypeMPG01012商店訂單編號不可空白/設定錯誤MerchantOrderNo:限英數字、底線,長度20字MPG01013付款人電子信箱設定錯誤EmailMPG01014網址設定錯誤ReturnURL、NotifyURL、CustomerURL、ClientBackURLMPG01015訂單金額不可空白/設定錯誤AmtMPG01017商品資訊不可空白ItemDescMPG01018繳費有效期限設定錯誤ExpireDateMPG01023交易加密資料不可空白TradeInfoMPG01024交易加密SHA資料不可空白TradeShaMPG02002查無商店開啟任何金流服務MPG02003支付方式未啟用,請洽客服中心MPG02004送出後檢查,超過交易限制秒數MPG02005送出後檢查,驗證資料錯誤MPG02006系統發生異常,請洽客服中心MPG03001FormPost加密失敗MPG03002拒絕交易IPMPG03003IP交易次數限制N分鐘內不可交易達M次MPG技術串接手冊智通數位科技股份有限公司57網路互聯.
通道整合.
支付金流.
核心技術MPG03004商店狀態已被暫停或是關閉,無法進行交易MPG03007查無此商店代號MPG03008已存在相同的商店訂單編號MPG03009交易失敗MPG技術串接手冊智通數位科技股份有限公司58網路互聯.
通道整合.
支付金流.
核心技術一、支付方式對照說明支付方式參數值中文名稱交易性質CREDIT信用卡即時交易WEBATMWebATM即時交易VACCATM轉帳非即時交易CVS超商代碼繳費非即時交易BARCODE超商條碼繳費非即時交易CVSCOM超商取貨付款非即時交易智付通會回應商店,消費者所選擇的支付方式,並紀錄於PaymentType參數裡.
當消費者使用信用卡支付方式時,PaymentType參數值為CREDIT,以此類推.