bSecure iOS SDK

bSecure是一种专为巴基斯坦市场打造的通用结账系统，易于在任意iOS应用中安装。它为您提供了一键结账和接受多种支付方式的功能，同时让您的业务运营无忧。只需遵循几个简单的步骤，您就能迅速启动运行。其他事宜交给我们处理。我们将代表您处理登录、地址、配送方式和支付等问题。您只需在bSecure合作伙伴门户上配置一次结账设置即可。

要求

bSecure iOS SDK需要Xcode 11.0及更高版本，并支持Swift 5或更高版本，与目标iOS 11或以上版本的应用兼容。

先决条件

• 请确保在您的app的info.plist文件中添加《隐私-在使用时访问位置的使用描述》以及《隐私-始终和使用时访问位置的使用描述》。
• 您还需要Google地图密钥，以便使用地址功能。

使用方法

配置设置

按照几个简单的步骤，您可以设置您的 bSecure Checkout 和 单点登录。

1. 访问 合作伙伴门户
2. 应用集成 >> 沙箱 / 正式环境
3. 选择环境类型（自定义集成）
4. 填写以下字段
   a. 商店URL 任何情况下都需要
   b. 登录重定向URL 需要用于功能 bSecure 登录
   c. 结账重定向URL 需要用于功能 bSecure 付款
   d. 结账订单状态webhook 需要用于功能 bSecure 付款
5. 保存您的客户端凭据（客户端ID和客户端密钥）
6. 请确保在您的代码中将凭据保存在安全的地方

bSecure Checkout

1. 在您的 podfile 中添加 pod 'BSecureCheckout' 并运行 pod install。
2. 一旦用户准备结账（点击带有 bSecure 的结账按钮），调用您的自定义集成 bSecure 创建订单 API 请求。
3. 在这个 API 响应中，您将获得所需的 order_reference 号码以启动 SDK。
4. 一旦您获得了订单参考号码，您可以调用 BSecureManager.shared.initialize(viewController: UIViewController, googleMapKey: String, orderRef: String, delegate: BSecureCheckout.BSecureManagerDelegate)

• UIViewController - 确保您在 UIViewController 上调用此函数，而不是其他如 UINavigation 或 Tabbar Controller。其他所有者将不允许 SDK 启动，因为其具有 precondition。
• googleMapKey - 输入您从 Google Console 获得的 Google 地图密钥。
• orderRef - 这是当您在 bSecure 服务器上点击创建订单时获得的订单参考字符串。
• BSecureCheckout.BSecureManagerDelegate - 证实此代理，以捕获 SDK 打开和关闭的情况，以及监控任何突然崩溃或错误。

bSecure Checkout 付款后

支付成功后，如果您需要查看订单详情，可以调用自定义集成bSecure订单详情API。