Apple Pay 开发教程：创造更好的支付体验

（原文：Apple Pay 作者：Jack Flintermann 译者：Alili）

当你决定在线买一些东西的时候，可能会有一种现代特有的焦虑感涌上心头。虽然没有精确的单词来表达这种焦虑，但如果只想简单的描述的话，可以是：“我的信用卡在哪里？它的号码是多少？我真的需要买这个东西吗？”

当你在一个iOS设备上购物时，这种令人抓狂的感觉会放大：你很有可能没有随身携带你的信用卡，而且手里拿着信用卡还要在手机上输入信息这种操作相当有难度，我觉得应该留给体操选手和宇航员用来展示他们高超的技艺（当然，我是在开玩笑，但是我也愿意打赌苹果公司已经在某个实验室做过这个测试）。

如果你是一位开发者，并且你的App里接受信用卡付款，这个不利的因素将直接影响你的收入。

Apple Pay改变了这一切。尽管很多线下商店把它们的大部分注意力集中在实体付款（如客户可以使用他们的iPhone在支持NFC的终端付款），但除此之外，iOS开发者同样获得了一个极好的机会去提高他们App里的支付体验。

提醒：如果你在你的APP中销售的是电子产品或者虚拟货币，你应该使用内购方式而不是App Pay去销售你的东西（见的App Store Review Guidelines 11.2节）。你可以使用Apple Pay销售你的实体商品和服务。

获取苹果商户ID（Merchant ID）

在做任何测试之前，你必须先注册一个苹果商户ID。而在你做这件事之前，你还需要选择一个支付提供商用来处理你的信用卡流程。苹果公司在他们的Apple Pay开发者页面提供了一份推荐的公司名单（注：我在Stripe公司工作，这个公司是推荐名单中的一个，但本文中的代码不依赖于你选择的任何特定供应商）。你的供应商应该有一个详细的指导，用来告诉你在他们的平台如何设置和使用Apple Pay，整个流程将是这样的：

• 前往苹果开发者中心的Certificates, Identifiers, and Profiles部分并且创建一个新的商家ID。

• 接下来，前往选择证书菜单，并创建一个新的苹果支付证书。这需要向苹果公司上传证书签名请求（CSR）。当你注册一个支付处理，他们通常会为你提供一个CSR使用。你可以使用CSR通过这个指导生成自己私有的证书，但你的付款处理程序将无法解密它，你需要在以后重新生成。

• 在Xcode中，打开你的项目设置中的“Capabilities”部分，然后将“Apple Pay”选项打开。你可能需要从提供的列表中选择之前创建的商家ID。

创建第一次交易

Apple Pay只支持可以使用Apple Pay的iOS设备（如iPhone6/6+,iPad Mini 3,iPad Air 2）。此外，你需要先添加苹果支付授权，才能在你的应用程序中进行测试（在“获取苹果商家ID”中所述）。如果你想在模拟器上模拟它的行为，你可以在Github上找到一个模仿它的功能（测试信用卡的详细消息）的测试库。

一旦你准备好了商家帐户，那么开始使用Apple Pay将会非常简单。当你的验证超时时，你首先需要先看你正在运行的设备是否支持Apple Pay，接着看你的客户是否已经将信用卡添加在Passbook：

