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

要使用 Apple Pay,App 必須具備一項專屬權限,這項權限在 Developer Member Center 與 Xcode 兩處都要開啟。此外你還需要註冊一個 Merchant ID(商用識別碼)並為它配置金鑰;後續 App 把支付資料送往伺服器時,就是靠這組金鑰確保傳輸內容不被窺探。
對應章節:〈配置支付環境〉。
支付請求(payment request)是一份描述本次交易結構的物件,裡頭包含金額、可用的配送方式,以及你希望使用者補齊的配送或帳單資訊。你把這份請求交給支付授權視圖控制器,由它負責呈現內容並引導使用者輸入缺漏欄位。使用者操作過程中,App 會透過 delegate 回呼持續收到通知,流程也就能一步一步往下走。
對應章節:〈建立支付請求〉、〈授權支付〉。
Apple Pay 會把支付資料加密,確保未經授權的第三方拿不到持卡人的敏感資訊。你可以自建金流,也可以在自有伺服器上串接第三方支付服務商來解密並完成扣款。支援 Apple Pay 的服務商名單可參考 developer.apple.com/apple-pay/。
對應章節:〈處理支付〉。
Merchant ID 是 Apple 辨識你這家商家的依據,也是加密流程中綁定憑證與公鑰的關鍵。因此在 App 呼叫 Apple Pay 之前,你得先完成註冊與憑證配置。
如果鑰匙圈中出現「未知授權簽發憑證」或「憑證發行者無效」的警告,通常代表你缺少 WWDR 中級憑證 G2 或 Apple Root CA G2,這兩個檔案都可以從 apple.com/certificateauthority 取得。
開啟 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];
使用者一旦提供配送資訊,系統會呼叫 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);
}
使用者按下確認後,框架會與 Apple 伺服器及裝置內的安全元件(Secure Element)溝通,換回一枚支付 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];
}
伺服器端要完成的事,可以列成一條清楚的流水線:
這裡有兩條路可走:交給成熟的支付平台代辦,或自己實作整套流程。多數現成平台能一口氣包辦上述大部分工作。
自建的門檻不低——你必須具備 SHA-1 雜湊計算、PKCS#7 簽章讀取與驗證、Elliptic Curve Diffie-Hellman 金鑰交換等密碼學知識。若團隊沒有相關背景,串接第三方平台是更務實的選擇。支援名單見 developer.apple.com/apple-pay/。
支付資料採嵌套結構:最外層是 PKPaymentToken,其 paymentData 屬性是一個 JSON 字典,字典中的標頭資訊用於驗證與解密;解密後才看得到金額、持卡人姓名,以及各支付處理協定所需的欄位。完整格式規範請參閱 Payment Token Format Reference。
Figure 5-1 支付資料結構
