iOS 9: Day by Day 第八天 Apple Pay集成

96
戴维营教育
2016.04.17 20:10* 字数 2049

本文翻译自Chris Grant《iOS9 Day-by-Day :: Day8 :: Apple Pay》(https://www.shinobicontrols.com/blog/ios9-day-by-day-day8-apple-pay)。感谢Chris Grant的辛苦工作!

iOS 8开始引入的Apple Pay是一种简单、安全的支付方式,支持在应用内购买实际物品和服务。它允许用户在支付的时候通过指纹进行授权。
只有部分iOS设备支持Apple Pay,其中包括iPhone 6、iPhone 6+、iPad Air以及iPad mini 3(本文翻译的时候增加了iPhone 6S/iPhone 6S+和iPhone SE)。这是因为Apple Pay需要一个特殊的安全芯片的支持。该芯片用于存储和加密关键数据。
我们不应该使用应用内购买(IAP)而不是Apple Pay解锁程序功能。Apple Pay使用来购买实际商品和服务的,例如俱乐部会员、酒店预订以及购票等。

为什么要使用Apple Pay

Apple Pay让开发者变得更轻松。我们不再需要保存和处理卡号,也不需要用户登录。整个购买和付费信息和Apple Pay令牌一起被自动发送到支付处理器。这意味着更加简单的支付流程,并将导致更高的转化率。

在WWDC session 702(Apple Pay Within Apps)中,Nick Shearer给出了一些关于转化率的统计数据。

  • Stubhub的Apple Pay客户的交易比普通客户多20%。
  • OpenTable整合Apple Pay后,交易增加了50%。
  • Staples使用Apple Pay后,预订增加到原来的109%。

创建一个简单的商店应用

我们将通过在程序中设置一个简单的商店来演示如何使用Apple Pay处理交易。这个只有一个商品的应用程序通过整合Apple Pay来演示Apple Pay的设置和使用。

上面就是我们将要创建的程序。当我们点击购买按钮,它会弹出显示一个Apple Pay的表单。

启用Apple Pay

在开始写代码之前,我们需要设置应用程序,使之支持Apple Pay。创建新的项目后,打开项目设置并跳转到“Capabilities”标签。

找到Apple Pay,并将它设置为启用状态。Xcode会让我们选择一个开发团队。一般来说,一旦启用Apple Pay,Xcode会自动完成所有的设置。

我们必须设置一个商家ID(Merchant ID),这样苹果就能知道如何给支付过程进行加密。在商家ID区域点击添加按钮,输入一个唯一的商家。在这个例子里,我们使用merchat.com.shinobistore.applepay

这样就完成了Apple Pay的设置,并且可以在应用程序中进行使用。

使用Apple Pay

到目前为止,我们已经设置好所有配置信息,下面开始构建一个允许用户进行购买商品的界面。打开程序的故事板(Storyboard),添加一些控件来表示我们的商品。

由于只是进行演示,我们在界面上仅放置了一个图片、标题和描述信息。然后在界面的底部添加一个购买按钮PKPaymentButton。该控件是iOS 8.3引入的。这个Apple Pay的支付按钮进行了本地化。它给用户提供了一个标准的指示器,表示支持Apple Pay。苹果强烈建议我们使用这个按钮来启用Apple Pay。

该按钮有三种可用样式:

  • White
  • WhiteOutline
  • Black

以及两种不同的按钮形式:

  • Plain
  • Buy

不过可惜的是,目前还不支持直接可视化的添加该按钮。因此我们只能打开ViewController.swift,并且修改viewDidLoad方法如下。

override func viewDidLoad() {
    super.viewDidLoad()

    let paymentButton = PKPaymentButton(type:.Buy, style:.Black)
    paymentButton.translatesAutoresizingMaskIntoConstraints = false
    paymentButton.addTarget(self, action: "buyNowButtonTapped", forControlEvents: .TouchUpInside)
    bottomToolbar.addSubview(paymentButton)

    bottomToolbar.addConstraint(NSLayoutConstraint(item: paymentButton, attribute: .CenterX, relatedBy: .Equal, toItem: bottomToolbar, attribute: .CenterX, multiplier: 1, constant: 0))
    bottomToolbar.addConstraint(NSLayoutConstraint(item: paymentButton, attribute: .CenterY, relatedBy: .Equal, toItem: bottomToolbar, attribute: .CenterY, multiplier: 1, constant: 0))
}

这段代码是自说明的,因此我们继续往下看。注意,我们真正关注的界面元素是这个支付按钮。一旦点击按钮,调用buyNowButtonTapped:,从而出发支付流程。

到这里,我们已经设置好应用程序界面。下面开始处理购买流程。在开始之前,我们需要先对Apple Pay支付流程中所使用到的各个类有一个深刻的理解。

PKPaymentSummaryItem

该对象简化对Apple Pay支付中商品的表示。它可以表示任何的商品。

PKPaymentRequest

PKPaymentRequest包含了客户购买的商品以及支付所需的比如商家、国家码以及现金代码等信息。

PKPaymentAuthorisationViewController

PKPaymentAuthorisationViewController提示用户授权PKPaymentRequest,并且选择邮寄地址以及合法的支付卡。

PKPayment

PKPayment包含支付过程中所需的所有信息和确认信息。

上面的所有类都来自PassKit框架(以PK开头),因此在使用的时候,我们需要引入这个框架。

设置一个支付

设置支付的第一步是创建一个PKPaymentRequest对象,见一下代码:

func buyNowButtonTapped(sender: UIButton) {

    // Networks that we want to accept.
    let paymentNetworks = [PKPaymentNetworkAmex,
        PKPaymentNetworkMasterCard,
        PKPaymentNetworkVisa,
        PKPaymentNetworkDiscover]

第一个需要设置的是可以使用的支付网络。它设置了允许使用的信用卡种类。

    if PKPaymentAuthorizationViewController.canMakePaymentsUsingNetworks(paymentNetworks) {

然后检查该设备是否支持Apple Pay。如果返回YES表示支持:

    let request = PKPaymentRequest()

        // This merchantIdentifier should have been created for you in Xcode when you set up the ApplePay capabilities.
        request.merchantIdentifier = "shinobistore.com.day-by-day."
        request.countryCode = "US" // Standard ISO country code. The country in which you make the charge.
        request.currencyCode = "USD" // Standard ISO currency code. Any currency you like.
        request.supportedNetworks = paymentNetworks
        request.merchantCapabilities = .Capability3DS // 3DS or EMV. Check with your payment platform or processor.

如果该设备支持支付功能,我们就可以使用上面的代码启动支付请求。注释说明了每一行代码的功能。

        // Set the items that you are charging for. The last item is the total amount you want to charge.
        let shinobiToySummaryItem = PKPaymentSummaryItem(label: "Shinobi Cuddly Toy", amount: NSDecimalNumber(double: 22.99), type: .Final)
        let shinobiPostageSummaryItem = PKPaymentSummaryItem(label: "Postage", amount: NSDecimalNumber(double: 3.99), type: .Final)
        let shinobiTaxSummaryItem = PKPaymentSummaryItem(label: "Tax", amount: NSDecimalNumber(double: 2.29), type: .Final)
        let total = PKPaymentSummaryItem(label: "Total", amount: NSDecimalNumber(double: 29.27), type: .Final)

这些是我们希望在Apple Pay列表中显示的产品,将用于设置支付请求对象。

    request.paymentSummaryItems = [shinobiToySummaryItem, shinobiPostageSummaryItem, shinobiTaxSummaryItem, total]

有意思的是,这个数组的最后一个元素将是用户最终需要支付的内容。这样做刚开始的时候并不是很明确。但是Apple Pay确实是按照表单中的最后一条的金额进行支付。因此我们如果有多条记录时,需要计算总和,并添加一个额外的PKPaymentSummary对象到列表的最后。

        // Create a PKPaymentAuthorizationViewController from the request
        let authorizationViewController = PKPaymentAuthorizationViewController(paymentRequest: request)

        // Set its delegate so we know the result of the payment authorization
        authorizationViewController.delegate = self

        // Show the authorizationViewController to the user
        presentViewController(authorizationViewController, animated: true, completion: nil)

最后剩下来的就是创建一个PKPaymentAuthorizationViewController对象来支付列表。记得设置它的代理来获取支付结果。

实现PKPaymentAuthorizationViewController的代理方法来获取支付的结果是否成功以及完成时机。

我们需要在paymentAuthorizationViewController:didAuthorizePayment中处理支付数据,并将它们的结果返回给应用程序。在方法中获取到的PKPayment对象有一个PKPaymentToken令牌属性,需要我们发送给支付提供者。这是一个安全的加密数据:

func paymentAuthorizationViewController(controller: PKPaymentAuthorizationViewController, didAuthorizePayment payment: PKPayment, completion: (PKPaymentAuthorizationStatus) -> Void) {

    paymentToken = payment.token

    // You would typically use a payment provider such as Stripe here using payment.token
    completion(.Success)

    // Once the payment is successful, show the user that the purchase has been successful.
    self.performSegueWithIdentifier("purchaseConfirmed", sender: self)
}

我们需要在paymentAuthorizationViewControllerDidFinish隐藏视图控制器。

func paymentAuthorizationViewControllerDidFinish(controller: PKPaymentAuthorizationViewController) {
    self.dismissViewControllerAnimated(true, completion: nil)
}

这就是整个Apple Pay的支付流程。很明显,在显示世界中,我们需要将支付令牌返回给支付提供者,比如Stripe,但这不是本课程需要讨论的内容。我们还可以添加一个简单的视图控制器来显示订单以及支付令牌的ID。这是一个用于表示这次交易的全球唯一的字符串。

更多信息

关于Apple Pay的更多信息,建议观看WWDC session 702(Apple Pay Within Apps)。这将是很长的一课,但是如果对集成Apple Pay感兴趣的话,非常值得我们去观看。中间有一节介绍了如何改进支付流程中的用户体验。

同样,在苹果的开发者网站上有一个Apple Pay指南。它包含了许多关于Apple Pay集成的有用信息。

别忘了还可以在GitHub上下载本课程的示例代码。

戴维营教育

戴维营教育(Dive In Education),潜心做IT职业教育!紧跟时代潮流,不弄虚作假!不忘初心!

iOS 9: Day by Day
Web note ad 1