Apple Pay编程指南

本文由CocoaChina译者xiaoying、tr培子翻译自苹果官方文档：Apple Pay Programming Guide目录关于Apple Pay配置支付环境创建支付请求授权支付支付处理Part 1关于Apple PayApple Pay是一种移动支付技术，它能够让用户以一种便捷安全的方式为现实世界中购买的商品和服务付款。

关于相关App里的数字商品和服务，请参考In-App Purchase Programming Guide.在Xcode和苹果开发者会员中心中配置Apple Pay使用Apple Pay的APP需要一项特殊的权限，该权限可以在开发者会员中心和Xcode中开启。

你同样需要注册一个商业标示，并设置密钥；在给服务器发送支付信息时，这些密匙可以确保数据的安全传输。

相关章节：配置支付环境（Configuring Your Environment，后面会提到）用户授权支付请求支付请求就是描述当前进行的购买操作，包括支付金额。

你把支付请求发送给一个授权支付的视图控制器；该试图控制器呈现相关请求内容，并提示用户需要输入的信息，例如配送地址或者账单地址。

接着，当用户与视图控制器交互，并提供新的支付信息时，APP会调用支付请求的委托，继续执行支付流程。

相关章节：创建支付请求（Creating a Payment Request），授权支付（Authorizing a Payment）（后面会提到）服务器处理支付请求Apple Pay会对支付信息进行加密处理，以防止未获授权的第三方获取用户的支付信息。

你可以在自己的服务器上完成整个支付流程，也可以在自己的服务器上使用第三方支付平台来解码支付信息，并完成支付处理。

关于支持Apple Pay的支付平台信息，请参考/apple-pay/ 相关章节：处理支付请求（Processing a Payment）Part 2配置支付环境一个商用ID标识可以帮助Apple Pay识别你，让你能够接受付款。

在支付信息加密的过程中，把公匙和证书与ID标示关联起来进行加密是必不可少的一步。

在APP使用Apple Pay之前，你首先得注册一个商用ID，并配置它的相关证书。

注册商用ID标示在开发者会员中心，选择“Certificates，Identifiers&Profiles”在Identifiers下，选择Merchant IDs在右上角点击”+”按钮在Description栏、ID栏输入相应信息，点击”Continue”浏览下配置参数，点击”Register”点击”Done”为你的ID标示配置一个证书在开发者会员中心，选择”Certificates，Identifiers&Profiles”在Identifiers下，选择Merchant IDs选择列表中的ID标示，点击Edit点击”Create Certificate”，按照指示获取或生成签名证书请求（CSR），点击”Continue”点击”Choose File”,选择你的CSR，点击”Generate”点击”Download”下载证书，点击”Done”如果KeyChain Access中显示了警示信息，表示未知授权签发证书或者无效证书发行人，那么要确保你已经在钥匙链中安装了WWDR中级证书-G2和Apple Root CA-G2。

你可以在这个地方下载这些东西：/certificateauthority.为了在Xcode中启用Apple Pay，打开APP工程文件的Capabilities面板。

在Apple Pay这行将开关按钮设置为”ON”，接着选择APP需要使用的ID标示。

注意：在APP排错时，偶尔手动启用Apple Pay很管用。

请按照以下步骤手动启用Apple Pay：在会员中心，选择Certificates，Identifiers& Profiles在Identifiers下，选择App IDs选择列表中的app ID，点击”Edit”选择Apple Pay ，点击”Edit”选择你需要使用的ID标示，点击”Continue”浏览配置参数，点击”Assign”点击”Done”Part 3 创建支付请求创建支付请求支付请求是PKPaymentRequest类的实例，它的组成部分包括一个用来表示将要购买的项目的摘要，一个可用的配送方式列表，一个表示用户需要提供的配送信息的描述，以及一些商家和支付平台的信息。

判定用户是否能够支付在创建支付请求之前，要首先通过调用PKPaymentAuthorizationViewController 类里的canMakePaymentsUsingNetworks:方法来判断用户是否能够使用你提供的支付网络进行支付。

如果要判断用户的硬件是否支持Apple Pay或者是否因为家长控制而不能支付，请使用canMakePayments 方法。

如果用户不能进行支付，那就不要显示支付按钮，相应的应该退回到其它支付方式。

支付请求包含货币和地区信息所有的汇总金额应该使用同一种货币，货币的信息可使用PKPaymentRequest类的currencyCode属性进行指定。

像”USD”这样，使用3个字符格式的ISO货币编码。

