Skip to content

Latest commit

 

History

History
242 lines (176 loc) · 8.55 KB

Decode.md

File metadata and controls

242 lines (176 loc) · 8.55 KB
Raw

綠界金流串接服務

產生訂單

應用場景：

以下為舉例待加密的字串：

TradeDesc=促銷方案&PaymentType=aio&MerchantTradeDate=2018/05/04 09:50:23&MerchantTradeNo=ecpay20180504110723&MerchantID=2000132&ReturnURL=https://www.ecpay.com.tw/receive.php&ItemName=Apple iphone 7 手機殼&TotalAmount=1000&ChoosePayment=ALL&EncryptType=1
  1. 將傳遞參數依照第一個英文字母，由 A 到 Z 的順序來排序(遇到第一個英名字母相同時，以第二個英名字母來比較，以此類推)，並且以&方式將所有參數串連。
ChoosePayment=ALL&EncryptType=1&ItemName=Apple iphone 7 手機殼&MerchantID=2000132&MerchantTradeDate=2018/05/04 11:07:23&MerchantTradeNo=ecpay20180504110723&PaymentType=aio&ReturnURL=https://www.ecpay.com.tw/receive.php&TotalAmount=1000&TradeDesc=促銷方案
  1. 參數最前面加上 HashKey、最後面加上 HashIV
HashKey=5294y06JbISpM5x9&ChoosePayment=ALL&EncryptType=1&ItemName=Apple iphone 7 手機殼&MerchantID=2000132&MerchantTradeDate=2018/05/04 11:07:23&MerchantTradeNo=ecpay20180504110723&PaymentType=aio&ReturnURL=https://www.ecpay.com.tw/receive.php&TotalAmount=1000&TradeDesc=促銷方案&HashIV=v77hoKGq4kWxNNIS
  1. 將整串字串進行 URL encode
HashKey%3d5294y06JbISpM5x9%26ChoosePayment%3dALL%26EncryptType%3d1%26ItemName%3dApple+iphone+7+%e6%89%8b%e6%a9%9f%e6%ae%bc%26MerchantID%3d2000132%26MerchantTradeDate%3d2018%2f05%2f04+11%3a07%3a23%26MerchantTradeNo%3decpay20180504110723%26PaymentType%3daio%26ReturnURL%3dhttps%3a%2f%2fwww.ecpay.com.tw%2freceive.php%26TotalAmount%3d1000%26TradeDesc%3d%e4%bf%83%e9%8a%b7%e6%96%b9%e6%a1%88%26HashIV%3dv77hoKGq4kWxNNIS
  1. 轉為小寫
hashkey%3d5294y06jbispm5x9%26choosepayment%3dall%26encrypttype%3d1%26itemname%3dapple+iphone+7+%e6%89%8b%e6%a9%9f%e6%ae%bc%26merchantid%3d2000132%26merchanttradedate%3d2018%2f05%2f04+11%3a07%3a23%26merchanttradeno%3decpay20180504110723%26paymenttype%3daio%26returnurl%3dhttps%3a%2f%2fwww.ecpay.com.tw%2freceive.php%26totalamount%3d1000%26tradedesc%3d%e4%bf%83%e9%8a%b7%e6%96%b9%e6%a1%88%26hashiv%3dv77hokgq4kwxnnis
  1. 以 SHA256 加密方式來產生雜凑值(大寫)
B4A5010C622CC8710182465D1A8CFFF29B9212264E679C8468893C4A6EBB716B
  1. Postman 模擬訂單 :::info POST https://payment-stage.ecpay.com.tw/SP/CreateTrade :::
  • Body parameters
Body參數 傳輸格式 描述
ChoosePayment(必填) form-data 選擇預設付款方式
EncryptType(必填) form-data CheckMacValue 加密類型
ItemName(必填) form-data 商品名稱
MerchantID(必填) form-data 特店編號
MerchantTradeDate(必填) form-data 特店交易時間
MerchantTradeNo(必填) form-data 特店交易編號
PaymentType(必填) form-data 交易類型
ReturnURL(必填) form-data 付款完成通知回傳網址
TotalAmount(必填) form-data 交易金額
TradeDesc(必填) form-data 交易描述
CheckMacValue(必填) form-data 檢查碼

