Creating Payment Requests

Payment Requests支付請求是PKPaymentRequest類的實例。支付請求包含一系列描述用戶的支付對象(為哪些東西付款)的概要項：可用的運(yùn)送方式的列表，用戶需要提供的運(yùn)送信息的描述，關(guān)于商家和支付處理的信息。

Decide Whether the User Can Make Payments 判決用戶是否有能力支付

在生成一個支付請求之前，通過調(diào)用PKPaymentAuthorizationViewController類中的canMakePaymentsUsingNetworks:方法判斷用戶是否能夠使用支持的系統(tǒng)完成支付。使用canMakePayments方法，檢查設(shè)備的硬件和父類控制是否支持Apple Pay。

如果canMakePayments返回NO，表示設(shè)備不支持Apple Pay。因此也不顯示Apple Pay按鈕，轉(zhuǎn)到其他的支付方式。

如果canMakePayments返回YES，但是canMakePaymentsUsingNetworks:返回NO，表示設(shè)備支持Apple Pay,但是用戶沒有添加任何符合要求的支付系統(tǒng)的卡片?？蛇x擇性地去顯示一個支付設(shè)置按鈕，提示用戶設(shè)置卡片。一旦用戶點(diǎn)擊了該按鈕，初始化設(shè)置一個新卡的進(jìn)程(例如：調(diào)用openPaymentSetup方法)。

另外，一旦用戶按下Apple Pay按鈕，必須開始支付授權(quán)進(jìn)程。在展示支付請求之前不能要求用戶執(zhí)行其他任何任務(wù)。例如，如果用戶需要輸入折扣碼，必須在按下Apple Pay按鈕之前請求該代碼。

Bridging from Web-Based Interfaces 基于網(wǎng)絡(luò)接口進(jìn)行橋接

如果app使用網(wǎng)絡(luò)接口購買物品和服務(wù)，必須在處理Apple Pay交易之前從網(wǎng)絡(luò)接口移動該請求到本地iOS代碼。列表3-1展示了需要處理web view的請求的步驟。

Listing 3-1Buying items from a web view

    // Called when the web view tries to load "myShoppingApp:buyItem"
    -(void)webView:(nonnull WKWebView *)webView
    decidePolicyForNavigationAction:(nonnull WKNavigationAction *)navigationAction
    decisionHandler:(nonnull void (^)(WKNavigationActionPolicy))decisionHandler {
        
        // Get the URL for the selected link.
        NSURL *URL = navigationAction.request.URL;
        
        // If the scheme and resource specifier match those defined by your app,
        // handle the payment in native iOS code.
        if ([URL.scheme isEqualToString:@"myShoppingApp"] &&
            [URL.resourceSpecifier isEqualToString:@"buyItem"]) {
            
            // Create and present the payment request here.
            
            // The web view ignores the link.
            decisionHandler(WKNavigationActionPolicyCancel);
        }
        
        // Otherwise the web view loads the link.
        decisionHandler(WKNavigationActionPolicyAllow);
    }

Payment Requests Include Currency and Region Information 包括貨幣和地區(qū)信息的支付請求

在支付請求中所有的概要數(shù)值均使用相同的貨幣(指定使用PKPaymentRequest類中的currencyCode屬性)，均使用三個字母的ISO貨幣代碼，例如USD。

支付請求的國家碼表明在該國家發(fā)生購買操作或者在該國家購買將要被處理。使用兩個字母的ISO國家碼，例如US。

在支付請求中設(shè)置的商戶ID(merchant ID)必須與app中的entitlement中的merchant IDs相匹配.

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

Payment Requests Have a List of Payment Summary Items支付請求有一個支付概要項的列表

展示在PKPaymentSummaryItem類中的支付概要項，描述給用戶的支付請求的不同部分。使用一個小部分的概要項－ 典型地包含總和、任何折扣、運(yùn)費(fèi)、稅金和最終的總和。如果沒有任何其他額外的費(fèi)用(例如：運(yùn)費(fèi)或稅金)，僅僅包含購物的總和。在app中提供逐項的消費(fèi)細(xì)節(jié)。

每個概要項有一個標(biāo)記和數(shù)值，展示在Listing 3-2。標(biāo)記是用戶可讀的概要項總結(jié)的描述。該數(shù)值與支付數(shù)值是一致的。在支付請求中的所有數(shù)值均使用在支付請求中指定的貨幣。折扣或者優(yōu)惠劵的數(shù)值，則設(shè)置為負(fù)數(shù)。

當(dāng)支付被授權(quán)的時候，如果不知道某個實際的費(fèi)用(例如：打車費(fèi))，生成一個使用PKPaymentSummaryItemTypePending類型的總和概要項并且值為0.0。該系統(tǒng)然后標(biāo)記該費(fèi)用為未決定的。

Listing 3-2Creating a payment summary item

    // 12.75 subtotal
    NSDecimalNumber *subtotalAmount = [NSDecimalNumber decimalNumberWithMantissa:1275 exponent:-2 isNegative:NO];
    self.subtotal = [PKPaymentSummaryItem summaryItemWithLabel:@"Subtotal" amount:subtotalAmount];
    
    // 2.00 discount
    NSDecimalNumber *discountAmount = [NSDecimalNumber decimalNumberWithMantissa:200 exponent:-2 isNegative:YES];
    self.discount = [PKPaymentSummaryItem summaryItemWithLabel:@"Discount" amount:discountAmount];

注意：
支付概要項使用NSDecimalNumber類存儲數(shù)量為以10為基的數(shù)。該類的實例可以通過明確地指定尾數(shù)和指數(shù)(展示在代碼列表中)或者提供一個string類型的數(shù)量并指定一個區(qū)域來創(chuàng)建?？偸鞘褂靡?0為基的數(shù)來進(jìn)行金融計算，例如，確定5%折扣的數(shù)量。