let paymentNetworks = [PKPaymentNetworkAmex, PKPaymentNetworkMasterCard, PKPaymentNetworkVisa]if PKPaymentAuthorizationViewController.canMakePaymentsUsingNetworks(paymentNetworks) {    // ?Pay is available!} else {    // Show your own credit card form.}

假设Apple Pay是可用的，下一个步骤将是调用PKPaymentRequest。它是描述你从客户那里要求收取的费用。如果你的付款请求发生在美国，这里你需要设置一些默认选项，以后也无需改变：

let request = PKPaymentRequest()request.supportedNetworks = [PKPaymentNetworkAmex, PKPaymentNetworkMasterCard, PKPaymentNetworkVisa]request.countryCode = "US"request.currencyCode = "USD"request.merchantIdentifier = "#Replace me with your Apple Merchant ID#"request.merchantCapabilities = .Capability3DS

接下来，使用paymentSummaryItem属性来描述用户真正买的商品。这需要包含一系列的PKPaymentSummaryItem所组成的数组，这个数组包括标签和数量。他们类似于收据上的行项目（这个是我们立刻就可以看到）。

let wax = PKPaymentSummaryItem(label: "Mustache Wax", amount: NSDecimalNumber(string: "10.00"))let discount = PKPaymentSummaryItem(label: "Discount", amount: NSDecimalNumber(string: "-1.00"))let totalAmount = wax.amount.decimalNumberByAdding(discount.amount)                            .decimalNumberByAdding(shipping.amount)let total = PKPaymentSummaryItem(label: "NSHipster", amount: totalAmount)request.paymentSummaryItems = [wax, discount, shipping, total]

请注意，这里您可以指定零或负数价格，用做优惠券的使用或其它信息。然而，总量的要求是必须大于零的。你将会注意到，我们使用PKShippingMethod这个方法（从PKPaymentSummaryItem继承）来描述我们的送货方式。下面我们会更详细的讲解。

接下来，我们结合 PKPaymentRequest创建PKPaymentAuthorizationViewController的示例来向客户展示支付清单 （在这个例子中，所有这些代码都位于隐藏在支付背后的UIViewController里面）。

let viewController = PKPaymentAuthorizationViewController(paymentRequest: request)viewController.delegate = selfpresentViewController(viewController, animated: true, completion: nil)

一些需要注意的地方：

• 视图控制器不完全占据屏幕（在这种情况下，蓝色的背景是我们应用程序的一部分）。你可以通过更新后台视图控制器让PKPaymentAuthorizationViewController可见。

• 所有的文本自动大写。

• 把最后一行从剩余部分分离出来的目的是显示你的总收入。标签将自动在前面加上“PAY”，所以这里通常使用公司名称。

• 整个UI是通过Remote View Controller来展现的。这意味着，在你给的PKPaymentRequest之外，以其他的方式展现或修改这个视图的内容是不可能的。

PKPaymentAuthorizationViewControllerDelegate

实际上为了处理由PKPaymentAuthorizationViewController返回的付款信息，您需要实现PKPaymentAuthorizationViewControllerDelegate这个协议。它有两个必须实现的方法，分别如下：
-(void)paymentAuthorizationViewController:didAuthorizePayment:completion:
-(void)paymentAuthorizationViewControllerDidFinish:

要了解这些方法的工作原理，我们需要看看一个Apple Pay交易具体是如何工作的：

• 写一个如上所述的PKPaymentAuthorizationViewController。

• 客户同意使用Touch ID购买（或者在失败了3次之后通过输入自己的密码购买）。

• 指纹图标变成一个带有“Processing”的旋转标签

• 你的代理将接收paymentAuthorizationViewController:didAuthorizePayment:completion: callback回调。

• 你的应用程序与付款进程进行异步通信，网站后台实际上是对这些付款细节的代办。一旦付款结束，你根据返回的结果调用PKPaymentAuthorizationStatus.Success或PKPaymentAuthorizationStatus.Failure以完成处理。

• 把PKPaymentAuthorizationViewController旋转动画到成功或失败图标。如果成功的话，用户将会收到一个从PassBook发出的表明从用户信用卡消费的通知。

• 你的代理会接收paymentAuthorizationViewControllerDidFinish:方法的回调。它是负责调用用来切换支付页面的dismissViewControllerAnimated:这个方法的。
  

代码如下：

// MARK: - PKPaymentAuthorizationViewControllerDelegatefunc paymentAuthorizationViewController(controller: PKPaymentAuthorizationViewController!, didAuthorizePayment payment: PKPayment!, completion: ((PKPaymentAuthorizationStatus) -> Void)!) {    // Use your payment processor's SDK to finish charging your customer.    // When this is done, call completion(PKPaymentAuthorizationStatus.Success)}func paymentAuthorizationViewControllerDidFinish(controller: PKPaymentAuthorizationViewController!) {    dismissViewControllerAnimated(true, completion: nil)}

在这里， processPayment:payment completion: 这个方法是你自己的代码，并会利用你的支付处理程序中的SDK来完成交易。

动态的送货方式和价格

如果你的客户使用Apple Pay购买实体商品，你可能要为他们提供不同送货选项。你可以在PKPaymentRequest这个方法设置shippingMethods选项做到这一点。然后，你可以执行PKPaymentAuthorizationViewControllerDelegate代理中的可选方法paymentAuthorizationViewController:didSelectShippingMethod:completion:给用户的选择作出响应。这个方法遵循类似上述didAuthorizePayment方法描述的模式，在这里你可以通过这个异步回调更新PKPaymentSummaryItem数组，这个数组中包含客户所需的送货方式。 （还记得继承自PKPaymentSummaryItem的PKShippingMethod方法吗？在这里是非常有用的！）

下面是我们之前示例的修改版本，作为视图控制器和辅助函数的计算属性实现：

var paymentRequest: PKPaymentRequest {    let request = ... // initialize as before    let freeShipping = PKShippingMethod(label: "Free Shipping", amount: NSDecimalNumber(string: "0"))    freeShipping.identifier = "freeshipping"    freeShipping.detail = "Arrives in 6-8 weeks"    let expressShipping = PKShippingMethod(label: "Express Shipping", amount: NSDecimalNumber(string: "10.00"))    expressShipping.identifier = "expressshipping"    expressShipping.detail = "Arrives in 2-3 days"    request.shippingMethods = [freeShipping, expressShipping]    request.paymentSummaryItems = paymentSummaryItemsForShippingMethod(freeShipping)    return request}func paymentSummaryItemsForShippingMethod(shipping: PKShippingMethod) -> ([PKPaymentSummaryItem]) {    let wax = PKPaymentSummaryItem(label: "Mustache Wax", amount: NSDecimalNumber(string: "10.00"))    let discount = PKPaymentSummaryItem(label: "Discount", amount: NSDecimalNumber(string: "-1.00"))    let totalAmount = wax.amount.decimalNumberByAdding(discount.amount)                                .decimalNumberByAdding(shipping.amount)    let total = PKPaymentSummaryItem(label: "NSHipster", amount: totalAmount)    return [wax, discount, shipping, total]}// MARK: - PKPaymentAuthorizationViewControllerDelegatefunc paymentAuthorizationViewController(controller: PKPaymentAuthorizationViewController!, didSelectShippingMethod shippingMethod: PKShippingMethod!, completion: ((PKPaymentAuthorizationStatus, [AnyObject]!) -> Void)!) {    completion(PKPaymentAuthorizationStatus.Success, paymentSummaryItemsForShippingMethod(shippingMethod))}

在这个例子中，客户会选择免费配送或快递，随着他们选择的改变，价格也会相应的调整。

别急，后面还有更多！

与其提供一些固定费率的配送选项，你可以让用户自行选择送货地址，并在其基础上动态的计算运费。为了达到目的，首先你需要在你的PKPaymentRequest方法中设定要求的requiredShippingAddressFields属性。这可以是电子邮件，电话号码和地址的任意组合。

另外，如果你不需要用户的详细通讯地址而是需要收集一些联系方式（如发送收据的email地址），这样做是一个很好的方法。

当设置了送货地址这个字段，将在支付用户界面出现一个新的“送货地址”，以便允许客户选择之前保存的地址。每次用户选择时，paymentAuthorizationViewController:didSelectShippingAddress:completion:将消息发送到你的PKPaymentAuthorizationViewControllerDelegate代理。

在这里，你应该为选择的地址计算相应的费用，然后调用带有3个参数的completion回调：

• 回调的结果

  • 如果成功调用PKPaymentAuthorizationStatus.Success

  • 如果出现连接错误调用PKPaymentAuthorizationStatus.Failure

  • 如果API返回一个空的数组调用InvalidShippingPostalAddress （即该收货地址是不可用的）

• 数组PKShippingMethods代表用户可用的收货地址。

• 新数组PKPaymentSummaryItems包含一个送货方法。

我已经搭建了一个非常简单的用来查询给定地址运费的EasyPost API的Web后台。这个源码可以在https://github.com/jflinter/example-shipping-api  获得。

这里则是一个查询此API的函数，用了Alamofire：

import AddressBookimport PassKitimport Alamofirefunc addressesForRecord(record: ABRecord) -> [[String: String]] {    var addresses: [[String: String]] = []    let values: ABMultiValue = ABRecordCopyValue(record, kABPersonAddressProperty).takeRetainedValue()    for index in 0.. Void) {    let parameters = [        "street": address[kABPersonAddressStreetKey] ?? "",        "city": address[kABPersonAddressCityKey] ?? "",        "state": address[kABPersonAddressStateKey] ?? "",        "zip": address[kABPersonAddressZIPKey] ?? "",        "country": address[kABPersonAddressCountryKey] ?? ""    ]    Alamofire.request(.GET, "http://example.com", parameters: parameters)             .responseJSON { (_, _, JSON, _) in                if let rates = JSON as? [[String: String]] {                    let shippingMethods = map(rates) { (rate) -> PKShippingMethod in                        let identifier = rate["id"]                        let carrier = rate["carrier"] ?? "Unknown Carrier"                        let service = rate["service"] ?? "Unknown Service"                        let amount = NSDecimalNumber(string: rate["amount"])                        let arrival = rate["formatted_arrival_date"] ?? "Unknown Arrival"                        let shippingMethod = PKShippingMethod(label: "\(carrier) \(service)", amount: amount)                        shippingMethod.identifier = identifier                        shippingMethod.detail = arrival                        return shippingMethod                    }                }             }}

有了这个，就可以简单的实现PKPaymentAuthorizationViewControllerDelegate这个代理:

func paymentAuthorizationViewController(controller: PKPaymentAuthorizationViewController!, didSelectShippingAddress record: ABRecord!, completion: ((PKPaymentAuthorizationStatus, [AnyObject]!, [AnyObject]!) -> Void)!) {    if let address = addressesForRecord(record).first {        fetchShippingMethodsForAddress(address) { (shippingMethods) in            switch shippingMethods?.count {            case .None:                completion(PKPaymentAuthorizationStatus.Failure, nil, nil)            case .Some(0):                completion(PKPaymentAuthorizationStatus.InvalidShippingPostalAddress, nil, nil)            default:                completion(PKPaymentAuthorizationStatus.Success, shippingMethods, self.paymentSummaryItemsForShippingMethod(shippingMethods!.first!))            }        }    } else {        completion(PKPaymentAuthorizationStatus.Failure, nil, nil)    }}

现在，用户可以根据他们的居住地址来选择收货地址和方式。他们最终选择的shippingAddress和shippingMethod将在paymentAuthorizationViewController:didAuthorizePayment:completion:方法中作为PKPayment的属性。

这篇文章中的所有源码公布在 https://github.com/jflinter/ApplePayExample  。

尽管Apple Pay只公开了少量的API，但是它的可用范围十分广泛，你可以在你的App中自定义适当的结账流程。它甚至允许你建立新的流程，如让用户不需要创建账号就能买东西。

随着越来越多的应用开始使用Apple Pay（并且越来越多的用户拥有了支持它的设备），我相信它将成为iOS应用中一种很普遍的支付方式。