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：letpaymentNetworks=[PKPaymentNetwo rkAmex,PKPaymentNetworkMasterCard,P KPaymentNetworkVisa]ifPKPaymentAutho rizationViewController.canMakePayments UsingNetworks(paymentNetworks){//?Pay isavailable!}else{//Showyourowncreditcar dform.}假设Apple Pay是可用的，下一个步骤将是调用PKPaymentRequest。它是描述你从客户那里要求收取的费用。如果你的付款请求发生在美国，这里你需要设置一些默认选项，以后也无需改变：letrequest=PKPaymentRequest()request. supportedNetworks=[PKPaymentNetwork Amex,PKPaymentNetworkMasterCard,PKP aymentNetworkVisa]request.countryCode =“US”request.currencyCode=“USD”reques

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

letwax=PKPaymentSummaryItem(label:”MustacheWax”,amount:NSDecimalNumbe r(string:”10.00”))letdiscount=PKPaymentS ummaryItem(label:”Discount”,amount:NS DecimalNumber(string:”-1.00”))lettotalAm ount=wax.amount.decimalNumberByAddi ng(discount.amount).decimalNumberByA dding(shipping.amount)lettotal=PKPayme ntSummaryItem(label:”NSHipster”,amoun t:totalAmount)request.paymentSummaryI tems=[wax,discount,shipping,total]请注意，这里您可以指定零或负数价格，用

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

接下来，我们结合PKPaymentRequest 创建PKPaymentAuthorizationViewController 的示例来向客户展示支付清单（在这个例子中，所有这些代码都位于隐藏在支付背后的UIViewController里面）。letviewController=PKPaymentAuthorizati onViewController(paymentRequest:reque st)viewController.delegate=selfpresentVie wController(viewController,animated:true, completion:nil)一些需要注意的地方：

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

可见。

所有的文本自动大写。

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

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

实际上为了处理由PKPaymentAuthorizationViewController 返回的付款信息，您需要实现PKPaymentAuthorizationViewControllerD elegate这个协议。它有两个必须实现的方法，分别如下：

-(void)paymentAuthorizationViewContro ller:didAuthorizePayment:completion:

-(void)paymentAuthorizationViewContro

llerDidFinish:

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

写一个如上所述的PKPaymentAuthorizationViewController。客户同意使用Touch ID购买（或者在失败了3次之后通过输入自己的密码购买）。

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

你的代理将接收paymentAuthorizationViewController:did AuthorizePayment:completion: callback回调。

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

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

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

代码如下：

//MARK:-PKPaymentAuthorizationViewC ontrollerDelegatefuncpaymentAuthorizati onViewController(controller:PKPaymentA uthorizationViewController!,didAuthorize Paymentpayment:PKPayment!,completion :((PKPaymentAuthorizationStatus)->Void)! ){//Useyourpaymentprocessor'sSDKt ofinishchargingyourcustomer.//Whenthisis

done,callcompletion(PKPaymentAuthoriza tionStatus.Success)}funcpaymentAuthoriz ationViewControllerDidFinish(controller:P KPaymentAuthorizationViewController!){d ismissViewControllerAnimated(true,compl etion:nil)}在这里，processPayment:payment completion: 这个方法是你自己的代码，并会利用你的支付处理程序中的SDK来完成交易。

动态的送货方式和价格

如果你的客户使用Apple Pay购买实体商品，你可能要为他们提供不同送货选项。你可以在PKPaymentRequest这个方法设置shippingMethods选项做到这一点。然后，你可以执行PKPaymentAuthorizationViewControllerD elegate代理中的可选方法paymentAuthorizationViewController:didS electShippingMethod:completion:给用户的选择作出响应。这个方法遵循类似上述didAuthorizePayment方法描述的模式，在这里你可以通过这个异步回调更

新PKPaymentSummaryItem数组，这个数组中包含客户所需的送货方式。（还记得继承自PKPaymentSummaryItem的PKShippingMethod方法吗？在这里是非常有用的！）

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

