SwedbankPaySDKMerchantBackend 4.0.5

SwedbankPaySDKMerchantBackend 4.0.5

×

由 Swedbank Pay SDK for iOS 维护。

 
依赖于
SwedbankPaySDK= 4.0.5
Alamofire~> 5.5
 

SwedbankPaySDKMerchantBackend 4.0.5

  • 由
  • Swedbank Pay

Swedbank Pay SDK for iOS

Swedbank Pay SDK for iOS

Tests Cocoapods Cocoapods platforms CLA assistant License Contributor Covenant

Swedbank Pay iOS SDK 便于在 iOS 应用程序中实现 Swedbank Pay API 平台。

安装

SDK 包含两个组件，分别是 SwedbankPaySDK 和 SwedbankPaySDKMerchantBackend。第一个组件是核心 SDK，而第二个组件包含与实现 商户后端 API 的服务器进行交互的实用工具。

如果您不在后端通信中使用商户后端 API，您只需要使用 SwedbankPaySDK 组件。否则，您应该将这两个组件都添加到您的项目中。

Swift Package Manager

SDK 通过 Swift Package Manager 提供。这是将 SDK 添加到 Xcode 项目的最简单方法。

请遵循以下说明 此处 添加 SwiftPM 依赖项。使用 https://github.com/SwedbankPay/swedbank-pay-sdk-ios.git 作为存储库 URL。根据您的用例选择仅使用 SwedbankPaySDK 库或两个库。

CocoaPods

SDK 也可以通过 CocoaPods 获取。这两个组件提供了独立的库，分别为 SwedbankPaySDK 和 SwedbankPaySDKMerchantBackend。

在你的 Podfile 中添加相关依赖。

pod 'SwedbankPaySDK', '~> 3.0'
pod 'SwedbankPaySDKMerchantBackend', '~> 3.0'

使用说明

请访问 开发者门户 以获取使用说明。

要探索一个使用 SDK 的应用的示例，请查看 示例项目。

要将 API 文档导入 Xcode，在文档窗口中浏览类型和函数，请双击文档文件夹中的任意一个 .doccarchive 文件。如果使用的是 BackendMerchant，请选择 SwedbankPaySDK+MerchantDocumentation 完整集，否则选择其他。

操作指南/集成到现有应用中

要开始处理支付，你需要以下四样东西

  1. 一个 SwedbankPaySDKConfiguration 对象，描述如何与你的后端进行通信。为了快速开始，提供了一个默认实现，名为 MerchantBackendConfiguration。
  2. 一个支付订单，描述要购买的内容、价格、货币等信息。
  3. 将这个支付订单给你创建的 SwedbankPaySDKController 的实例，并在视图层次中展示它。
  4. 实现 SwedbankPaySDKDelegate 回调并等待支付成功或失败。

我们并未空谈，还提供了一个示例应用，详细介绍如何进行集成。在构建自己的解决方案时，请以此为例进行参考。

iOS 示例应用

1. SwedbankPaySDKConfiguration细节

使用MerchantBackendConfiguration，您只需要提供您后端的URL，以及api密钥和访问令牌的header值。参考示例应用程序中的配置变量PaymentViewModel.swift中的代码

然后SDK会与您的后端进行通信，期望与我们的示例后端相同的API。您不需要提供所有的API，仅提供支付所需的/paymentorders即可，但很快您将想要支持/tokens和/patch。要开始，您可以查看我们的后端示例实现，它提供了一套完整的功能，并以非常清晰易懂的方式描述了如何处理请求。

使用商户示例后端，您可以设置（例如）Node.js后端，并在应用集成时以debug模式提供客户端服务。请记住，为了使请求正常工作，应在appconfig.json文件中提供您的api密钥和其他值。

2. PaymentOrder细节

在PaymentViewModel.swift中有一个paymentOrder属性，它描述了如何创建。PaymentOrders具有默认值，可以仅提供客户想要购买的内容的值，或者用于访问高级功能。

3. 显示支付菜单

最后一步是创建SwedbankPaySDKController的一个实例，并向用户显示它。在示例应用程序中，我们将其作为子视图控制器添加，但也可以以其他方式管理，请参阅PaymentViewController.swift以获取详细信息。

4. SwedbankPaySDKDelegate

委托模式在iOS社区中广为人知且应用广泛。实现您感兴趣的委托回调以获取购买状态的通知。通常，您至少需要知道支付成功、已取消或失败的情况，还有一些其他可用于您的回调。请参阅SwedbankPaySDKDelegate 协议或示例应用程序实现以获取更多详细信息。

集成结论

这就是您开始接收支付所需的一切。下一步是让您的客户保存卡 details，或在订阅或稍后进行收费的购买令牌中创建购买令牌。具体取决于您的特定案例。

继续阅读只支付令牌遍历或企业令牌遍历以继续对支付令牌的讨论。这些特性在 swedbank pay 开发者门户的“可选特性”部分有很好的记录。

有关如何操作 SDK 和设置必要的回调的更多详细说明，请参阅SwedbankPay SDK 文档。

贡献

Bug报告和Pull请求可以在GitHub上欢迎。该项目旨在成为合作的安全、欢迎的空间，贡献者应遵守行为准则并签署贡献者许可协议。

许可证

本仓库中的代码在Apache 2.0许可证和贡献者许可协议下可作为开源代码提供。