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

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

  • Upload
    others

  • View
    4

  • 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 信用卡)

    https://developer.apple.com/support/apple-pay-sandbox/

  • 綠界科技股份有限公司

    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 標示,例如
    …等。

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

    料外洩。

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

    https://member-stage.ecpay.com.tw/MemberReg/MemberRegister?back=Nmailto:[email protected]://vendor-stage.ecpay.com.tw/

  • 綠界科技股份有限公司

    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 付款

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

  • 綠界科技股份有限公司

    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 付款按鈕

  • 綠界科技股份有限公司

    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

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

  • 綠界科技股份有限公司

    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

    http://www.epochconverter.com/http://www.epochconverter.com/

  • 綠界科技股份有限公司

    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

    https://vendor.ecpay.com.tw/PrepaidAccount/Create

  • 綠界科技股份有限公司

    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 按鈕。

    https://developer.apple.com/programs/ios/develop.html

  • 綠界科技股份有限公司

    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