支付宝支付
使用知晓云支付 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
等信息,请参照参数说明。
该接口只是创建订单,并发起微信支付,不能以支付宝返回的结果作为知晓云 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 | 支付凭证-商品详情的内容 |
options | [PaymentOptionKey: Any] | N | 支付订单参数,参考PaymentOptionKey |
举例:开发者有一个 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 | 根据业务需求自定义的数据 |