:::warning Request Content-Type: form-data

key value
ChoosePayment ALL
EncryptType 1
ItemName Apple iphone 7 手機殼
MerchantID 2000132
MerchantTradeDate 2018/05/04 11:07:23
MerchantTradeNo ecpay20180504110723
PaymentType aio
ReturnURL https://www.ecpay.com.tw/receive.php
TotalAmount 1000
TradeDesc 促銷方案
CheckMacValue B4A5010C622CC8710182465D1A8CFFF29B9212264E679C8468893C4A6EBB716B
:::
新增訂單

Success 200

:::success Response Content-Type: application/json

{"RtnCode":"1","RtnMsg":"成功","SPToken":"0182A83944344D96817ABE1EF4176BB4","MerchantID":"2000132","MerchantTradeNo":"ecpay20180504110723","CheckMacValue":"262CFB85115E454900990E9C12DD1F9715340F8073006B6B896DC670FB62DA2E"}

:::

進行交易訂單

:::warning 前端付款按鈕

<script src="https://payment-stage.ecpay.com.tw/Scripts/SP/ECPayPayment_1.0.0.js"
 data-MerchantID="2000132"
 data-SPToken="E1AEEC8F56EA4A07B49008BD1462BD2E"
 data-PaymentType="CREDIT "
 data-PaymentName="信用卡"
 data-CustomerBtn="0" >
</script>

:::

查詢訂單

以下為舉例待加密的字串：

MerchantID=2000132&MerchantTradeNo=ecpay20180504112423&TimeStamp=1525410372
  1. 將傳遞參數依照第一個英文字母，由 A 到 Z 的順序來排序(遇到第一個英名字母相同時，以第二個英名字母來比較，以此類推)，並且以&方式將所有參數串連。
MerchantID=2000132&MerchantTradeNo=ecpay20180504112423&TimeStamp=1525410372
  1. 參數最前面加上 HashKey、最後面加上 HashIV
HashKey=5294y06JbISpM5x9&MerchantID=2000132&MerchantTradeNo=ecpay20180504112423&TimeStamp=1525410372&HashIV=v77hoKGq4kWxNNIS
  1. 將整串字串進行 URL encode
HashKey%3d5294y06JbISpM5x9%26MerchantID%3d2000132%26MerchantTradeNo%3decpay20180504112423%26TimeStamp%3d1525410372%26HashIV%3dv77hoKGq4kWxNNIS
  1. 轉為小寫
hashkey%3d5294y06jbispm5x9%26merchantid%3d2000132%26merchanttradeno%3decpay20180504112423%26timestamp%3d1525410372%26hashiv%3dv77hokgq4kwxnnis
  1. 以 SHA256 加密方式來產生雜凑值(大寫)
48ABB4DBF2365897B2A17C48EBCBA82274E7D7DE79F1F955115C4258482A045B
  1. Postman 查詢訂單 :::info POST https://payment-stage.ecpay.com.tw/Cashier/QueryTradeInfo/V5 :::
  • Body parameters
Body參數 傳輸格式 描述
MerchantID(必填) form-data 特店編號
MerchantTradeNo(必填) form-data 特店交易編號
TimeStamp(必填) form-data 驗證時間
CheckMacValue(必填) form-data 檢查碼

線上取得時間戳記

:::warning Request Content-Type: form-data

key value
MerchantID 2000132
MerchantTradeNo ecpay20180504112423
TimeStamp 1525406240
CheckMacValue 48ABB4DBF2365897B2A17C48EBCBA82274E7D7DE79F1F955115C4258482A045B
:::
查詢訂單

Success 200

:::success Response Content-Type: text

CustomField1=&CustomField2=&CustomField3=&CustomField4=&HandlingCharge=1&ItemName=Apple iphone 7 手機殼&MerchantID=2000132&MerchantTradeNo=ecpay20180504112423&PaymentDate=2018/05/04 11:27:39&PaymentType=Credit_CreditCard&PaymentTypeChargeFee=1&StoreID=&TradeAmt=1000&TradeDate=2018/05/04 11:24:57&TradeNo=1805041124578172&TradeStatus=1&CheckMacValue=7FED9171711B628633FDBA39EBEE159E2E9A1A6AEB9ACD87B105778EECE2FB06

:::