58
綠界科技股份有限公司 Green World FinTech Service Co., Ltd. Apple Pay 介接技術文件 V 1.1.11 2019-11-27

Apple Pay介接技術文件 | 綠界科技 ECPay · 綠界金流服務對於有Apple Pay 信用卡收款需求的賣家會員,提供完整的交易介接技術包含 在 APP 中付款

  • Upload
    others

  • View
    2

  • Download
    0

Embed Size (px)

Citation preview

綠界科技股份有限公司 Green World FinTech Service Co., Ltd.

Apple Pay

介接技術文件

V 1.1.11 2019-11-27

Version History Version Date Content

V1.0.0 2017/01/15 Create

V1.0.1 2017/03/01 調整訂單查詢 API 規格

V1.0.2 2017/03/20 增加 Apple Pay 憑證申請說明

V1.0.3 2017/03/30 調整文件內容,增加交易流程圖

V1.0.4 2017/04/12 調整範例格式

V1.0.5 2017/04/14 調整前置事項說明

V1.0.6 2017/04/17 增加查詢信用卡單筆明細記錄 API 及下載信用卡撥款對帳資料檔 API

V1.0.7 2017/04/18 1.增加 AES 加密使用參數說明 CipherMode : CBC,PaddingMode:PKCS7

2.增加平台商使用注意事項,及串接時 PlatformID 請使用店家的 MerchantID

V1.0.8 2017/04/19 調整 Apple 開發前置準備事項

V1.0.9 2017/04/21 ApplePay 信用卡授權作業增加 TradeType 參數,接受 In App 授權交易

V1.1.0 2017/05/05 增加 Apple Pay 開發者帳號申請說明

V1.1.1 2017/05/08 增加 URLEncode 轉換表

V1.1.2 2017/05/17 增加提醒廠商在匯出 p12 格式憑證時須設定密碼

V1.1.3 2017/06/23 調整交易金額最低為 5 元

V1.1.4 2017/06/26 調整前置準備的測試準備項目說明

V1.1.5 2018/01/29 增加說明 Apple Pay 只支援 Iphone ios 9 以上

V1.1.6 2018/03/07 調整注意事項表格格式

增加前置準備注意事項說明,串接只支援 TLS 1.2 以上之加密通訊協定

V1.1.7 2018/10/11 下載信用卡撥款對帳資料檔增加下載檔案編碼格式參數

信用卡紅利折抵規則改為不可部分刷退

V1.1.8 2019/04/11 增加信用卡退刷注意事項

V1.1.9 2019/07/29 修改產生訂單參數[TotalAmount]說明欄

V1.1.10 2019/08/14 新增串接前注意事項

新增 ItemName 參數說明事項

V1.1.11 2019/11/27 修改[ItemName]參數說明

目錄

1. 簡介................................................................................................................................................ 4

2. ApplePay 開發者前置準備說明 ................................................................................................... 5

2.1 建立商務帳號 CREATE MERCHANT ID ............................................................................................................................. 5

2.2 建立交易憑證 CREATE PAYMENT PROCESSING CERTIFICATE ................................................................................................. 8

2.3 ADD DOMAIN (僅限 APPLE PAY ON THE WEB).................................................................................................................... 14

2.4 CREATE MERCHANT IDENTITY CERTIFICATE (僅限 APPLE PAY ON THE WEB).............................................................................. 18

2.5 建立沙盒測試帳號 .................................................................................................................................................... 23

2.6 綁定測試卡號 ............................................................................................................................................................ 24

3. 綠界科技測試環境系統介接相關資訊:.................................................................................. 26

4. ApplePay 信用卡付款串接說明 ................................................................................................. 28

4.1 交易流程圖 ................................................................................................................................................................ 28

4.2 商戶端 APPLEPAY 串接說明 ........................................................................................................................................ 29

4.3 綠界 APPLEPAY 串接說明 ............................................................................................................................................. 33

5. 訂單資料查詢.............................................................................................................................. 35

6. 信用卡關帳/退刷/取消/放棄 (若不撰寫此 API,則可透過廠商後台功能處理) .................. 38

7. 查詢信用卡單筆明細記錄.......................................................................................................... 40

8. 下載信用卡撥款對帳資料檔...................................................................................................... 44

9. APPLE 開發者帳號申請說明 ..................................................................................................... 46

附錄 1. 檢查碼機制.......................................................................................................................... 50

附錄 2. AES 資料加密 ...................................................................................................................... 52

附錄 3. 交易訊息代碼一覽表.......................................................................................................... 57

附錄 4. URLEncode 轉換表 .............................................................................................................. 58

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 4 / 55

1. 簡介

綠界金流服務對於有 Apple Pay 信用卡收款需求的賣家會員,提供完整的交易介接技術包含

在 APP 中付款

消費者使用 Apple Pay ,可以簡易又安全的方式在您的 app 內購物。輕鬆結帳,只要消費者的

手指放在 Touch ID 上這麼簡單,完成交易付款。

在網頁中付款

讓消費者在 Safari 中的網頁,可享有同樣的便利付款。不論消費者是以 iPhone、iPad 或 Mac 購

物,都能使用 ApplePay,而且不必建立帳戶或登入。從此只要輕輕一觸,就能在你的網站上付

款,享受比以往更快速、容易且安全的新體驗。

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 5 / 55

2. ApplePay 開發者前置準備說明

2.1 建立商務帳號 Create Merchant ID

1. 請登入至您的 Apple 開發者帳戶

2. 選擇 “Certificates, Identifiers & Profiles.”

3. 選擇 “Merchant IDs”

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 6 / 55

4. 註冊商務資料

5. 確認註冊商務資料

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 7 / 55

6. 完成註冊商務資料

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 8 / 55

2.2 建立交易憑證 Create Payment Processing Certificate

1. 請登入至您的 Apple 開發者帳戶

2. 選擇 “Certificates, Identifiers & Profiles.”

3. 選擇功能選單 Identifiers 底下的 Merchant IDs

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 9 / 55

4. 選擇要新增憑證的 Merchant ID

5. 按 Edit 按鈕

6. 選擇 Payment Processing Certificate 裡的 Create Certificate 按鈕,建立商務交易憑證

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 10 / 55

7. 回答問題,請選擇 NO 並按 Continue

8. 閱讀憑證請求檔建立相關資訊後,按 Continue

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 11 / 55

9. 請使用 mac 電腦建置憑證請求檔

10. 選擇憑證演算法及長度(演算法請選擇 ECC,長度請選擇 256),並選擇儲存到磁碟

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 12 / 55

11. 將檔案直接儲存到硬碟後,取得憑證請求檔 CSR

12. 上傳憑證請求檔

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 13 / 55

13. 點擊 Download 按鈕來下載憑證,將它安裝至 mac 電腦鑰匙圈存取

14. 選擇交易憑證,匯出檔案 p12 格式(必須設定憑證密碼)

15. 把匯出後的憑證檔案(p12 格式)及憑證密碼提供給綠界科技

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 14 / 55

2.3 Add Domain (僅限 Apple Pay on the Web)

1. 請登入至您的 Apple 開發者帳戶

2. 選擇 “Certificates, Identifiers & Profiles.”

3. 選擇功能選單 Identifiers 底下的 Merchant IDs

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 15 / 55

4. 選擇要設定 Domain 的 Merchant ID

5. 按 Edit 按鈕

6. 選擇 Merchant Domains 中的 Add Domain 按鈕

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 16 / 55

7. 輸入要註冊的 domain name

8. 下載驗證檔案並放到指定位置,完成後點選 “Verify” 即可完成

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 17 / 55

注意事項:

1.在 IIS 平台上要記得先行設定 MIME 類型,讓 IIS 認得「.well-known\acme-challenge」鏈結路徑或在 config 設定

檔加入設定如下圖

2.網域 SSL 憑證必須符合下列指的 Cipher suite list

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 18 / 55

2.4 Create Merchant Identity Certificate (僅限 Apple Pay on the Web)

1. 請登入至您的 Apple 開發者帳戶

2. 選擇 “Certificates, Identifiers & Profiles.”

3. 選擇功能選單 Identifiers 底下的 Merchant IDs

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 19 / 55

4. 選擇 Merchant ID

5. 按 Edit 按鈕

6. 選擇 Merchant identity Certificate 中的 Create Certificate 按鈕

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 20 / 55

7. 閱讀憑證請求檔建立相關資訊後,按 Continue

8. 請使用 mac 電腦建置憑證請求檔

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 21 / 55

9. 上傳憑證請求檔

10. 點擊 Download 按鈕來下載憑證,將它安裝至 mac 電腦鑰匙圈存取

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 22 / 55

11. 匯出您的金鑰,檔案格式選個人資訊交換 (.p12),金鑰將會於驗證商家時使用

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 23 / 55

2.5 建立沙盒測試帳號

1. 用您的 Apple 開發者帳戶登入至 iTunes Connect

