快速

使用QuickStream通过创建一个使用QuickStream REST API的“付款请求”按钮.

安全

每笔付款都通过Touch ID、Face ID或密码进行安全认证。

无缝

为您的客户提供一键支付体验，而无需手动输入信用卡或发货详细信息。

入门

要接受Apple Pay作为QuickStream中的支付方式，您必须与QuickStream REST API并注册您希望接受Apple Pay付款的每个域。请遵循以下步骤：

1. 登录QuickStream以配置Apple Pay.
2. 按照说明注册域并下载域验证文件。
3. 与集成QuickStream REST API并创建一个付款请求按钮.
4. 使用REST API创建付款通过提供单一使用令牌ID由付款请求按钮模块返回。

查看技术指南

报告

使用这些方法查找通过QuickStream进行的Apple Pay交易：

• 你可以在QuickStream门户网站中查找Apple Pay交易.
• 使用事务API查找Apple Pay交易。
• 下载CSV报告包含Apple Pay交易，使用QuickStream门户和REST API.
• 如果您已经申请了BankRec，您可以将QuickStream链接到银行收款自动对每笔付款进行深入的银行对账单对账。

退款

使用退款Apple Pay交易QuickStream门户和REST API.

超载

附加费的工作原理与普通卡支付相同。Apple Pay凭证（即DPAN或FPAN）被发送到QuickStream，QuickStream根据可在QuickStream门户.

阅读更多关于超载.

结算和响应代码

• 交易处理和结算用于卡片。
• 交易响应代码用于卡片。

支持的浏览器

支持Apple Pay与“付款请求”按钮兼容的浏览器和设备.

使用QuickStream REST API的Apple Pay

我们的QuickStream REST API允许您创建使用QuickStream-API.js付款表单中的付款请求按钮.

入门

本页介绍如何将Apple Pay添加到现有QuickStream REST API集成中。如果您尚未完成此集成，请参阅我们的API参考和QuickStream-API.js库参考。

开始Apple Pay集成之前：

1. 确保您已收到可发布和机密REST APIQuickStream REST API的密钥。
2. 注册您将接受Apple Pay付款的每个域并遵循说明。
3. 创建一个要添加Apple Pay按钮的付款表单。您的付款表单是一个网页，当客户选择付款方式时，您将向他们显示。
4. 通过HTTPS为应用程序提供服务。这是测试和生产环境所必需的。您可以使用以下服务南韩这样做。
5. 设置后端实施以使用事务API.

如何在您的支付表单中实施Apple Pay

1. 添加QuickStream-API.js图书馆到您的付款表。

   <脚本 类型=“文本/javascript” 型钢混凝土="https://api.quickstream.westpac.com.au/rest/v1/quickstreem-api-1.0.min.js"></脚本>

2. 将付款请求按钮容器添加到您的付款表单中，该表单将在支持的Apple设备上下拉Apple Pay按钮。

   <div公司 data-quickstream-api=“paymentRequestButtonContainer”></div公司>

3. 初始化QuickStream-API.js使用QuickStream设施的可发布API密钥。

   快速流API.初始化( {可发布ApiKey:“PUBLISHABLE_API_KEY”} );

4. 创建PaymentRequestConfig对象为您的客户。

   无功功率，无功功率配置={供应商业务代码:“供应商代码”,//这是必需的
    详细信息: {全部的: {标签:“您的公司名称”,数量: {价值:"10.00",货币:“澳元”}}}};

5. 创建付款请求按钮使用PaymentRequestConfig对象.

   处理错误或检索单一使用令牌ID属性付款请求响应对象.

   快速流API.付款请求按钮.创建按钮（配置，功能(错误，paymentResponse) {如果（错误）{//在此处处理错误}其他的{慰问.日志(“singleUseTokenId为”+付款响应。单一使用令牌ID);//在您的服务器上执行付款，然后在下面呼叫。付款响应。完成(“成功”);}});

接受付款

1. 在获得单一使用令牌ID将此传递给服务器。

2. 从服务器请求邮政 /v1/交易使用Secret REST API密钥，指定：

   • 单一使用令牌ID：该paymentResponse.singleUseTokenId来自创建按钮功能。

   邮政 / HTTP/1.1协议
   主机:https://api.quickstream.westpac.com.au/rest/v1/交易授权:基本A8d8sdk938垫木7=Idempotency键:a8f4bd70-5435-11ea-8d77-2e728ce88125内容类型:应用程序/json{
       “交易类型” : “付款”,
       “singleUseTokenId”: “dec2075f-da92-49df-8a92-f7e494f89c22”,
       “供应商业务代码”: “供应商代码”,
       “本金金额”: 10,
       “货币” : “澳元”,
       “eci”: “互联网”,
       “ipAddress” : "192.168.1.1"
   }

   请参见使用单个use-token处理事务了解更多信息。

   响应包含付款结果。

（可选）超载

附加费的工作原理与普通卡支付相同。Apple Pay凭证（DPAN）会发送到QuickStream，QuickStream会根据您的卡组织附加费配置.

QuickStream在用户批准付款单之前不知道该卡，这意味着它在批准之前无法计算并向用户显示总金额。

默认情况下，Apple Pay的付款单将显示<供应商企业名称>（可能会增加附加费）为供应商业务配置附加费时。

您可以更改此标签以在以下过程中显示任何内容：

• 付款单的初始化
• onShippingAddressChange事件
• onShippingOptionChange事件

请参阅详细信息.total.label属性。

如果要显示附加费金额，您可以使用多个行项目。

（可选）多行项目

您可以提供details.displayItems（详细信息。显示项目）属性，它是金额行项目的数组。

如果您已将所有卡方案配置为具有相同的附加费金额，则可以在流程中比平时更早地计算并提供附加费值。

详细信息: {显示项目：[{标签:“服务1”,金额：{货币：“澳元”，值：“6.00”}},{标签:“服务2”,金额：{货币：“澳元”，值："4.00"}},{标签:“附加费”,金额：{货币：“澳元”，值："1.00"}}],总计：{标签:“总金额”,金额：{货币：“澳元”，值：“11.00”}}}

展示结果

使用地位您在交易响应中收到的通过使用付款请求响应对象 完成功能。

快速流API.付款请求按钮.创建按钮（配置，功能(错误，paymentResponse) {如果（个错误）{//在此处处理错误}其他的{//提供成功或失败的结果给客户付款响应。完成(“成功”);}});

使用QuickStream测试Apple Pay

QuickStream测试环境链接到Apple Pay测试环境。您可以使用Apple Pay沙盒测试第页。

• 您需要一个Apple帐户用于Apple Pay沙盒测试使用测试卡。Apple钱包中的真实卡将不起作用。Apple Pay付款单在到达QuickStream的服务器之前将被拒绝。
• 注册您将接受Apple Pay付款的每个域。您不需要在测试中托管域验证文件。

请参阅：

• QuickStream REST API参考用于测试、重复支付和错误处理要求。
• 苹果支付营销指南.
• Apple Pay人机界面指南.

上线

一旦准备好上线，您必须：

1. 创建一个Apple帐户为您的Apple钱包添加实卡。您不能在生产中使用测试卡。
2. 登录QuickStream并注册您将接受Apple Pay付款的每个域并按照说明使用Apple Pay验证您的域名。
3. 在生产环境中完成与QuickStream REST API的集成。

另请参见

• 苹果支付营销指南.
• 应用程序和Web测试卡.
• Apple Pay人机界面指南.
• Apple Pay with Westpac公司.