LMPay

乐马支付iOS SDK，第三方应用可通过此 SDK 支持乐马支付。了解更多

功能

乐马支付SDK支持以下功能

• 单笔支付
• 批量支付
• 预授权冻结
• 乐贝提现
• 授权登录

SDK支持两种支付交互：

• 安装乐马支付 App 时，自动跳转乐马支付 App 完成支付
• 未安装乐马支付 App 时，在应用中打开 Web 页面完成支付

集成步骤

1. 注册乐马开发者
2. 服务端接入
3. 客户端接入

注册开发者

1. 请 联系乐马支付 服务人员
2. 在乐马支付开发者应用登记页面，进行登记，登记并选择移动应用进行设置
3. 将该应用提交审核，只有审核通过的应用才能进行开发
4. 审核通过后将得到接入的 AppID

服务端接入

参考文档：https://www.showdoc.com.cn/394592199916192

iOS SDK 接入

• iOS客户段接入请参考此文档，下载示例代码
• Android 客户端接入请参考： https://www.showdoc.com.cn/awesomesdk

1. 导入SDK

CocoaPods

在 Podfile 中添加以下内容

use_frameworks!

target 'YourTarget' do
  pod 'LMPay'
end

然后执行 pod install

2. 工程配置

1. 定义 URL Schemes

此 URL Schemes 用于支付完成后跳转回您的应用，您可以自定义值，但必须确保调用支付接口时传入的 urlSchemes 参数和 info.plist 中的定义值一致。

<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleTypeRole</key>
    <string>Editor</string>
    <key>CFBundleURLName</key>
    <string>lmpay</string>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>YourCustomSchemes</string>
    </array>
  </dict>
</array>

2. 添加乐马支付 App 的 URL Schemes 到白名单，在 info.plist 文件中添加以下内容：

<key>LSApplicationQueriesSchemes</key>
<array>
  <string>NewLeMaPayApp</string>
</array>

3. 调用支付接口

LMPay.shareInstance().initForLema(
    withData: payData as Any,
    appType: "order",
    urlSchemes: "YourCustomSchemes",
    netEnvironment: 3,
    sdkLanguage: "zh-cn",
    htmlPush: pushVC,
    isMustH5: false,
    ) { (result: [AnyHashable : Any]) in
    DispatchQueue.main.async {
        print(result)
    }
}

4. 处理 App 支付结果

支持 UIScene（iOS 13+）的应用在 UIWindowSceneDelegate 以下回调中处理支付结果

func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
   guard let url = URLContexts.first?.url else {
      return
   }
   LMPay.shareInstance().handleOpen(url)
}

支持 iOS 13 以下的应用，在 UIApplicationDelegate 以下回调中处理结果

func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
   return LMPay.shareInstance().handleOpen(url)
}

状态码

其他错误信息以 ErrorCompletionBlock 回调返回为准

常见问题

1. 支付完成无法跳回自己的App

   检测是否添加 URL Schemes 中的值是否和 urlSchemes 参数的值相同

2. 未安装 “乐马支付 App” 时，不会弹出 Web 支付页面

   检查 initForLema 方法中 htmlPush 参数的 UIViewController 是否为当前界面，Web 页面将会在 htmlPush push 或 present 显示

3. Web 页面中取消支付或返回时，无法关闭 Web 页面

   关闭 Web 页面需要开发者自己在 errorCompletionBlock 中处理取消或退出的事件，并调用 pop 或 dismiss 退出