您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

Apple Pay 開發實戰指南:從環境配置到支付入帳

編輯:iOS 開發基礎

Apple Pay 讓使用者能在現實世界的商店與服務中,以極低的操作成本完成付款,而且不必把卡號交到商家手上。本文整理自 Apple 官方文件《Apple Pay Programming Guide》,依序拆解四個關鍵環節:環境配置、建立支付請求、使用者授權,以及伺服器端的支付處理。(若你要賣的是 App 內的數位商品或服務,那屬於 In-App Purchase 的範疇,請參考對應文件。)

一、Apple Pay 在 App 中如何運作

整條金流大致可以拆成三段路:你的 App 描述一筆購買行為、系統向使用者索取授權、最後由你的伺服器完成收款。

1. 在 Xcode 與開發者會員中心開啟權限

要使用 Apple Pay,App 必須具備一項專屬權限,這項權限在 Developer Member Center 與 Xcode 兩處都要開啟。此外你還需要註冊一個 Merchant ID(商用識別碼)並為它配置金鑰;後續 App 把支付資料送往伺服器時,就是靠這組金鑰確保傳輸內容不被窺探。

對應章節:〈配置支付環境〉。

2. 由使用者授權支付請求

支付請求(payment request)是一份描述本次交易結構的物件,裡頭包含金額、可用的配送方式,以及你希望使用者補齊的配送或帳單資訊。你把這份請求交給支付授權視圖控制器,由它負責呈現內容並引導使用者輸入缺漏欄位。使用者操作過程中,App 會透過 delegate 回呼持續收到通知,流程也就能一步一步往下走。

對應章節:〈建立支付請求〉、〈授權支付〉。

3. 由伺服器完成收款

Apple Pay 會把支付資料加密,確保未經授權的第三方拿不到持卡人的敏感資訊。你可以自建金流,也可以在自有伺服器上串接第三方支付服務商來解密並完成扣款。支援 Apple Pay 的服務商名單可參考 developer.apple.com/apple-pay/。

對應章節:〈處理支付〉。

二、配置支付環境

Merchant ID 是 Apple 辨識你這家商家的依據,也是加密流程中綁定憑證與公鑰的關鍵。因此在 App 呼叫 Apple Pay 之前,你得先完成註冊與憑證配置。

註冊 Merchant ID

  1. 登入 Developer Member Center,進入「Certificates, Identifiers & Profiles」。
  2. 在 Identifiers 區塊中選擇 Merchant IDs。
  3. 點右上角「+」按鈕。
  4. 填寫 Description 與 ID 欄位,按 Continue。
  5. 確認設定無誤後按 Register,完成後按 Done。

為識別碼建立憑證

  1. 同樣進入「Certificates, Identifiers & Profiles」,選擇 Merchant IDs。
  2. 點選清單中的識別碼,按 Edit。
  3. 按 Create Certificate,依指示產生 CSR(憑證簽章請求),再按 Continue。
  4. 按 Choose File 選取 CSR,按 Generate。
  5. 按 Download 下載憑證,完成後按 Done。

如果鑰匙圈中出現「未知授權簽發憑證」或「憑證發行者無效」的警告,通常代表你缺少 WWDR 中級憑證 G2 或 Apple Root CA G2,這兩個檔案都可以從 apple.com/certificateauthority 取得。

在 Xcode 中啟用

開啟 App 的專案設定,切到 Capabilities 面板,把 Apple Pay 的開關切到 ON,再選擇這個 App 要使用的 Merchant ID 即可。

除錯時偶爾需要手動啟用,步驟如下:進入 Member Center 的 Certificates, Identifiers & Profiles → App IDs,選取目標 App ID 按 Edit,勾選 Apple Pay 後再按 Edit,挑選要用的識別碼並 Continue,確認設定後按 Assign,最後 Done。

三、建立支付請求

支付請求是 PKPaymentRequest 的執行個體,內容包含購買項目摘要、可用配送方式清單、需要向使用者索取的配送資訊描述,以及商家與支付平台的相關參數。

先確認使用者能不能付款

在建立請求之前,先呼叫 PKPaymentAuthorizationViewController 的 canMakePaymentsUsingNetworks:,確認使用者手上至少有一張你支援的支付網路卡片。若要判斷裝置本身是否支援 Apple Pay,或是否受限於螢幕使用時間等家長控制,則改用 canMakePayments。

如果答案是「不能付款」,請直接隱藏 Apple Pay 按鈕,改提供其他付款管道,別讓使用者點進死胡同。

幣別與地區

同一筆請求中的所有金額必須使用相同幣別,透過 currencyCode 指定,格式為 ISO 的三碼貨幣代碼,例如 USD。國家代碼 countryCode 則代表交易發生的地區或將處理此筆付款的地區,使用 ISO 的兩碼國碼,例如 US。請求中設定的 Merchant ID 必須落在 App 已註冊的識別碼清單內。

