支付宝支付

使用知晓云支付 SDK，需要先在知晓云控制台关联商户账号，以及在 XCode 完成相应配置。

商户账号关联

在知晓云控制台完成商户账号关联，步骤如下图所示：

Xcode 配置

1. 配置支付宝 APPID

在 Xcode 中打开项目，设置项目属性中的 URL Types 为支付宝 APPID。如图所示

2. 设置白名单

在 Xcode 中打开项目，在 info.plist 文件中添加 LSApplicationQueriesSchemes 数组，并在该数组中添加 alipay 字符串。如图所示：

3. 配置返回 url 处理方法

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

适配了 SceneDelegate 的 App，需要重写 openURLContexts 方法：

func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let url = URLContexts.first?.url else {
        return
    }
    _ = BaaS.handleOpenURL(url: url)
}
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
    return [BaaS handleOpenURLWithUrl:url];
}

适配了 SceneDelegate 的 App，需要重写 openURLContexts 方法：

- (void)scene:(UIScene *)scene openURLContexts:(NSSet<UIOpenURLContext *> *)URLContexts {
    UIOpenURLContext *context = [[URLContexts allObjects] objectAtIndex:0];
    NSURL *url = context.URL;
    [BaaS handleOpenURLWithUrl:url];
}

发起支付

当用户选择商品后，发起一笔支付时，需要传入订单价格、订单描述等相关参数。后续如需查询订单状态，可以传入商品 id 等信息，请参照参数说明。

info 该接口只是创建订单，并发起微信支付，不能以支付宝返回的结果作为知晓云 SDK 的支付结果。查询支付结果请查阅 订单查询 章节的 查询订单详情 小节，以该接口返回的订单状态进行后续处理，比如发送商品。 示例代码

let options: [PaymentOptionKey: Any] = [.merchandiseRecordID: "123", .merchandiseSchemaID: "123", .merchandiseSnapshot: ["somekey": "somevalue"]]
Pay.shared.aliPay(totalCost: 0.01, merchandiseDescription: "微信支付", options: options, completion: { (order, error) in

})
NSDictionary *options = @{PaymentOptionKey.merchandiseRecordID: @"123", PaymentOptionKey.merchandiseSchemaID: @"123", PaymentOptionKey.merchandiseSnapshot: @{}};
BaaSPay *pay = [BaaSPay.shared aliPayWithTotalCost:0.01 merchandiseDescription:@"支付宝" options: options completion:^(BaaSOrder * _Nullable order, NSError * _Nullable error) {

}];

参数说明

参数类型必填参数描述

totalCost

Float

Y

支付总额

merchandiseDescription

String

Y

{{platformName}}支付凭证-商品详情的内容

options

[PaymentOptionKey: Any]

N

支付订单参数，参考PaymentOptionKey

info 举例：开发者有一个 Article 表, 里面有免费 / 付费的文章, 当用户对一篇付费文章进行支付时, 则可以将 Article 表的 ID 作为 merchandiseSchemaID, 文章记录的 ID 作为你 merchandiseRecordID 作为支付参数，写进支付订单记录。当用户阅读此付费文章时, 则可以通过 merchandiseSchemaID, merchandiseRecordID 来查询用户是否付费。

支付返回参数说明

名称类型说明

order

Order

订单信息，详见 订单查询

error

NSError

错误信息，参考错误处理和错误码

PaymentOptionKey

支付可选参数

参数类型必填参数描述

merchandiseSchemaID

String

N

商品表 ID，可用于定位用户购买的物品

merchandiseRecordID

String

N

商品记录 ID，可用于定位用户购买的物品

merchandiseSnapshot

[String: Any]

N

根据业务需求自定义的数据

Previous微信支付Next订单查询

Last updated