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

(原文:Apple Pay 作者:Jack Flintermann 译者:Alili)来源:http://www.cocoachina.com/ios/

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

当你在一个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所组成的数组,这个数组包括标签和数量。他们类似于收据上的行项目(这个是我们立刻就可以看到)。

Apple Pay 开发教程:创造更好的支付体验_第1张图片

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 = self
presentViewController(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:这个方法的。

apple-pay-indicators.png

代码如下:

// MARK: - PKPaymentAuthorizationViewControllerDelegate

func 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: - PKPaymentAuthorizationViewControllerDelegate

func 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 AddressBook
import PassKit
import Alamofire

func 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)
    }
}

Apple Pay 开发教程:创造更好的支付体验_第2张图片

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

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

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

随着越来越多的应用开始使用Apple Pay(并且越来越多的用户拥有了支持它的设备),我相信它将成为iOS应用中一种很普遍的支付方式。
本文为CocoaChina组织翻译,本译文权利归译者所有,未经允许禁止转载。

你可能感兴趣的:(ios开发)