request.currencyCode = @"USD";
request.countryCode = @"US";
request.merchantIdentifier = @"merchant.com.example";

支付摘要項目

摘要項目是 PKPaymentSummaryItem,用來拆解一筆金額的組成。每個項目有一組標籤與金額:標籤是給使用者看的說明文字,金額則是對應數值,並須使用同一幣別;折扣或折抵券請填負數。

實務上別塞太多項目,保留小計、折扣、運費、稅金與總計這幾項就已足夠。若使用者想看更細的明細,放在 App 內的其他頁面呈現即可。

NSDecimalNumber *subtotalAmount = [NSDecimalNumber decimalNumberWithMantissa:1275 exponent:-2 isNegative:NO];
self.subtotal = [PKPaymentSummaryItem summaryItemWithLabel:@"Subtotal" amount:subtotalAmount];

NSDecimalNumber *discountAmount = [NSDecimalNumber decimalNumberWithMantissa:200 exponent:-2 isNegative:YES];
self.discount = [PKPaymentSummaryItem summaryItemWithLabel:@"Discount" amount:discountAmount];

為什麼一定要用 NSDecimalNumber?它是以 10 為底的十進位數值型別。你可以像上面那樣用尾數加指數的方式建立,也可以用字串搭配 locale 初始化。所有財務計算都該堅持十進位——例如計算 5% 折扣後的金額。float、Double 這類 IEEE 浮點數是以 2 為底表示的,像 0.42 這種值只能近似成 0.41999…,累積起來就是帳實不符的常見原因。雖然某些情境下浮點運算寫起來更方便,但金流環節請一律避開。

清單的最後一項是總計,等於其他所有項目的加總。它與其他項目的差別在顯示方式:標籤用你的公司名稱,金額用加總結果。

NSDecimalNumber *totalAmount = [NSDecimalNumber zero];
totalAmount = [totalAmount decimalNumberByAdding:subtotalAmount];
totalAmount = [totalAmount decimalNumberByAdding:discountAmount];
self.total = [PKPaymentSummaryItem summaryItemWithLabel:@"My Company Name" amount:totalAmount];
request.paymentSummaryItems = @[self.subtotal, self.discount, self.total];

配送方式是一種特殊摘要項目

每一種配送選項對應一個 PKShippingMethod 執行個體。它與一般摘要項目一樣有標籤(例如「標準配送」、「次日送達」)與費用,但額外多了 detail 屬性,可以補充說明差異,例如「7 月 29 日前送達」或「24 小時內出貨」。

identifier 則供你在 delegate 方法中分辨使用者選了哪一種配送方式。這個值只存在於你的 App 內部,框架看不到、UI 也不會顯示,因此取個好記的縮寫(如 standard、next-day)就能大幅降低除錯成本。

某些配送方式在特定地區可能不適用或價格不同,你可以在使用者變更配送地址或配送方式的 delegate 方法中即時更新清單與費用。

宣告你支援的支付方式

用 supportedNetworks 填入一組支付網路常數;再用 merchantCapabilities 宣告你能處理的支付標準。3DS 是必填,EMV 則視需求選配,兩者以位元 OR 組合。

request.supportedNetworks = @[PKPaymentNetworkAmex, PKPaymentNetworkMasterCard, PKPaymentNetworkVisa];

// 僅支援 3DS
request.merchantCapabilities = PKMerchantCapability3DS;

// 同時支援 3DS 與 EMV
request.merchantCapabilities = PKMerchantCapability3DS | PKMerchantCapabilityEMV;

指定需要的帳單與配送欄位

透過 requiredBillingAddressFields 與 requiredShippingAddressFields 告知系統你要哪些資料,視圖控制器顯示時就會提示使用者填寫。這些常數同樣以位元 OR 組合:

request.requiredBillingAddressFields = PKAddressFieldEmail;
request.requiredBillingAddressFields = PKAddressFieldEmail | PKAddressFieldPostalAddress;

如果你手上已經有使用者的帳單與配送資料,可以直接帶入請求中當成預設值。但要注意:Apple Pay 只是「預填」,使用者在授權流程裡仍有權修改。

ABRecordRef record = ABPersonCreate();
// 以 ABRecordSetValue 設定姓名、地址等欄位後
request.shippingAddress = record;
CFRelease(record);

夾帶你自己的附帶資訊

applicationData 可以放進本次請求的專屬標記,例如購物車 ID。使用者完成授權後,這個屬性的雜湊值會一起出現在支付 token 裡,讓你能把付款與後端訂單對上號。

四、授權支付