一个支付请求里的国家代码表示了这次购买发生的国家或者将要在这个国家处理这次支付。

像”US”这样，使用2个字符格式的ISO国家编码。

在支付请求里指定的商用ID必须匹配应用中指定的商用ID列表之一。

request.currencyCode=@”USD”;request. countryCode=@”US”;request.merchantId entifier=@”.example”;支付请求包含一个支付摘要项目的列表支付摘要项目，属于PKPaymentSummaryItem 类，描述了支付请求的不同部分。

在一个支付请求里不要使用太多的摘要项目---典型的项目像比如小计金额、折扣信息、配送信息、含税信息以及总计金额等。

如果你想要提供更详细的支付项目列表，可以在你应用的其它地方提供。

每一个摘要项目会有一个标签和数额，就像在代码列表3-1中显示的那样。

标签文本是一个用户可阅读的摘要项目描述信息，数额是相对应的支付数额。

在一个支付请求中所有的数额都要使用在这个请求中指定的货币。

对于折扣或优惠券，则需要把数额设成负数。

Listing 3-1创建支付项目//12.75subtotalNSDecimalNumber*subto talAmount=[NSDecimalNumberdecimalNu mberWithMantissa:1275exponent:-2isNeg ative:NO];self.subtotal=[PKPaymentSumm aryItemsummaryItemWithLabel:@”Subtot al”amount:subtotalAmount];//2.00discoun tNSDecimalNumber*discountAmount=[NS DecimalNumberdecimalNumberWithMan tissa:200exponent:-2isNegative:YES];self.d iscount=[PKPaymentSummaryItemsumma ryItemWithLabel:@”Discount”amount:dis countAmount];注意这里使用NSDecimalNumber类来存储摘要项目的数额，它是一个以10为底数的数值。

可以使用指定尾数和指数的方式（像代码中那样）来创建这个类的实例，也可以通过指定字符串和locale来实例化，字符串指定了相应的数值。

这里总是使用以10为底数的数值来做财务计算--例如当需要计算5%折扣掉的金额时。

尽管有时使用其它的计数方法更方便，但是像float或者Double这样的IEEE浮点数类型是不适合作财务计算的，这些数据类型使用的是以2为底数的数值表示方法，这就表示有一些十进制数值不能准确得被表示--例如0.42必须以0.41999这样的循环小数来近似表示，而这种近似表示常常会造成财务计算的错误结果。

在这个摘要项目列表中的最后一个是总计金额。

这个金额是通过把所有其它金额相加而得到。

总计的显示方法和其它的摘要项目不同：应该使用你公司的名称做为其标签，使用所有其它项目的金额总和做为金额。

使用paymentSummaryItems 属性将这些摘要项目加入支付请求。

//10.75grandtotalNSDecimalNumber*tot alAmount=[NSDecimalNumberzero];totalA mount=[totalAmountdecimalNumberByAd ding:subtotalAmount];totalAmount=[total AmountdecimalNumberByAdding:discountAmount];self.total=[PKPaymentSummaryI temsummaryItemWithLabel:@”MyCompa nyName”amount:totalAmount];self.summ aryItems=@[self.subtotal,self.discount,self .total];request.paymentSummaryItems=se lf.summaryItems;配送方式是一种特殊的摘要项目对于每一种可用的配送方式创建一个PKShippingMethod的实例。

就像其它支付摘要项目一样，配送方式包含用户易于辨别的标签，比如”标准配送”或者”第二天配送”，还有一个金额来表示配送费用。

与其它摘要项目不同的是，配送方式还有一个detail属性--像”7月29日到达”或者”24小时之内配送”等--可以用来解释各个配送方式之间的区别。

使用identifier属性来在代理方法中区分不同的配送方式，这个属性只会在你的应用内使用--框架看不到这个属性，并且它也不会出现在UI中。

在创建配送方式时为其分配一个独一无二的标识符。

为了方便调试，可使用文本缩写，比如”discount”, “standard”, 或者“next-day”.有一些配送方式在某些地区可能不适用，或者有不同的价格，你可以在用户选择配送地址或配送方式的代理方法时更新这些信息，就像Your Delegate Updates Shipping Methods and Costs描述的一样。

指定你支持的支付方式通过在supportedNetworks属性中填入字符串常量数组来指定你支持的支付网络。

通过指定merchantCapabilities属性来指定你支持的支付处理标准，3DS支付方式是必须支持的，EMV方式是可选的。