2. 選擇沙箱技術測人員,後點選+按鈕

填寫測試人員資料

3. 收取電子信箱驗證帳號,完成測試人員申請

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 24 / 55

2.6 綁定測試卡號

1. 登入你的裝置,在 iCloud 登入測試帳號

2. 更改裝置地區別為美國

3. 加入測試卡號

測試卡號網址: https://developer.apple.com/support/apple-pay-sandbox/

(限 MasterCard及 Visa 信用卡)

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 25 / 55

4. 設定->safari->檢查 apple pay 設定,請設定關閉

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 26 / 55

3. 綠界科技測試環境系統介接相關資訊:

欄位說明 欄位內容

須具備條件如下

1. 需成為綠界的特約商店 (申請時間約 10-15 天)

2. APPLE 僅接受銷售實體商品業者(非虛擬商品如遊戲點數)

3. 商店必須有 APPLE 的開發者帳號(個人/公司)

(公司帳號申請時間約一個月,APPLE 收年費為 USD100)

4. 自行設計付款頁,UI 設計需遵守 APPLE PAY 規範

5. Apple Pay 只支援 Iphone ios 9 以上

6. 商店需要自行接兩段程式:

與 APPLE PAY 的付款交易(須自備 SSL 加密環境)

與綠界的金流授權交易

7. APPLE PAY 交易環境必須支援 Transport Layer Security (TLS) 1.2 ,包含

消費者手機環境及廠商伺服器環境

測試準備項目

請在測試環境申請註冊會員

https://member-stage.ecpay.com.tw/MemberReg/MemberRegister?back=N

完成後請提供下列資訊:

1.申請綠界測試環境會員編號

2.申請 APPLE PAY 的 MerchantID

3. APPLE PAY 交易憑證的加密密碼(必須設置密碼)

4. APPLE PAY 交易憑證(Apple Pay Payment Processing) (請匯出 P12 及 ECC 格

式並壓縮 zip 檔)

5.APPLE PAY 交易憑證的到期日

6.商店驗證事件取得 merchantSession 中的 ECC 格式的 PaymentToken 物件

(須消費者付款指紋認証後才會取得,提供時無須經過 AES 加密的資料)

7. 建立付款請求物件的交易金額 (交易金額需五元以上)

將上述資料寄件至 [email protected] 信箱,我們將由專人進

行測試相關設定作業後,會通知廠商串接信用授權串接服務測試。

廠商管理後台測試環境

https://vendor-stage.ecpay.com.tw

此網站可提供:

1. 查詢 ecpay 訂單

2.測試環境金鑰取得資訊

系統開發管理=>系統介接設定取得以下金流介接HashKey及HashIV資訊

※注意事項:

(1) 接收傳送綠界 API 通知時,請合作廠商系統開發人員確認下面事項:

(2) 呼叫綠界 API 連接 port 只提供 https (443 port)連線方式,並請使用合法的 DNS(Domain Name System)進行介接。

(3) 請確認各項交易參數傳送時是使用 Http POST 方式傳送至綠界 API。

(4) 傳送參數值的內容不允許使用 html tag 標示,例如<br /> <B> <h1> …等。

(5) 請勿將金鑰資訊存放或顯示於前端網頁內,如 Javascript、html、Css…等,避免金鑰被盜取使用造成損失及交易資

料外洩。

(6) 傳送參數值的內容請用 UTF8 格式,且不支援中英文語系之外的文字內容。

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 27 / 55

(7) 本串接規格只接受新台幣交易付款,因此串接 Apple Pay 時參數 currencyCode 請使用 TWD。

(8) 因 Apple Pay 台灣尚未開放平台商審核使用,申請串接時一個店家須申請一個 APPLE PAY 的 MerchantID 及憑證。

(9) Apple Pay 不支援信用卡分期功能。

(10) 為保障消費者權益與網路交易安全,綠界串接服務只支援 TLS 1.2 以上之加密通訊協定。

(11) 若有使用國外卡的需求,請至廠商管理後台=>信用卡收單=>信用卡帳戶設定,申請開通[國外信用卡交易]並[啟用]。

正式環境金鑰取得資訊:

