# 支付宝支付

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

## 商户账号关联

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

![账号关联](https://3271136903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LVIIQcUXqNvyHRGzhur%2Fuploads%2Fgit-blob-f99e27781bb25107c17f9c2b280c7df3cf4712ed%2Falipay_account.png?alt=media)

## Xcode 配置

### 1. 配置支付宝 `APPID`

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

![设置 URLTYPE](https://3271136903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LVIIQcUXqNvyHRGzhur%2Fuploads%2Fgit-blob-3a7328a9d2d3e85a727274c6afbfa3faab2f96f7%2Falipay_scheme.png?alt=media)

### 2. 设置白名单

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

![设置白名单](https://3271136903-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LVIIQcUXqNvyHRGzhur%2Fuploads%2Fgit-blob-45550646d0afb663baa6f403dff69c70019cd140%2Fquery_scheme.png?alt=media)

### 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` 的支付结果。查询支付结果请查阅 [订单查询](https://ifanr.gitbook.io/baas-js-sdk/ios-sdk/payment/order) 章节的 **查询订单详情** 小节，以该接口返回的订单状态进行后续处理，比如发送商品。 **示例代码**

```
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](#PaymentOptionKey) |

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

**支付返回参数说明**

| 名称    | 类型      | 说明                                                                         |
| ----- | ------- | -------------------------------------------------------------------------- |
| order | Order   | 订单信息，详见 [订单查询](https://ifanr.gitbook.io/baas-js-sdk/ios-sdk/payment/order) |
| error | NSError | 错误信息，参考[错误处理和错误码](https://ifanr.gitbook.io/baas-js-sdk/ios-sdk/error-code) |

### PaymentOptionKey

支付可选参数

| 参数                  | 类型             | 必填 | 参数描述                 |
| ------------------- | -------------- | -- | -------------------- |
| merchandiseSchemaID | String         | N  | 商品表 ID，可用于定位用户购买的物品  |
| merchandiseRecordID | String         | N  | 商品记录 ID，可用于定位用户购买的物品 |
| merchandiseSnapshot | \[String: Any] | N  | 根据业务需求自定义的数据         |