即使IEEE的浮點(diǎn)類型數(shù)據(jù)例如float和Double顯示起來非常方便，但不適合于金融計算。這些數(shù)據(jù)類型使用以2為基的數(shù)字表示出來，這意味著一些小數(shù)數(shù)值不能被精確地表示出來。例如：0.42很可能接近于0.419999無限循環(huán)。這類近似值會造成金融計算得到錯誤的結(jié)果。

在列表中最后的一個支付概要項是最終的總和。通過添加所有其他的概要項數(shù)值來計算總和數(shù)值。最終總和的顯示不同于其他的概要項：使用公司的名稱作為它的label內(nèi)容，使用所有其他的概要項的數(shù)值之和作為它的數(shù)值。使用paymentSummaryItems屬性添加支付概要項到支付請求。

    // 10.75 grand total
    NSDecimalNumber *totalAmount = [NSDecimalNumber zero];
    //  計算總和
    totalAmount = [totalAmount decimalNumberByAdding:subtotalAmount];
    totalAmount = [totalAmount decimalNumberByAdding:discountAmount];

    self.total = [PKPaymentSummaryItem summaryItemWithLabel:@"My Company Name" amount:totalAmount];
    
    self.summaryItems = @[self.subtotal, self.discount, self.total];
    request.paymentSummaryItems = self.summaryItems;

A Shipping Method Is a Special Payment Summary Item 運(yùn)送方式是一種特殊的支付概要項

為每個適用的運(yùn)送方式創(chuàng)建一個PKShippingMethod的實例。正如其他的支付概要項一樣，運(yùn)送方式有一個用戶可讀label內(nèi)容(例如“標(biāo)準(zhǔn)的運(yùn)送”或者“次日運(yùn)送”)和一個運(yùn)費(fèi)的數(shù)值。不像其他的概要項，運(yùn)送方式也有detail屬性－例如：“Arrives by July 29”或者“Ships in 24 hours”－ 這說明了運(yùn)送方式之間的不同。

為了在代理方法中區(qū)分運(yùn)送方式，可使用identifier屬性。該屬性僅僅被用于在自己的app中－框架處理它作為一個不透明的值，也不顯示在UI界面中。當(dāng)創(chuàng)建每個運(yùn)送方式時，為它指定一個獨(dú)一無二的標(biāo)識。為了使調(diào)試容易些，使用摘要或者簡短的string值，例如“discount”，“standard”或者“next-day”。

一些運(yùn)送方式不適用于所有的區(qū)域或者對不同的地址有不同的運(yùn)費(fèi)。當(dāng)用戶選擇一個運(yùn)送地址或者方式時可以更新這些信息，正如Your Delegate Updates Shipping Methods and Costs中描述的。

Indicating Your Support Payment Processing Mechanisms 指定支持的支付處理機(jī)制

通過用string常量的數(shù)組填充supportNetworks屬性來指定支持何種支付系統(tǒng)。通過給merchantCapabilities屬性設(shè)定一個值來指定支持何種支付處理協(xié)議。必須支持3DS，支持EMV是可選的。

商家支付能力是位掩碼，聯(lián)合展示如下：

    request.supportedNetworks = @[PKPaymentNetworkAmex, PKPaymentNetworkDiscover, PKPaymentNetworkMasterCard, PKPaymentNetworkVisa];
    
    // Supports 3DS only
    request.merchantCapabilities = PKMerchantCapability3DS;
    
    // Supports both 3DS and EMV
    request.merchantCapabilities = PKMerchantCapability3DS | PKMerchantCapabilityEMV;

Indicating What Shipping and billing Information Is Needed 指定哪些運(yùn)送和賬單信息是必需的

填充支付授權(quán)視圖控制器的requiredBillingAddressFields和requiredShippingAddressFields屬性來指定哪些賬單和運(yùn)送信息是必需的。當(dāng)展示該視圖控制器時，它提示用戶提供要求的賬單和運(yùn)送信息。這些區(qū)域的常量按照下面的方式聯(lián)合設(shè)定這些屬性的值：

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

注意：
僅僅請求需要用來處理支付的賬單和運(yùn)送信息和傳送商品或者服務(wù)。請求不必要的信息會增加不需要的復(fù)雜性。每個額外的步驟會增加用戶簡單地取消了該交易的可能性。

如果你有最新的賬單和運(yùn)送聯(lián)系方式信息，可以在支付請求時設(shè)置這些內(nèi)容。Apple Pay會默認(rèn)使用這些信息；然而，用戶仍然可以選擇其他的聯(lián)系方式信息作為支付授權(quán)處理的一部分。

    PKContact *contact = [[PKContact alloc] init];
    
    //  聯(lián)系人姓名
    NSPersonNameComponents *name = [[NSPersonNameComponents alloc] init];
    name.givenName = @"John";
    name.familyName = @"Appleseed";
    
    contact.name = name;
    
    // 聯(lián)系人地址
    CNMutablePostalAddress *address = [[CNMutablePostalAddress alloc] init];
    address.street = @"1234 Laurel Street";
    address.city = @"Atlanta";
    address.state = @"GA";
    address.postalCode = @"30303";
    
    contact.postalAddress = address;
    
    request.shippingContact = contact;

注意：
地址信息可以來自在iOS中的廣泛的輸入源。在使用它之前總是驗證這些信息。

Storing Additional Information 存儲額外的信息

為了存儲每個app特定的支付請求的信息，例如一個購物車標(biāo)識，使用applicationData屬性。該屬性被對待作為一個系統(tǒng)提供的不透明的值。當(dāng)用戶授權(quán)支付請求之后一大把應(yīng)用數(shù)據(jù)會顯示在支付密鑰中。