請登入廠商後台(https://vendor.ecpay.com.tw/)=>系統開發管理=>系統介接設定取得以下金流介接 HashKey 及

HashIV 資訊

客戶環境支援資訊:

目前 Apple Pay 支援 iPhone 6 之後機種 (包含 iPhone SE)、iPad Air 2、iPad mini 3 與 iPad Pro 系列機種使用,另外也

支援 Apple Watch 系列機種,以及 2012 年以後推出的 Mac 與 MacBook 系列機種使用,但僅有搭載 NFC 近場感應

機能的 iPhone 與 Apple Watch 可透過零售通路刷卡機付款,包含 iPad 系列、Mac 系列機種僅能在 App 內,或是透

過 Safari 瀏覽器在網頁服務中使用 Apple Pay 付款

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 28 / 55

4. ApplePay 信用卡付款串接說明

4.1 交易流程圖

ApplePay付款授權流程

銀行綠界科技金流Apple.com廠商消費者

1.選擇Apple PAY

2.申請商店驗證

3.進行驗證回應結果

4.提示付款

5.進行付款6.建立授權交易

7.審核授權

8.取得授權結果

9.取得授權結果

10.顯示交易結果

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 29 / 55

4.2 商戶端 ApplePay 串接說明

提供商家與 Apple 之間建立 session 及商家驗證作業前端應用說明。

商家頁面程式

Apple Pay 付款按鈕

◆ 樣式參考:https://developer.apple.com/reference/applepayjs/applepaysession#2674254

◆ 規範說明:https://developer.apple.com/apple-pay/Apple-Pay-Identity-Guidelines.pdf

Apple Pay 付款按鈕樣式

Supports (-webkit-appearance: -apple-pay-button) {

.apple-pay-button {

display: inline-block;

-webkit-appearance: -apple-pay-button;

}

}

supports not (-webkit-appearance: -apple-pay-button) {

.apple-pay-button {

display: inline-block;

background-size: 100% 60%;

background-repeat: no-repeat;

background-position: 50% 50%;

border-radius: 5px;

padding: 0px;

box-sizing: border-box;

min-width: 200px;

min-height: 32px;

max-height: 64px;

}

}

Apple Pay 付款按鈕

<div id="divPay">

<button id="btnApplePay" class="apple-pay-button apple-pay-button-white" lang="tw"

style="-webkit-appearance: -apple-pay-button; -apple-pay-button-type: buy; width: 400px; height:

64px;"></button>

</div>

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 30 / 55

支援 Apple Pay 付款檢查

◆ 功能說明:檢查是否支援 ApplePay 付款。

◆ 程式參考:https://developer.apple.com/reference/applepayjs/applepaysession#2166537

◆ 使用情境:消費者結帳時,顯示 ApplePay 付款按鈕。

/* 檢查當前瀏覽器是否可支援Apple Pay */

if (window.ApplePaySession) {

var merchantIdentifier = 'Your Apple Pay MerchantID'; // 請填入您申請的Apple Pay Merchant Identifier

/* 進行付款驗證設備是否能夠支援Apple Pay付款 */

var promise = ApplePaySession.canMakePaymentsWithActiveCard(merchantIdentifier);

/* 可支援Apple Pay付款 */

promise.then(function (canMakePayments) {

if (canMakePayments) {

/* 顯示Apple Pay按鈕 */

}

});

}

建立 Apple Pay Session 物件

◆ 功能說明:設定付款請求物件,並建立 Apple Pay Session 物件。

◆ 程式參考:https://developer.apple.com/reference/applepayjs/applepaysession#2166537

◆ 使用情境:訂單建立後,產生確認付款細項。

/* 建立付款請求物件 */

var request = {

countryCode: 'TW', // 國碼

currencyCode: 'TWD', // 交易貨幣

supportedNetworks: ['visa', 'masterCard'],

merchantCapabilities: ['supports3DS'],

total: { label: 'Your Store Name', amount: '100' } // amount為此次交易金額

};

/* 建立 ApplePaySession */

/* 參數1:版本號、參數2:付款請求物件 */

var session = new ApplePaySession(2, request);

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 31 / 55

商店驗證事件

◆ 功能說明:Apple Pay JavaScript API 會呼叫 session 的 onvalidatemerchant回呼函式,

以驗證該請求是否來自有效的商家。

◆ 使用情境:確認付款細項後,進行商店驗證。

/* 商店驗證事件 */

session.onvalidatemerchant = function (event) {

var data = {

validationURL: event.validationURL

};

/* 將validationURL拋到Server端,由Server端與Apple Server做商店驗證 */

$.ajax({

url: 'Your Server URL',

method: "POST",

contentType: "application/json; charset=utf-8",

data: JSON.stringify(data)

}).then(function (merchantSession) {

/* 後端驗證成功取得Merchant Session物件後,將物件pass給ApplePaySession */

session.completeMerchantValidation(JSON.parse(merchantSession));

});

};

商店驗證事件後端處理(.NET 版本)

◆ 功能說明:Request 參數設定。

◆ 使用情境:確認付款細項後,後端進行商店驗證。

建立商店憑證物件

string certPath = Server.MapPath("Apple開發者帳號中建立的商店憑證存放路徑");

string certPwd = "您設定的商店憑證密碼";

X509Certificate2 cert = new X509Certificate2(certPath, certPwd, X509KeyStorageFlags.MachineKeySet);

建立 PayLoad 物件

var payload = new

{

merchantIdentifier = "Your Apple Pay MerchantID",// 請填入您申請的Apple Pay Merchant Identifier

domainName = "Your Website Domain",// 請填入您的網站Domain(需與Apple開發者帳號中設定相同)

displayName = "Your Store Name"// 請填入您想顯示的商店名稱

};

/* 將PayLoad 做JavaScript序列化*/

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 32 / 55

string strPayLoad = new JavaScriptSerializer().Serialize(payload);

指定 Transport Layer Security (TLS) 1.2 安全性通訊協定

ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls12;

商店驗證 Request 設定

HttpWebRequest request = (HttpWebRequest)HttpWebRequest.Create("前端傳回的驗證網址");

request.Method = WebRequestMethods.Http.Post;

request.ContentType = "application/json";

request.ContentLength = strPayLoad.Length;

request.ClientCertificates.Add(cert); // 加入憑證

using (StreamWriter sw = new StreamWriter(request.GetRequestStream()))

{

sw.Write(strPayLoad);

sw.Flush();

sw.Close();

}

付款授權事件

◆ 功能說明:請求付款授權,並取得付款授權結果。

◆ 使用情境:商店驗證成功後,將會彈出指紋辨識付款指示,按壓後則進入付款授權。

/* 付款授權事件 */

session.onpaymentauthorized = function (event) {

var data = {

payment: JSON.stringify(event.payment),

};

/* 將payment物件拋至Server端,由Server端處理交易授權 */

$.ajax({

url: ' Your Server URL',

method: "POST",

contentType: "application/json; charset=utf-8",

data: JSON.stringify(data),

error: function (err) {

alert(JSON.stringify(err));

}

}).then(function (result) {

/* 依授權結果決定帶入ApplePaySession的回應 */

// 授權成功

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 33 / 55

session.completePayment(JSON.parse(ApplePaySession.STATUS_SUCCESS));

// 授權失敗

session.completePayment(JSON.parse(ApplePaySession.STATUS_FAILURE));

});

}

付款授權事件後端處理

◆ 功能說明:後端付款授權參數設定,傳送至綠界系統進行付款授權。

◆ 使用情境:按壓指紋辨識付款指示後,進入後端付款授權流程。

◆ 詳細串接規格請參照 4.3 綠界 ApplePay 串接說明

4.3 綠界 ApplePay 串接說明

提供商家透過 ApplePay 信用卡授權作業 API 進行後端 ApplePay 訂單信用卡交易授權作業,在完

成 ApplePay 驗證授權成功後,會將授權結果回傳合作廠商。

介接路徑:

正式環境:https://payment.ecpay.com.tw/ApplePay/CreateServerOrder/V2

測試環境:https://payment-stage.ecpay.com.tw/ApplePay/CreateServerOrder/V2

注意事項:因測試環境無法對銀行授權,故不會進行授權作業

合作廠商系統 POST 參數說明 (名稱前若有紅色星號*為必填欄位):

參數 參數名稱 型態 說明 備註

*MerchantID 合作廠商

編號 String(10) 由綠界提供 2000132

*MerchantTradeNo 合作廠商

交易序號 String(20) 合作廠商交易序號(不可重覆) 050110030273

*MerchantTradeDate 合作廠商

交易時間 String(20)

合作廠商交易時間

(yyyy/MM/dd HH:mm:ss ) 2015/09/21 08:20:18

*TotalAmount 交易金額 Int

注意事項:

1. 請帶整數,不可有小數點

2. 僅限新台幣

3. 各付款金額的限制,請參考:

https://www.ecpay.com.tw/CascadeFAQ/CascadeFAQ_Qa?nID=3605

1000

*CurrencyCode 幣別 String(20) Apple Server做商店驗證所傳的

CurrencyCode TWD

*ItemName 商品名稱 String(400)

1. 如果商品名稱有多筆 手機 20 元 X2#隨身碟 60

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 34 / 55

綠界回傳參數說明:

時,請以井號分隔(#)

2. 商品名稱字數限制為

中英數 400 字內,超過

此限制系統將自動截

斷。

元 X1

*PlatformID

特約合作

平台商代

String(10)

為專案合作的平台商使用。

一般會員或平台商本身介接,

則參數請帶放空值。

若為專案合作平台商的會員使

用時,則參數請帶平台商所綁

的會員編號[MerchantID]。

因 Apple 尚未開放平台

商審核,請帶合作廠商

編號[MerchantID]

*TradeDesc 交易描述 String(200)

*TradeType 交易來源 Int 1:In App 2:On the Web

2

*CheckMacValue 檢查碼 String 請參考附錄檢查碼機制

*PaymentToken 付款資料

物件 String

Apple Server做商店驗證完回傳

的 Merchant Session 物件中的

payment 物件

注意事項:

1.請用 AES 加密,請參考加密方

2.此欄位不加入檢查碼計算

參數 參數名稱 型態 說明 備註

RtnCode 授權狀態 Int 1:成功,其餘失敗

授權狀態

([a-z,A-Z,0-9]),成功 :1,其

餘代碼皆屬失敗

RtnMsg 授權訊息 String(200) SUCCESS

MerchantID 合作廠商編

號 String(10) (由綠界提供) 2000132

MerchantTradeNo 合作廠商交

易序號 String(20) 050110030273

TradeNo 綠界交易序

號 String(20)

ECPAY 的交易編號

請保存 ECPAY 的交易編號與

MerchantTradeNo 的關聯

1303151740582564

TradeAmt 授權金額 Int

TradeDate 訂單成立時

間 String(14)

資料格式

(YYYYMMDDHHMMSS) 20150921082018

PaymentDate 付款時間 String(14) 資料格式

(YYYYMMDDHHMMSS) 20150921082018

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 35 / 55

5. 訂單資料查詢

應用場景:

提供合作廠商查詢授權交易資料,可查詢授權交易資料結果。

應用流程:

合作廠商綠界科技金流服務

1.查詢授權交易

訂單資料查詢

2.回傳查詢授權交易結果

介接路徑:

正式環境:https://payment.ecpay.com.tw/Cashier/QueryTradeInfo/V2

測試環境:https://payment-stage.ecpay.com.tw/Cashier/QueryTradeInfo/V2

合作廠商系統 POST 參數說明 (名稱前若有紅色星號*為必填欄位):

CheckMacValue 檢查碼 String 請參考附錄檢查碼機制

參數 參數名稱 型態 說明 備註

PlatformID

特約合作平

台商代號

String(10)

為專案合作的平台商使用。

一般會員或平台商本身介接,則

參數請帶放空值。

若為專案合作平台商的會員使

用時,則參數請帶平台商所綁的

會員編號[MerchantID]。

*MerchantID 合作廠商編

號 String(10) 由綠界提供 2000132

*MerchantTradeNo 合作廠商交

易序號 String(20)

訂單產生時傳送給綠界的合作

廠商交易編號。 050110030273

*TimeStamp 驗證時間 Int

將當下的時間轉為

UnixTimeStamp(見範例)用於驗

證此次介接的時間區間。

綠界驗證時間區間暫訂為 3 分

鐘內有效,超過則此次介接無

效。

參考資料:

1234567890

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 36 / 55

綠界回傳參數說明:

訂單結果會以下表參數直接回傳至頁面,並以「參數=值」表示,參數與參數之間以&隔開,例:

MerchantID=123456789&MerchantTradeNo=123456abc&TradeNo=201203151740582564

http://www.epochconverter.com

/。

*CheckMacValue 檢查碼 String 請參考附錄檢查碼機制

參數 參數名稱 型態 說明 範例

MerchantID 合作廠商編

號 String (9) 2000132

MerchantTradeNo 合作廠商交

易編號 String (20)

訂單產生時傳送給綠界的合作廠商交易編

號。 123456abc

TradeNo 綠界的交易

編號 String(20)

201203151740582564

TradeAmt 交易金額 Int 22000

PaymentDate 付款時間 String(20) 格式為 yyyy/MM/dd HH:mm:ss 2012/03/16 12:03:12

PaymentType

合作廠商選

擇的付款方

String(20) 固定回傳 Credit Credit

HandlingCharge 手續費合計 Int 履約結束後才會計算,未計算前為 0 0

PaymentTypeChargeFee 通路費 Int 25

TradeDate 訂單成立時

間 String(20) 格式為 yyyy/MM/dd HH:mm:ss

2012/03/15 17:40:58

TradeStatus 交易狀態 String(8)

回傳值:

若為 0 時,代表交易訂單成立未付款

若為 1 時,代表交易訂單成立已付款

0

ItemName 商品名稱 String(400) 商品 1

CheckMacValue 檢查碼 String

合 作 廠 商 系 統 必 須 檢 查 檢 查 碼

[CheckMacValue]來驗證,請參考附錄檢查碼

機制。

gwsr 授權交易單

號 Int 10123456

process_date 處理時間 String(20) 格式為 yyyy/MM/dd HH:mm:ss 2013/12/19 13:55:20

auth_code 授權碼 String(6) 777777

amount 金額 Int 400

stage 分期期數 Int 3

stast 頭期金額 Int 134

staed 各期金額 Int 133

eci 3D(VBV) Int 回傳值(eci=5,6,2,1 代表該筆交易為 3D 交易) 5

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 37 / 55

card4no 卡片的末 4

碼 String(4) 2222

card6no 卡片的前 6

碼 String(6) 431195

red_dan 紅利扣點 Int 0

red_de_amt 紅利折抵金

額 Int 0

red_ok_amt 實際扣款金

額 Int 0

red_yet 紅利剩餘點

數 Int 0

PeriodType

訂單建立時

的所設定的

週期種類

String(1) D

Frequency

訂單建立時

的所設定的

執行頻率

Int 2

ExecTimes

訂單建立時

的所設定的

執行頻率

Int 5

PeriodAmount

訂單建立時

的每次要授

權金額

Int 200

TotalSuccessTimes 目前已成功

授權的次數 Int 5

TotalSuccessAmount

目前已成功

授權的金額

合計

Int 1000

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 38 / 55

6. 信用卡關帳/退刷/取消/放棄 (若不撰寫此 API,則可透過廠商後台功能處理)

應用場景:

當收到訂單授權成功,透由 7.查詢信用卡單筆明細記錄 API 取得[交易狀態],再依[交易狀態]

發動欲執行動作。

「關帳」:訂單在每日 20:00 系統會自行關帳,綠界依關帳後的金額向銀行請/退款。

注意事項:

1.若於廠商後台將系統自動關帳關閉以後,訂單仍須於 21 天內完成關帳作業,若無,後續將無法以 API 方式

進行關帳,錯誤訊息-error_overDAY 須洽客服手動關帳;

2.若未對訂單進行關帳,第 80 天時將發送信用卡未完成關帳通知;超過 90 天系統會將未關帳訂單進 放棄作

業。

「退刷」:在系統關帳或自行關帳後,可修改訂單金額。

※修改上限為訂單金額

注意事項:

1.分期的交易一定得全額退刷,一般授權才能作部份金額退刷。

2.紅利折抵交易須全額退刷,僅一般交易才可退刷部分金額。

3.如帳戶餘額低於退刷金額,將無法退刷,建議留存一定金額於綠界帳戶或至廠商後台預存綠界帳戶餘額供退

刷之用。

「取消」:可取消關帳,讓訂單回復關帳前的狀態。

「放棄」:適用在當日關帳前放棄此筆交易,不做請款。

注意事項:此 API 不支援定期定額「停用收款」功能,若要停用定期定額收款請登入廠商後台進行操作,

系統路徑為信用卡收單>定期定額查詢>明細/編輯。

介接路徑:

正式環境:https://payment.ecpay.com.tw/CreditDetail/DoAction

測試環境:因無法提供實際授權,故無法使用此 API

合作特店回傳參數說明 (名稱前若有紅色星號*為必填欄位):

參數 參數名稱 型態 說明 範例

*MerchantID 合作特店編號

(由綠界提供) String(10) 2000132

*MerchantTradeNo 合作特店交易

編號 String(20)

訂單產生時傳送給綠界的合作特店交易編

號。 ecpay1234

*TradeNo 綠界的交易編

號 String(20)

請保存綠界的交易編號與合作特店交易編

號[MerchantTradeNo]的關連。 1234567890

*Action 執行動作 String(1) 針對訂單做處理的動作,例如要對訂單做關

帳時,請帶 C。 C

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 39 / 55

參數 參數名稱 型態 說明 範例

1.若要執行關帳時,參數請帶:C

2.若要執行退刷時,參數請帶:R

3.若要執行取消時,參數請帶:E

4.若要執行放棄時,參數請帶:N

*TotalAmount 金額 Int 22000

*CheckMacValue 檢查碼 String 請參考附錄檢查碼機制

PlatformID

特約合作平台

商代號 (由綠

界提供)

String(10)

為專案合作的平台商使用。

一般合作特店或平台商本身介接,則參數請

帶放空值。

若為專案合作平台商的合作特店使用時,則

參數請帶平台商所綁的合作特店編號

[MerchantID]。

綠界科技 Response 參數說明:

訂單結果會直接回傳至頁面,並以「參數=值」表示,參數與參數之間以&隔開,例:

MerchantID=2000132&MerchantTradeNo=ecpay1234&TradeNo=201203151740582564

參數 參數名稱 型態 說明 範例

MerchantID 合作特店編號 String (9) 2000132

MerchantTradeNo 合作特店交易

編號 String (20)

訂單產生時傳送給綠界的合作特店交易編

號。 ecpay1234

TradeNo 綠界的交易編

號 String(20)

201203151740582564

RtnCode 交易狀態 Int 回傳值:

若為1時代表成功,其餘為失敗 1

RtnMsg 交易訊息 String(200)

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 40 / 55

7. 查詢信用卡單筆明細記錄

應用場景:

提供合作特店查詢訂單信用卡單筆明細記錄。

介接路徑:

正式環境:https://payment.ecPay.com.tw/CreditDetail/QueryTrade/V2

測試環境:因無法提供實際授權,故無法使用此 API

合作特店回傳參數說明(名稱前若有紅色星號*為必填欄位):

參數 參數名稱 型態 說明 範例

*MerchantID 合作特店編號

(由 ecPay 提供) String(10) 2000132

*CreditRefundId 信用卡授權單號 Int 10123456

*CreditAmount 金額 Int

*CreditCheckCode 商家檢查碼 Int 在廠商後台->信用卡收單->

信用卡授權資訊中可查到 59997889

*CheckMacValue 檢查碼 String 請參考附錄檢查碼機制

查詢結果會直接回傳至頁面,並以 JSON 格式表示。

回傳範例(為方便說明,以下的回傳範例經過排版):

{ "RtnMsg":"", "RtnValue":{ "TradeID":"0015625112",, "amount":"1", "clsamt":"1",

"authtime":"2016/5/12 下午 07:09:17",

"status":"已關帳",

"close_data":[ { "sno":"2782343",

"status":"已關帳",

"amount":"1",

"datetime":"2016/5/12 下午 08:00:00"

} ] } }

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 41 / 55

"RtnMsg":"", "RtnValue":{ "TradeID":"0015625112",, "amount":"100", "clsamt":"100",

"authtime":"2016/5/12 下午

07:09:17",

"status":"已關帳",

回傳的 JSON 可分為「(一)主要交易資訊」、「(二)明細資訊」二部分。分別說明如下:

(一)主要授權資訊(下方範例所框選部分):

{

"close_data":[ { "sno":"2782343",

"status":"已關帳",

"amount":"100",

"datetime":"2016/5/12 下午 08:00:00"

} ] } }

主要授權資訊之參數說明:

參數 參數名稱 型態 說明 範例

RtnMsg 回應訊息 String(200)

若成功時,回傳值為:ok

若查無商家或商家己到期,回傳值

為: error_Stop

若查無該筆交易授權單號時,回傳

值為: error_nopay

若發生錯誤或資料檢核失敗,則回

傳值為: error

ok

RtnValue 回應內容

TradeID 授權單號 Int 0015625112

amount 交易金額 Int 100

clsamt 已關帳金額 Int 100

authtime 訂單成立時間 String(24) 2016/5/12 下午 07:09:17

status 交易狀態 String(30)

若未有關帳明細交易,狀態回傳值

如下:

已取消:此筆交易已取消

未授權:銀行未授權完成

已授權:銀行已完成授權

若已有關帳明細交易,狀態回傳值

如下:

銀行拒絕

已授權

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 42 / 55

"close_data":[ { "sno":,"2782343”,

"status":"已關帳",

"amount":"100",

"datetime":"2016/5/12 下午 08:00:00"

} ]

(二)明細資訊(下方範例所框選部分):

{ "RtnMsg":"", "RtnValue":{ "TradeID":"0015625112",, "amount":"1", "clsamt":"1",

"authtime":"2016/5/12 下午 07:09:17",

"status":"已關帳",

} }

明細資訊之參數說明:

要關帳

關帳中

已關帳

要取消

取消中

已取消

銀行追回中

銀行已追回

批次失敗

不明

操作取消

參數 參數名稱 型態 說明 範例

sno 關帳單號 String(20) 當信用卡授權關帳後才會回傳此欄位 2782343

status 狀態 String(30)

狀態回傳值如下:

銀行拒絕

要關帳

關帳中

已關帳

要取消

取消中

已取消

已關帳

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 43 / 55

銀行追回中

銀行已追回

批次失敗

不明

操作取消

amount 交易金額 Int 100

datetime 關帳時間 String(24) 2016/5/12 下 午

08:00:00

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 44 / 55

8. 下載信用卡撥款對帳資料檔

應用場景:

提供廠商下載 CSV 格式的信用卡撥款對帳檔內容。

Step 1. 廠商系統:將要查詢的信用卡撥款資料條件,以 POST(HTTP Method)傳送至綠界科技,

進行查詢。

Step 2. 綠界科技:接受信用卡撥款查詢並檢核資料後,回傳 CSV 檔案格式提供廠商系統下載。

介接路徑:

正式環境:https://payment.ecPay.com.tw/CreditDetail/FundingReconDetail

測試環境:因無法提供實際授權,故無法使用此 API

合作特店回傳參數說明 (名稱前若有紅色星號*為必填欄位):

參數 參數名稱 型態 說明 範例

* MerchantID 合作特店編號

(由綠界提供) String(10) 123456789

*PayDateType 查詢日期類別 String(10)

要查詢的日期類別

若為查詢撥款日期時,則參數請帶 fund

若為查詢關帳日期時,則參數請帶 close

若為查詢入帳日期時,則參數請帶 enter

close

*StartDate 查詢開始日期 String(10) 要查詢的開始日期

日期格式為「yyyy-MM-dd」 2015-02-12

*EndDate 查詢結束日期 String(10) 要查詢的結束日期

日期格式為「yyyy-MM-dd」 2015-02-12

CharSet 檔案編碼格式 String (1) 要下載的檔案編碼格式

若為 Big5 格式時,則參數請帶 1

若為 UTF8 格式時,則參數請帶 2

若未傳入此參數或為空值時,預設為 Server

Default 格式

1

*CheckMacValue 檢查碼 String 請參考附錄檢查碼機制

綠界科技 Response CSV 檔案格式說明:

欄位名稱 型態 說明

授權單號 String

授權碼 String

關帳單號 String

訂單編號 String

交易日期 String

請款日期 String

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 45 / 55

交易金額 Int

手續費 Int

%數 Float

撥款金額 Int

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 46 / 55

9. APPLE 開發者帳號申請說明

申請網址:https://developer.apple.com/programs/ios/develop.html

申請費用:每年 $99 美元

i. 進入 Apple 開發者網站,點右側的 Enroll 按鈕。

ii. 閱讀註冊相關注意事項,點選下方的 Start Your Enrollment 按鈕。

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 47 / 55

iii. 登入你的 APPLE ID 若沒有請先註冊 https://appleid.apple.com/。

iv. 選擇註冊開發者帳號類型後,再按右下的 Continue 鈕

個人 請選擇 Insividual / Sole Proprietor / Single Person Business

公司/組織 請選擇 Company / Organization

政府機構請選擇 Government Organization

v. 填寫申請資料後,並閱讀使用條款並打勾同意,再按右下的 Continue 鈕

注意事項:申請公司/組織帳號須提供 D-U-N-S 編碼(鄧白氏企業認證),鄧白氏企業認證申請作

業約要 3-14 個工作天

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 48 / 55

個人註冊頁面資訊,請填入相關資訊後勾選同意條款,再按右下的 Continue 鈕

確認年費及付費條款,點選 Purchase

登入 Apple ID,確認購物⾞項⽬並填寫付款資料,完成年費付款(不能用他人的信用卡代刷)

完成上述流程後,會在 24 ⼩時內收到啟⽤認證信件,輸入序號並啟⽤,即完成開發者帳號註冊

程序

優點:申請速度快(最快 1 天申請完成)。

缺點:在 App store 展示的是個人資訊,無法逹到宣傳公司的效果。在開發者帳號里無法創

建團隊。金融類 App 無法通過個人帳號上架(必須是公司開發者)

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 49 / 55

公司註冊頁面資訊請,填入相關資訊後再按右下的 Continue 鈕,待APPLE客服人員電話聯絡後,

會開通開發者帳號,再進行付款作業

優點:APP 可展示公司資訊;可以創建自已的開發團隊,並添加成員至此帳號中。

缺點:申請前需要先註冊鄧白氏編碼,所以申請時間較長。

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 50 / 55

附錄 1. 檢查碼機制

在與綠界進行資料傳遞時,除了 CheckMacValue 參數及 PaymentToken 參數外,其餘所有參數

皆需要加入檢查碼的檢核機制。請合作廠商務必判斷 CheckMacValue 是否正確,以及是否已經

對該筆通知做過相對應的處理,若不判斷,請合作廠商自行承擔損失。

檢查碼組成步驟:

i. 將傳遞參數依照第一個英文字母,由 A 到 Z 的順序來排序,若遇到第一個英名字母相同時,以第二

個英名字母來比較,以此類推,並以”&”方式將所有參數串連:

currencyCode=TWD&ItemName=手機 20 元 X2#隨身碟 60 元

X1&MerchantID=2000132&MerchantTradeDate=2017/03/21

17:02:00&MerchantTradeNo=20170321170200889&PlatformID=&TotalAmount=100&TradeDesc=e

cpay 商城購物

ii. 參數最前面加上 HashKey,最後面加上 HashIV:

HashKey=5294y06JbISpM5x9&currencyCode=TWD&ItemName=手機 20 元 X2#隨身碟 60 元

X1&MerchantID=2000132&MerchantTradeDate=2017/03/21

17:02:00&MerchantTradeNo=20170321170200889&PlatformID=&TotalAmount=100&TradeDesc=e

cpay 商城購物&HashIV=v77hoKGq4kWxNNIS

iii. 將整串字串進行 URL Encode:

HashKey%3d5294y06JbISpM5x9%26currencyCode%3dTWD%26ItemName%3d%e6%89%8b%e6%a

9%9f20%e5%85%83X2%23%e9%9a%a8%e8%ba%ab%e7%a2%9f60%e5%85%83X1%26MerchantID

%3d2000132%26MerchantTradeDate%3d2017%2f03%2f21+17%3a02%3a00%26MerchantTradeNo

%3d20170321170200889%26PlatformID%3d%26TotalAmount%3d100%26TradeDesc%3decpay%e5

%95%86%e5%9f%8e%e8%b3%bc%e7%89%a9%26HashIV%3dv77hoKGq4kWxNNIS

iv. 全部轉為小寫:

hashkey%3d5294y06jbispm5x9%26currencycode%3dtwd%26itemname%3d%e6%89%8b%e6%a9%

9f20%e5%85%83x2%23%e9%9a%a8%e8%ba%ab%e7%a2%9f60%e5%85%83x1%26merchantid%3d

2000132%26merchanttradedate%3d2017%2f03%2f21+17%3a02%3a00%26merchanttradeno%3d20

170321170200889%26platformid%3d%26totalamount%3d100%26tradedesc%3decpay%e5%95%86

%e5%9f%8e%e8%b3%bc%e7%89%a9%26hashiv%3dv77hokgq4kwxnnis

v. 最後做 SHA256 加密:

BDC2A456448FDB2F1A14C6098C79E9326D5DB39342630AEB52E30AFB64DC4A82

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 51 / 55

注意事項:

(1) 請接收到綠界科技傳送的資訊時,必須檢查檢查碼[CheckMacValue]是否正確,如未判斷可

能產生損失。

(2) 請用 SHA256 加密方式產生雜凑值。

(3) 請確認您的語言的 UrlEncode function 轉換後的結果符合附錄 URLENCODE 轉換表中的「.NET

編碼(O’Pay)」欄位值,若有不符合的字元,請用字元替換功能處理,以免無法符合檢查規則。

例如:PHP urlencode function 會將 ! 字元編碼成 %21,不符合「.NET 編碼(O’Pay)」,所以在 PHP

urlencode 後需用 str_replace function 將%21 轉回 ! 字元。以下僅以 PHP 轉換範例說明:

$sMacValue = str_replace('%2d', '-', $sMacValue); $sMacValue = str_replace('%5f', '_', $sMacValue); $sMacValue = str_replace('%2e', '.', $sMacValue); $sMacValue = str_replace('%21', '!', $sMacValue); $sMacValue = str_replace('%2a', '*', $sMacValue); $sMacValue = str_replace('%28', '(', $sMacValue); $sMacValue = str_replace('%29', ')', $sMacValue); $sMacValue = str_replace('%20', '+', $sMacValue);

其它程式語言的轉換功能,請閱該程式語言的編碼轉換規則改寫。

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 52 / 55

附錄 2. AES 資料加密

PaymentToken (編碼格式請用 UTF8)

{

"token":

{

"paymentData":

{

"data":"rLQsaJzRWR4MGdZWvWY9dvfmKRYKY8jcOP3YDBH+QpB5tklltZErejVyHARz6+pJdBAnjjECuoqH8aDerZHraBz2pb14uBuiawh

qeT0UrAsp/vHTM05BZdpcGT7JQAJzx0gcxRWZ7b7EpBt8xiSaPISHZA9TlVwNbfyM3IB1p5e3V3OEWwENAyhaXdBZNovZdjfQ8Z8AhCypjCeiL

vprlfXHpzYadZwHlX40lbZRkxWYPEbP3XEaa1FsPVxYNkSJKcE6t4mEW1cSGZJnEbxFOw6npITnm+Pr2lg8mQJwMeRxs90xpmc0m0BVBAnT7

CnqYSzEBkmIBUX5EQvgAC3t4XHUAghwx9nkPbgzXtBA5OLkaDq5Cqo5qrgGty37eDot+zkUQfpugj2Axkrc5Mey1J0+PWpG1cOLeAq/UGSv2t

bZ",

"signature":"MIAGCSqGSIb3DQEHAqCAMIACAQExDzANBglghkgBZQMEAgEFADCABgkqhkiG9w0BBwEAAKCAMIID5jCCA4ugAwIBAgII

aGD2mdnMpw8wCgYIKoZIzj0EAwIwejEuMCwGA1UEAwwlQXBwbGUgQXBwbGljYXRpb24gSW50ZWdyYXRpb24gQ0EgLSBHMzEmMCQG

A1UECwwdQXBwbGUgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxEzARBgNVBAoMCkFwcGxlIEluYy4xCzAJBgNVBAYTAlVTMB4XDTE2MDYw

MzE4MTY0MFoXDTIxMDYwMjE4MTY0MFowYjEoMCYGA1UEAwwfZWNjLXNtcC1icm9rZXItc2lnbl9VQzQtU0FOREJPWDEUMBIGA1UECw

wLaU9TIFN5c3RlbXMxEzARBgNVBAoMCkFwcGxlIEluYy4xCzAJBgNVBAYTAlVTMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEgjD9q8Oc914g

LFDZm0US5jfiqQHdbLPgsc1LUmeY+M9OvegaJajCHkwz3c6OKpbC9q+hkwNFxOh6RCbOlRsSlaOCAhEwggINMEUGCCsGAQUFBwEBBDkwN

zA1BggrBgEFBQcwAYYpaHR0cDovL29jc3AuYXBwbGUuY29tL29jc3AwNC1hcHBsZWFpY2EzMDIwHQYDVR0OBBYEFAIkMAua7u1GMZekpl

opnkJxghxFMAwGA1UdEwEB/wQCMAAwHwYDVR0jBBgwFoAUI/JJxE+T5O8n5sT2KGw/orv9LkswggEdBgNVHSAEggEUMIIBEDCCAQwGCS

qGSIb3Y2QFATCB/jCBwwYIKwYBBQUHAgIwgbYMgbNSZWxpYW5jZSBvbiB0aGlzIGNlcnRpZmljYXRlIGJ5IGFueSBwYXJ0eSBhc3N1bWVzIGFj

Y2VwdGFuY2Ugb2YgdGhlIHRoZW4gYXBwbGljYWJsZSBzdGFuZGFyZCB0ZXJtcyBhbmQgY29uZGl0aW9ucyBvZiB1c2UsIGNlcnRpZmljYXRlIHB

vbGljeSBhbmQgY2VydGlmaWNhdGlvbiBwcmFjdGljZSBzdGF0ZW1lbnRzLjA2BggrBgEFBQcCARYqaHR0cDovL3d3dy5hcHBsZS5jb20vY2Vyd

GlmaWNhdGVhdXRob3JpdHkvMDQGA1UdHwQtMCswKaAnoCWGI2h0dHA6Ly9jcmwuYXBwbGUuY29tL2FwcGxlYWljYTMuY3JsMA4GA1

UdDwEB/wQEAwIHgDAPBgkqhkiG92NkBh0EAgUAMAoGCCqGSM49BAMCA0kAMEYCIQDaHGOui+X2T44R6GVpN7m2nEcr6T6sMjOhZ5N

uSo1egwIhAL1a+/hp88DKJ0sv3eT3FxWcs71xmbLKD/QJ3mWagrJNMIIC7jCCAnWgAwIBAgIISW0vvzqY2pcwCgYIKoZIzj0EAwIwZzEbMBkG

A1UEAwwSQXBwbGUgUm9vdCBDQSAtIEczMSYwJAYDVQQLDB1BcHBsZSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTETMBEGA1UECgwKQX

BwbGUgSW5jLjELMAkGA1UEBhMCVVMwHhcNMTQwNTA2MjM0NjMwWhcNMjkwNTA2MjM0NjMwWjB6MS4wLAYDVQQDDCVBcHBsZ

SBBcHBsaWNhdGlvbiBJbnRlZ3JhdGlvbiBDQSAtIEczMSYwJAYDVQQLDB1BcHBsZSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTETMBEGA1UEC

gwKQXBwbGUgSW5jLjELMAkGA1UEBhMCVVMwWTATBgcqhkjOPQIBBggqhkjOPQMBBwNCAATwFxGEGddkhdUaXiWBB3bogKLv3nuuTe

CN/EuT4TNW1WZbNa4i0Jd2DSJOe7oI/XYXzojLdrtmcL7I6CmE/1RFo4H3MIH0MEYGCCsGAQUFBwEBBDowODA2BggrBgEFBQcwAYYqaHR

0cDovL29jc3AuYXBwbGUuY29tL29jc3AwNC1hcHBsZXJvb3RjYWczMB0GA1UdDgQWBBQj8knET5Pk7yfmxPYobD+iu/0uSzAPBgNVHRMBAf

8EBTADAQH/MB8GA1UdIwQYMBaAFLuw3qFYM4iapIqZ3r6966/ayySrMDcGA1UdHwQwMC4wLKAqoCiGJmh0dHA6Ly9jcmwuYXBwbGUu

Y29tL2FwcGxlcm9vdGNhZzMuY3JsMA4GA1UdDwEB/wQEAwIBBjAQBgoqhkiG92NkBgIOBAIFADAKBggqhkjOPQQDAgNnADBkAjA6z3KDU

RaZsYb7NcNWymK/9Bft2Q91TaKOvvGcgV5Ct4n4mPebWZ+Y1UENj53pwv4CMDIt1UQhsKMFd2xd8zg7kGf9F3wsIW2WT8ZyaYISb1T4en0

bmcubCYkhYQaZDwmSHQAAMYIBYDCCAVwCAQEwgYYwejEuMCwGA1UEAwwlQXBwbGUgQXBwbGljYXRpb24gSW50ZWdyYXRpb24gQ0

EgLSBHMzEmMCQGA1UECwwdQXBwbGUgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxEzARBgNVBAoMCkFwcGxlIEluYy4xCzAJBgNVBAYTAl

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 53 / 55

VTAghoYPaZ2cynDzANBglghkgBZQMEAgEFAKBpMBgGCSqGSIb3DQEJAzELBgkqhkiG9w0BBwEwHAYJKoZIhvcNAQkFMQ8XDTE2MTIwODA

4NTQxMFowLwYJKoZIhvcNAQkEMSIEIClAG72ATE79/cRRC8cpAO0+MIW3+fi8Vl6EtjmkYDAJMAoGCCqGSM49BAMCBEgwRgIhALzAUADFt

eo1Pb9+YTaVR0Sm4HmjCRf1587692RZoy0xAiEA2BPHpVlD4zCKVvzS9eCCeUpwI+Rf9yr8iTMGSSceN/0AAAAAAAA=",

"header":

{

"publicKeyHash":"xLBxijBsfyoaFVUlEEUEQptPsmD4WIt491ovV5DKNAg=",

"ephemeralPublicKey":"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE/WwswbNtdjBmX94iGQh5Z4Cyt7v7rMNAMO2Hgi93HUpSSJ5

pI+5TYM4UtdIWfDbBzXQiwCAKT3jreo1cLPAdzg==",

"transactionId":"85a158652b0d98379cb817dd53e97dfd8131dde2f578128482b6dee4c9e98eb9"

},

"version":"EC_v1"

},

"transactionIdentifier":"85A158652B0D98379CB817DD53E97DFD8131DDE2F578128482B6DEE4C9E98EB9",

"paymentMethod":

{

"network":"Visa",

"type":"debit",

"displayName":"Visa 0492"

}

}

}

AES 加密(加密的強度是 128 bit,CipherMode : CBC,PaddingMode:PKCS7):

先將整段將 JSON 參數進行 AES 加密,並將加密後用 Base64 進行編碼:

0bOrCfx8Vz4YGruVYMH7EKaF62z0l0uefvb23Ev8sZ1oRWGyRCFJZ1J7QXvdVcU32Vg4f55aR1KaFwfEs9l5kxUnO9G+WH

Xw9EkGo+hypnxUUB7ydUyM8eIapNBc8PrZTCTD0RXyuuey9dwoBia6OH1l9IqsFKCedCUi7EyotRGQg21Bi5QQarsO2ha

tiXbCjMqeMTsLXEgNJPnZdYvSJANJLQOBK+kOfCqGMFruYj7ajR9OdZ4kqk+vJtF1etzG2Yt6jKJ6Z9pRkP/VlLx8Cdb6nNx97

VZOJM1SdYGSfBxX1AqWoydm+wOpmx26jKUJqGSFPLFsYVbJwqAySju+z4pLJkv4Q2WMKnyhxaEfCUynOLnUauLLec6ljd

duISgw5cZtKMmcpteKUWriefzmVZ/PCm3g/zSYSTttbrxVjJXFYMQWJ36fFtwnhVRV3vStSIfLWxBb6cBw2ggFpMHgYo3Pr

01pWYYQR/CMaTx78z2StpcddNBU11rq7D8ctZBUUMRhpPIE4hr7kt/HawzsZQvq2S7Jh3lsY237+vScyE3LiFlEPR1NuYVU

mMvmaUisAsI7ym3luVJ99xhlVsLaX/TG/tuQ5dd8nsKY9XnWh3Sc5Z+n7faqgFHuVgDyNIv0404iiRbMubmETQ6BDWX2F

vzBbJymWaXyuhBAxVKY5Ifb4i9djScRrzDcD1fGz40AZsK/bKKmAYvIhWAoVK/M0XMQGMs1yRPGUCtZ5/qFgfZHBS9E8p

v30StkPTQdrcjertv2UHK6EV+goF5JD7K0gfMFtYrgWZmdekmwTOkj/BeMpBF6FE2PDsh19b5kd4jQAtNJ0jThujWu9IQ6x

VtHrvMPZWsyyt1q7ykYmt8pm+bxSl5Al+VlopiYjdMaPGSQ7TEryCBtnqiESpfGCXZsazmxWScox8fF//cE1Z8nMpLiCPX6tJ

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 54 / 55

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

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 55 / 55

jRq4pADpON/Npa+073r2f/IRLcBkMzn6vgW9vH3NqqsEr0JHKhY43SEnlO9tBQhAffaQnhbMsTriw/aFcJGnHhaILAJ+sKU

gUIsMRMgVXAA0RWoBOyMLwu4du5vVrVBPnw8UUrcTi19toqn1UribrbeCuuG6xd8giNNRdSeIK9B9srS3wImcySrzxK5

eqmnuhbDeHg0+e8XMfL8FSfFNWJTOrlqRWfA8S1xCcn3SfWpjXu41d9ZGUFU74Y/5kJUKgtoU22cBxyujRQvRqi9qeW2+

bg8INR8IqtCZAW6huO3Wk3dwqLRtZIo2S7mIUGyKpCCnAZ0ZSAvMHO/PgXpOBEc6mskYx2CNCjFKnydKW8U+xVN1m/

Ua+tkMh0b9MfeHG8uPXmmcs7XVC1WYm2ApK6/Z93eEEnFvPgNtFexxTYWwg1AArOvg+VzeWyvUJl9UpR91DmAAhJ

Gp/ih/HpLpihTr5Plg7I3Gu3i97pmmKF+C4JKVCkpDZ3kp0T2SBuPewNzbOuBt4fySvlDaiI4dEJfeVEekc1QjSmn4/KuB9mS

I=

將加密後字串做 UrlEncode:

0bOrCfx8Vz4YGruVYMH7EKaF62z0l0uefvb23Ev8sZ1oRWGyRCFJZ1J7QXvdVcU32Vg4f55aR1KaFwfEs9l5kxUnO9G%2b

WHXw9EkGo%2bhypnxUUB7ydUyM8eIapNBc8PrZTCTD0RXyuuey9dwoBia6OH1l9IqsFKCedCUi7EyotRGQg21Bi5QQar

sO2hatiXbCjMqeMTsLXEgNJPnZdYvSJANJLQOBK%2bkOfCqGMFruYj7ajR9OdZ4kqk%2bvJtF1etzG2Yt6jKJ6Z9pRkP%2fV

lLx8Cdb6nNx97VZOJM1SdYGSfBxX1AqWoydm%2bwOpmx26jKUJqGSFPLFsYVbJwqAySju%2bz4pLJkv4Q2WMKnyhxaE

fCUynOLnUauLLec6ljdduISgw5cZtKMmcpteKUWriefzmVZ%2fPCm3g%2fzSYSTttbrxVjJXFYMQWJ36fFtwnhVRV3vStSIfL

WxBb6cBw2ggFpMHgYo3Pr01pWYYQR%2fCMaTx78z2StpcddNBU11rq7D8ctZBUUMRhpPIE4hr7kt%2fHawzsZQvq2S7

Jh3lsY237%2bvScyE3LiFlEPR1NuYVUmMvmaUisAsI7ym3luVJ99xhlVsLaX%2fTG%2ftuQ5dd8nsKY9XnWh3Sc5Z%2bn7f

aqgFHuVgDyNIv0404iiRbMubmETQ6BDWX2FvzBbJymWaXyuhBAxVKY5Ifb4i9djScRrzDcD1fGz40AZsK%2fbKKmAYvIh

WAoVK%2fM0XMQGMs1yRPGUCtZ5%2fqFgfZHBS9E8pv30StkPTQdrcjertv2UHK6EV%2bgoF5JD7K0gfMFtYrgWZmdek

mwTOkj%2fBeMpBF6FE2PDsh19b5kd4jQAtNJ0jThujWu9IQ6xVtHrvMPZWsyyt1q7ykYmt8pm%2bbxSl5Al%2bVlopiYjd

MaPGSQ7TEryCBtnqiESpfGCXZsazmxWScox8fF%2f%2fcE1Z8nMpLiCPX6tJJ6ZS6Cgu%2fZl0EzJbZXSUHOzPYarttVfc%2b

nJFpfdgkPtn06kE6I%2b2t%2bZRuwgCA70s7WNSH8cDX5gNc3XHVTfc8sRTpVR9nLvUwyqUoY6I6uUcE8AJsfqGSI795sI6

88j6P06l70RqA2RvqHuDaBOeglQ56ll7z9tdmg70MB9iCfLidGIhMkUTA1dqWOyOzNVVjC%2fEQHCoWJ9x6cZxlTHX2xq

Mt91O8n3Jy7gu%2bULP6vqD%2br5b9wZ8iSxj483GyAg6m%2bWR4tPS55%2bSAI2gwL%2f6o0FEyMYKeyTZ8OuEYSh6

9207av7xEJMFXlhWUgJpFC8duZjorL3A77PNeAXwhCMhUYYHqUTVEi%2bFTwHIpVWL2a1PQ4FuCpFFRyLwkk8IqCUN

UeO0l%2barVBmWoGXK%2brkGUqmre6kJ0IjHeZcEYFDbDv6Dq2PPF0v8iAeo%2fmoxOyeg3PuCfieiOAC5wfF0GrKUnz

XyE8nNV%2fZ9dMgDf8J%2fZ6nTP2x%2bmDnCClMpc5QSe9TBmxec%2bSGRNjU7P2mKLWekxlaicWqHlfwF44N15SJdB

1YTTpROsaxZBLSeYcVS7Cg%2bUiEGnUWX%2br69BO4oNWBQVZ%2bCYG2Ct46xljy31kST1HvrNkbdjVp7eLzUTGf6Zzo

DwlwH%2bQBf0tOlSNk%2bDGb%2fZ6mAHPReAd%2fSbtg5hTz2lE3J9dqTMU8fqoOHZaMKf4eiSYwT0Uxsrs07JjUv0xuq

Prs4G7i9fdrvrXjVYX1S0OIVCwkBo4jFfXoP3PsdxP%2fdp%2bocTHUTYrf36gBI7ZnJpzfNA7UsODNNGNe6xnzZyfsMQKc

MeN5aHYuaS1PUTFktN1hzfSbVLPFhN2CslMQFOzmA3Ss%2bpt4ajk7cSB8%2fh1IS71DDujS3YQLot0qEehhsNb0qDT4If

dc9dfTkjpQs4Ul5Pu5CIgVa47aev%2fYxJyY3RMKcd7T4xOT%2fc27%2fiKiYs6swW1aAratJVCe1YMhjlN1QsCcw4Iky9t6A

%2flZfNEf6TVlU7q3vqI7sh8b%2filCgU7YdNVkmenv5gPqANGYeNg9rkC0vrhIDM3eIXIWQuS1SjF9CU3RtfVIb8ByiQqKy

MPMEHIpLs3o%2bzKB%2bxpGsc5iXdDdUQMn%2fpmn8gKq6P174NSMHXZqlTPa6wSTzYl4TwW9rgYHsFfsgqau3Y%2b

5T%2bAQuJaWwEukF4gv2BRXQ9p3ffImT1gCopuRwfeo1mp6DofZPbWWFnhPYRZlt4NlLebD11QnwEVkDO4WwaDH

MK2ocap%2b%2fmmYoR%2b65Inat7HhoYJNeNENFBKe4yRzxdF%2bhq8lLRR9Ya4J3pWSIiAzHcXXJAkmvGFzUs5cSQvA

vBwN%2f8YLsEpEpuFFssRDjqv2XdEDGVQsP6Sy2ix4hQqQ%2fTTjlACTlvZ4H8kkUNc2wEschA9nyBNOemTNeZ58ubSTn

Qa9tHe32ztlujVkHJzU4mEiEzStmHsDhqmChPOvnNsw%2f8cuy7xgDXez5Whs3x7KLJvF8fA%2fg8aGIW3YQc5o1lktPLIx

qjjXvohBslvgCs8OR0DNgjvVzY%2byG%2bWYzfe3zSIp63XDxESH1EtRlA9Z60BSWm%2fFWYB%2f4vnBhRQa0TwTfMfM

hNoSljdljlprVebSvH0Tjx5UyNEVRHNtDc1Ulm5zISOtOk7ar5t81vJSx5lgWfRmMaHyBuob47w82BWbBVzfTayCyOXrjUcs

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 56 / 55

ga5Snovd4k9h%2ftDNVIK5hlH6mqQ%2bMwU9ID7YvYH1%2ffTbmdsqGxnnDPxITkAT0owKXboSSzqdN%2b%2fe%2fHk

MCsG3pzRPeVuRwsvYH%2brKQiQwomeszAG3DocU6qYxjmNC7hbqgljOyD4yyKlrvH5MWSNcP8G9nXPeARt8qx3Ix7xVi

BMpuaoFwdU6pypG4Rn6KJFYViFvbpOCIKP7%2fmPzih6%2bnm7ET%2fHvnWbIkl2LupxzUsZUiiC09etBTXxFWGcF3Rpa

yiSWy7WGQM7cn1IFjXmbw3iVo8xUsnDVfoZ%2bj7j4IICCGDdZSKQmCsgofo%2fdc%2fkPK%2fYMNl8N6wbp9yjxHxtdg

3gCzR%2fSdzZ1UrgYsGrlpKIgOEhSxWfi%2fGRwRRTEwzo0%2beqOMGEwmGggVMDVkTbNorT2WvHDEUBpj5mVw%2f

unCcYRLLZ0ZXx8YNByJ%2fA5c1Ca%2bZe%2b5AiIkzZEI6svXm2qFHktaA8gqQTrYhKUb6ZypIPFX2SENcrcgMjopCit7Jnxz

xLfrwV6gZliMpUI%2bfSl4RaQOpAjicWHh2XnSUQ6qr12mCfyvqoWQmTk4AEDEqU5bRd6P4AXt1%2bEMVkSlEJMGUO

EV0%2fhYaR3YiHwycL6fbkGuN1YKS9H7RQhKEISDbpcXecp7B08gK0TPndULI6Vf7e6%2fmadLfdwilNDJz3W7IL5m48M

7nGpqekm%2b8BPEkmTkc%2b5fbz8XxHKxMQhe8A4i611ORYQdnWPuRhfJdbkIf7pLAPXJKc%2fbivM2a6QPvjUkEibii%

2fo7c8Gm4zlX09CyKhdw5pb%2fuS9GyyRio1NcN%2fwoyFagoIbw%2bZ%2fL5W2m4kLxNunQkoYUh%2ffdanIcWrLNIe

pq32FkbWlaL%2bVWsJ04iiNHgJlwr2mBRigypu%2faZuU2fUQTycPw9b62wAJFRLbJNMI1vruvMm5bxEn3Ogsz0XKg4jex

%2fwoUBnBwEFIeKEteLTrzZfgOLEGQP4inRkf5tiOqcHG5NDRz7dJMQlI1PLyGdkdB1luYmIwRyBwtiwqyN96gSDxgpQzi2

Udb4JvwMMt7s8owDNxqJKMUZCeTUfXygPU3gwz5pUuCDUlyCTIsOZ4MFrTtydrt%2bPZJOMnAqxwF0e%2b86OVYgLt

M37PqCW2CnPQ8yb4BxsGqzY%2biRb%2fDEU7bAdfUKKr6VkjU0ow1Wjm8SV1R1EjfK6QNHXfp2sQ%2bulzv7BR8Y1Fu

ssRAuwdncigyf7CoJsjd27LHP6CYT6GGk9Z7Qf5N%2fork4zAtwLbUrZIm8fozz0uzVF6%2bIEBSlUUyZ%2fFta7OsqcF6vua

xgJ4fyM%2fiAfRHMQWpFJztZ%2b%2frAIPU8IYJY9kc6DF6axTCFfVp0j2RaFKH7jH5Ep3dK7yJaf7LaCHsG5Jm0nnZaUDQ

WRwX5W96tSZlCfUv7rkgiI2PQUtlYj%2bETmw38aGD5RaUi8C%2fbA9queqwZ5O8gAUmF5oENXUSGiYmjUYeugNoX8d

yg6xGjbNidoy%2fPRDktXiLXxuk2vDsUqlVljddotH5HqZ9Sf735LDaA6Ko%2bNzWJnffUMNCEKLPwsk0ia7604Uq9vOXO8

kIWuusikTI1V9KrdY%2ffiU7xqkQ8JrT7v0Pf7aHPlmu9pB7pObUqN0jp%2fBA8FXxEVpKlKL%2bIdkaSgW42CK9C08AnG1

Kyj91bC5h%2bCF8nPNDgC8uZ6n1wCBOiKy3QsmXTZi7KYbMvHWvenxBvvUp%2bU%2bJQMPTA%2bd%2bpF2zpxdNI9

w2G%2bF7Wp%2f1zAyL54n3lANR2s6Xo7sHZ8kLzaUNSQSUjVleO0p0NEZQ4ahFx%2beF0l2VmyNEEdEhTo91nX4KQSY

TVUnn9%2bmR%2f%2bWOObFF1oQ2d4k8Fv%2fX7QD6ZhDSZzTii3milVoDFBUk8syuLY04komsObTrvIkoZGLWBKzW7

WlnhxiFxuYqP1S%2fSmUAq1ZSKO%2fE0q6q5mxtLmK1ggjqQC1bk4NM8Zmm4HtWtjRq4pADpON%2fNpa%2b073r2f

%2fIRLcBkMzn6vgW9vH3NqqsEr0JHKhY43SEnlO9tBQhAffaQnhbMsTriw%2faFcJGnHhaILAJ%2bsKUgUIsMRMgVXAA0

RWoBOyMLwu4du5vVrVBPnw8UUrcTi19toqn1UribrbeCuuG6xd8giNNRdSeIK9B9srS3wImcySrzxK5eqmnuhbDeHg0%

2be8XMfL8FSfFNWJTOrlqRWfA8S1xCcn3SfWpjXu41d9ZGUFU74Y%2f5kJUKgtoU22cBxyujRQvRqi9qeW2%2bbg8INR8I

qtCZAW6huO3Wk3dwqLRtZIo2S7mIUGyKpCCnAZ0ZSAvMHO%2fPgXpOBEc6mskYx2CNCjFKnydKW8U%2bxVN1m%2f

Ua%2btkMh0b9MfeHG8uPXmmcs7XVC1WYm2ApK6%2fZ93eEEnFvPgNtFexxTYWwg1AArOvg%2bVzeWyvUJl9UpR91

DmAAhJGp%2fih%2fHpLpihTr5Plg7I3Gu3i97pmmKF%2bC4JKVCkpDZ3kp0T2SBuPewNzbOuBt4fySvlDaiI4dEJfeVEekc1

QjSmn4%2fKuB9mSI%3d

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 57 / 55

附錄 3. 交易狀態代碼表

因錯誤代碼一直在新增,詳細的錯誤代碼,請到綠界廠商管理後台->系統開發管理->交易狀態

代碼查詢。

綠界科技股份有限公司

Green World FinTech Service Co., Ltd.

綠界 Apple Pay 介接技術文件 58 / 55

附錄 4. URLEncode 轉換表

符號 URLEncode 編碼結果 .NETURLEncode 編碼結果

- %2d -

_ %5f _

. %2e .

! %21 !

~ %7e %7e

* %2a *

( %28 (

) %29 )

space 空格 %20 +

@ %40 %40

# %23 %23

$ %24 %24

% %25 %25

^ %5e %5e

& %26 %26

= %3d %3d

+ %2b %2b

; %3b %3b

? %3f %3f

/ %2f %2f

\ %5c %5c

> %3e %3e

< %3c %3c

% %25 %25

` %60 %60

[ %5b %5b

] %5d %5d

{ %7b %7b

} %7d %7d

: %3a %3a

' %27 %27

" %22 %22

, %2c %2c

| %7c %7c