varpaymentRequest:PKPaymentRequest{l etrequest=...//initializeasbeforeletfreeShip ping=PKShippingMethod(label:”FreeShippi ng”,amount:NSDecimalNumber(string:”0”) )freeShipping.identifier=“freeshipping”fre eShipping.detail=“Arrivesin6-8weeks”letex pressShipping=PKShippingMethod(label:”ExpressShipping”,amount:NSDecimalNum ber(string:”10.00”))expressShipping.identi fier=“expressshipping”expressShipping.det ail=“Arrivesin2-3days”request.shippingMe thods=[freeShipping,expressShipping]requ est.paymentSummaryItems=paymentSum maryItemsForShippingMethod(freeShippi

ng)returnrequest}funcpaymentSummaryIt emsForShippingMethod(shipping:PKShippi ngMethod)->([PKPaymentSummaryItem]){ letwax=PKPaymentSummaryItem(label:”M ustacheWax”,amount:NSDecimalNumber( string:”10.00”))letdiscount=PKPaymentSu mmaryItem(label:”Discount”,amount:NSD ecimalNumber(string:”-1.00”))lettotalAmo unt=wax.amount.decimalNumberByAddin g(discount.amount).decimalNumberByAd ding(shipping.amount)lettotal=PKPayment SummaryItem(label:”NSHipster”,amount:t otalAmount)return[wax,discount,shipping, total]}//MARK:-PKPaymentAuthorizationV iewControllerDelegatefuncpaymentAuthor izationViewController(controller:PKPayme ntAuthorizationViewController!,didSelectS hippingMethodshippingMethod:PKShippin gMethod!,completion:((PKPaymentAuthor izationStatus,[AnyObject]!)->Void)!){compl etion(PKPaymentAuthorizationStatus.Succ ess,paymentSummaryItemsForShippingM

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

别急，后面还有更多！

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

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

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

发送到你的PKPaymentAuthorizationViewControllerD elegate代理。

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

回调的结果

如果成功调用PKPaymentAuthorizationStatus.Success 如果出现连接错误调用PKPaymentAuthorizationStatus.Failure

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

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

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

我已经搭建了一个非常简单的用来查询给定地址运费的EasyPost API的Web 后台。这个源码可以在https://https://www.360docs.net/doc/6510593730.html,/jflinter/example-shipp

ing-api 获得。

这里则是一个查询此API的函数，用了Alamofire：importAddressBookimportPassKitimport AlamofirefuncaddressesForRecord(record: ABRecord)->[[String:String]]{varaddresses: [[String:String]]=[]letvalues:ABMultiValue= ABRecordCopyValue(record,kABPersonAd dressProperty).takeRetainedValue()forinde xin0..Void){letparameters=[“street”:addres s[kABPersonAddressStreetKey]??”“,”city”: address[kABPersonAddressCityKey]??”“,”st ate”:address[kABPersonAddressStateKey]? ?”“,”zip”:address[kABPersonAddressZIPKe y]??”“,”country”:address[kABPersonAddre ssCountryKey]??”“]Alamofire.request(.GET ,”https://www.360docs.net/doc/6510593730.html,”,parameters:param eters).responseJSON{(_,_,JSON,_)inifletrat es=JSONas?[[String:String]]{letshippingMe thods=map(rates){(rate)->PKShippingMeth odinletidentifier=rate[“id”]letcarrier=rate[“carrier”]??”UnknownCarrier”letservice=r

ate[“service”]??”UnknownService”letamo unt=NSDecimalNumber(string:rate[“amou nt”])letarrival=rate[“formatted_arrival_dat e”]??”UnknownArrival”letshippingMethod =PKShippingMethod(label:”\(carrier)\(serv ice)”,amount:amount)shippingMethod.ide ntifier=identifiershippingMethod.detail=ar rivalreturnshippingMethod}}}}有了这个，就可以简单的实现PKPaymentAuthorizationViewControllerD elegate这个代理: funcpaymentAuthorizationViewControlle r(controller:PKPaymentAuthorizationView Controller!,didSelectShippingAddressrecor d:ABRecord!,completion:((PKPaymentAut horizationStatus,[AnyObject]!,[AnyObject] !)->Void)!){ifletaddress=addressesForRecor d(record).first{fetchShippingMethodsForA ddress(address){(shippingMethods)inswitc hshippingMethods?.count{case.None:com pletion(PKPaymentAuthorizationStatus.Fai lure,nil,nil)case.Some(0):completion(PKPa

ymentAuthorizationStatus.InvalidShipping PostalAddress,nil,nil)default:completion(P KPaymentAuthorizationStatus.Success,shi ppingMethods,self.paymentSummaryItem sForShippingMethod(shippingMethods!.fir st!))}}}else{completion(PKPaymentAuthori zationStatus.Failure,nil,nil)}}

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

这篇文章中的所有源码公布在https://https://www.360docs.net/doc/6510593730.html,/jflinter/ApplePayExam ple 。

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

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

（本文为CocoaChina组织翻译，本译文权利归译者所有，未经允许禁止转载。）

ios消息推送