授權流程由支付授權視圖控制器與它的 delegate 攜手完成。視圖控制器負責兩件事:讓使用者挑選必要的帳單與配送資訊,以及在最後一刻按下確認完成授權。

有個容易踩到的細節:這些 delegate 方法可能被呼叫多次,而呼叫順序取決於使用者的操作順序,請別假設它們只會依固定流程觸發一次。

每個 delegate 方法都帶有一個 completion block 參數。視圖控制器會等目前的 delegate 呼叫 completion 之後,才繼續下一步。唯一例外是 paymentAuthorizationViewControllerDidFinish:——它沒有 completion block,因此任何時刻都能呼叫。

completion 的參數用來回報交易狀態:一切正常就傳 PKPaymentAuthorizationStatusSuccess,否則傳入能代表問題的狀態值。

把支付請求傳進 PKPaymentAuthorizationViewController 的初始化方法,設定 delegate,再 present 出來即可。

PKPaymentAuthorizationViewController *viewController =
    [[PKPaymentAuthorizationViewController alloc] initWithPaymentRequest:request];
if (!viewController) { /* 處理錯誤 */ }
viewController.delegate = self;
[self presentViewController:viewController animated:YES completion:nil];

在 delegate 中更新配送方式與費用

使用者一旦提供配送資訊,系統會呼叫 didSelectShippingAddress:completion: 與 didSelectShippingMethod:completion:。你可以在這兩個方法裡依最新條件重算運費與可用選項,再透過 completion 把結果回傳給畫面。

- (void)paymentAuthorizationViewController:(PKPaymentAuthorizationViewController *)controller
                     didSelectShippingAddress:(ABRecordRef)address
                                   completion:(void (^)(PKPaymentAuthorizationStatus, NSArray *, NSArray *))completion {
    self.selectedShippingAddress = address;
    [self updateShippingCost];
    NSArray *shippingMethods = [self shippingMethodsForAddress:address];
    completion(PKPaymentAuthorizationStatusSuccess, shippingMethods, self.summaryItems);
}

授權完成,支付 token 誕生

使用者按下確認後,框架會與 Apple 伺服器及裝置內的安全元件(Secure Element)溝通,換回一枚支付 token。整個過程大致如下:

  • 框架把支付請求送進安全元件——只有它能讀取裝置中 token 化的卡片資訊。
  • 安全元件把特定卡片與商家的資料加密成只有 Apple 能讀的形式,交回框架並轉送 Apple。
  • Apple 伺服器再進行一層加密,讓資料只有收款商家能解開,接著加上簽章產生支付 token 並回傳裝置。
  • 框架呼叫 delegate 並附上 token,由你把 token 送往自己的伺服器。

後續伺服器怎麼做,取決於你是自建金流還是委外給支付平台。無論哪種,伺服器處理完訂單後要回傳狀態,delegate 再把狀態交給 completion。

- (void)paymentAuthorizationViewController:(PKPaymentAuthorizationViewController *)controller
                           didAuthorizePayment:(PKPayment *)payment
                                    completion:(void (^)(PKPaymentAuthorizationStatus))completion {
    // 取出帳單地址、備妥 token 與訂單資訊後送往伺服器
    PKPaymentAuthorizationStatus status; // 由伺服器回傳
    completion(status);
}

收尾:關掉授權畫面

框架顯示完交易狀態後,會呼叫 paymentAuthorizationViewControllerDidFinish:。在這裡先關閉授權頁,再呈現你自己的訂單確認畫面。

- (void)paymentAuthorizationViewControllerDidFinish:(PKPaymentAuthorizationViewController *)controller {
    [controller dismissViewControllerAnimated:YES completion:nil];
}

五、支付處理

伺服器端要完成的事,可以列成一條清楚的流水線:

  1. 把支付資料連同本次流程所需的其他資訊一併送到伺服器。
  2. 驗證支付資料的雜湊與簽章。
  3. 解密支付資料。
  4. 把資料提交給支付處理系統。
  5. 把訂單寫入訂單追蹤系統。

這裡有兩條路可走:交給成熟的支付平台代辦,或自己實作整套流程。多數現成平台能一口氣包辦上述大部分工作。

自建的門檻不低——你必須具備 SHA-1 雜湊計算、PKCS#7 簽章讀取與驗證、Elliptic Curve Diffie-Hellman 金鑰交換等密碼學知識。若團隊沒有相關背景,串接第三方平台是更務實的選擇。支援名單見 developer.apple.com/apple-pay/。

支付資料採嵌套結構:最外層是 PKPaymentToken,其 paymentData 屬性是一個 JSON 字典,字典中的標頭資訊用於驗證與解密;解密後才看得到金額、持卡人姓名,以及各支付處理協定所需的欄位。完整格式規範請參閱 Payment Token Format Reference。

Figure 5-1 支付資料結構

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved