共用方式為


Xamarin.iOS 的 Apple Pay 功能

為應用程式新增功能通常需要額外的佈建設定。 本指南說明 Apple Pay 功能所需的設定。

Apple Pay 可讓使用者透過其 iOS 裝置支付實體產品的費用。 本節說明如何在 Apple Developer Center (Apple 開發人員中心) 中建立 Apple Pay 所需的一切必要元件。

透過開發人員中心佈建新的應用程式時,需要進行三個步驟:

  1. 建立 Merchant ID (商家識別碼)。
  2. 建立具有 Apply Pay 功能的 App ID (應用程式識別碼),然後在其中新增商家。
  3. 為該 Merchant ID (商家識別碼) 產生憑證。

下列步驟將引導您完成建立上述項目的程序:

建立商家識別碼

Merchant ID (商家識別碼) 可用來讓 Apple Pay 知道您可以接受付款,而且此識別碼會傳遞給 PassKit 的 PaymentRequest 方法並在 Apple Pay 權利中使用:

  1. 瀏覽至 Apple Developer Center \(Apple 開發人員中心\),然後移至 [Certificates, Identifier, and Profiles] \(憑證、識別碼及設定檔\) 區段:

    Developer Center Merchant ID selection

  2. 在 [Identifiers] \(識別碼\) 底下,選取 [Merchant IDs] \(商家識別碼\),然後選取 []+ 來建立新的商家識別碼:

  3. 在表單中填入新的描述和識別碼,如下所示。 描述可方便您辨識識別碼,並可在稍後變更。 識別碼對您而言必須是唯一的,且開頭必須是字串 merchant。 Apple 建議識別碼採用下列格式:merchant.com.[Your-App-Name]:

    New Merchant ID details

  4. 確認詳細數據,並 註冊 您的識別碼:

    Merchant ID confirmation

建立具有 Apply Pay 功能且含有商家識別碼的應用程式識別碼

  1. Developer Center \(開發人員中心\) 中,按一下 [Identifiers] \(識別碼\) 底下的 [App IDs] \(應用程式識別碼\)

    Select App ID in Developer Center

  2. 選取 []+ 按鈕來新增 App ID (應用程式識別碼):

    Add new App ID button

  3. 輸入 App ID (應用程式識別碼) 的 [Name] \(名稱\),並為它提供 [Explicit App ID] \(明確的應用程式識別碼\):

    App ID details screen

  4. 在 [App Services] \(應用程式服務\) 底下,選取 [Apple Pay]:

    App Services Apple Pay

  5. 選取 [Continue] \(繼續\),然後選取 [Register] \(註冊\)。 請注意,在確認畫面上,Apple Pay 的 [Configurable] \(可設定\) 會顯示成已選取 (帶有黃色符號):

    Confirmation Screen for Apple Pay

  6. 返回 App ID (應用程式識別碼) 清單,然後選取您剛才建立的應用程式識別碼:

    Edit App ID

  7. 向下捲動到這個已展開區段的底部,然後按一下 [Edit] \(編輯\)

  8. 將清單向下捲動到 Apple Pay,然後按一下 [Edit] \(編輯\) 按鈕:

    Edit Apple Pay App ID details

  9. 選取要與此 App ID (應用程式識別碼) 搭配使用的 Merchant ID (商家識別碼),然後按一下 [Continue] \(繼續\)

    Select Merchant ID to use for App ID

  10. 確認 Merchant ID (商家識別碼) 指派項目,然後按 [Assign] \(指派\)

    Confirmation Screen

此 App ID (應用程式識別碼) 現在已可用來產生 (或重新產生) 新的佈建設定檔,如使用功能指南所述。

為您的商家識別碼產生憑證

Apple 需要使用憑證來加密與交易關聯的敏感性資料。 每個建立的 Merchant ID (商家識別碼) 都必須有自己的憑證。

若要建立憑證,請依照下列步驟進行操作:

  1. 選取上述建立的 Merchant ID (商家識別碼),然後按 [Edit] \(編輯\)

    Edit Merchant ID dialog

  2. 在 [iOS Merchant ID Settings] \(iOS 商家識別碼設定\) 畫面上,按一下 [Create Certificate] \(建立憑證\)

    Create payment processing certificate

  3. 回答以下問題:

    address if payments will be processed exclusively in China

  4. 此時,系統會提示您建立一個 Certificate Signing Request \(憑證簽署要求\):

    Creating a certificate signing request

    重要

    如果您使用 Apple Pay 的付款提供者 (例如 JudoPay 或 Stripe),它們可以提供一個格式正確的 CSR,供您此時使用。 如需此要求的相關資訊,請參閱 Stripe 網站。 若要建立您自己的 CSR,請依照下方的步驟 5 到 8。 建立 CSR 之後,請前往步驟 9。

  5. 開啟 Keychain 存取應用程式,然後流覽至 [Keychain 存取 > 憑證助理 > ] 從證書頒發機構單位要求憑證:

    Create a CSR using keychain on a Mac

  6. 輸入您的電子郵件地址、輸入私密金鑰的名稱、將 [CA 電子郵件地址] 保留空白、選取 [儲存到磁碟] 選項,然後選取 [指定密鑰配對資訊]

    Certificate information dialog

  7. 將 CSR 儲存到便利的位置:

    Saving CSR to local machine

  8. 在 [密鑰配對] 資訊畫面中,將 [密鑰大小] 設定為 256 bit,將 [驗算法] 設定為 ECC,然後按一下 [繼續]

    Enter key pair information dialog

  9. 在 Developer Center (開發人員中心) 上,按一下 [Continue] \(繼續\) 以上傳 CSR:

    Prepare to upload CSR to developer center

  10. 按兩下 [ 選擇檔案... ] 以選取 CSR,然後按 [繼續] 將它上傳至開發人員入口網站:

    Upload CSR to developer center

  11. 產生憑證之後,下載憑證並按兩下以將其安裝到您的 Keychain。

如需有關使用 Apple Pay 的詳細資訊,請參閱下列指南:

後續步驟

以下清單說明可能需要進行的額外步驟:

  • 在您的應用程式中使用架構命名空間。
  • 為您的應用程式新增必要的權利。 如需有關所需權利及如何新增這些權利的詳細資訊,請參閱使用權利指南。
  • 在應用程式的 [iOS 套件組合簽署] 中,確定 [自訂權利] 已設定為 Entitlements.plist 這「不是」「偵錯」和「iOS 模擬器」組建的預設設定。

如果您在應用程式服務方面遇到問題,請參閱主要指南的疑難排解一節。