订单查询

订单查询包括查询订单详情和获取订单列表。

查询订单详情

通过订单的流水号(transactionNo)，来查询该订单的详细信息。通常用于：

1. 查询订单列表中某个订单的详细信息；
2. 用户发起支付，并在微信或支付宝完成支付后，调用该接口获取订单的详细信息。开发者可以根据该订单的状态进行后续操作，比如订单状态(status)为 success 时，给用户发送商品。

• Swift
• Objective-C

let transactionNo = "xxxxxxxxxx"
Pay.shared.order(transactionNo) { (order, error) in

}

NSString *transactionNo = @"xxxxxxxxxx";
[BaaSPay.shared order:transactionNo completion:^(BaaSOrder * _Nullable order, NSError * _Nullable error) {

}];

参数说明

返回结果

订单查询

OrderQuery 继承 Query， 并定义了订单状态、退款状态、支付方式、trade_no、transaction_no、merchandise_record_id、merchandise_schema_id 等 7 种查询条件。

• Swift
• Objective-C

// 1. 创建查询条件
let query = OrderQuery()

// 2. 设置查询条件

// 通过订单状态查询：订单状态为 success
query.status = .success

// 通过订单状态查询：订单状态为 pending
query.status = .pending

// 通过退款状态查询：退款状态为 complete
query.refundStatus = .complete

// 通过退款状态查询：订单状态为 partial
query.refundStatus = .partial

// 通过支付方式查询：支付方式为 weixin
query.gateWayType = .weixin

// 通过支付方式查询：订单状态为 alipay
query.gateWayType = .alipay

// 通过 trade_no 查询
query.tradeNo = "xxxxxxxxxxxxxx"

// 通过 transaction_no 查询
query.transactionNo = "xxxxxxxxxxxxxx"

// 通过 merchandise_record_id 查询
query.merchandiseRecordId = "xxxxxxxxxxxxxx"

// 通过 merchandise_schema_id 查询
query.merchandiseSchemaId = "xxxxxxxxxxxxxx"

// 设置分页
query.limit = 10
query.offset = 0

// 3. 开始查询
Pay.shared.orderList(query: query) { (result, error) in

}

// 1. 创建查询条件
BaaSOrderQuery *query = [[BaaSOrderQuery alloc] init];

// 2. 设置查询条件

// 通过订单状态查询：订单状态为 success
query.status = BaaSOrderStatusSuccess;

// 通过订单状态查询：订单状态为 pending
query.status = BaaSOrderStatusPending;

// 通过退款状态查询：退款状态为 complete
query.status = BaaSRefundStatusComplete;

// 通过订单状态查询：退款状态为 partial
query.status = BaaSRefundStatusPartial;

// 通过支付方式查询：支付方式为  weixin
query.status = BaaSGateWayTypeWeixin;

// 通过支付方式查询：支付方式为 alipay
query.status = BaaSGateWayTypeAlipay;

// 通过 trade_no 查询
query.tradeNo = @"xxxxxxxxxxxxxx";

// 通过 transaction_no 查询
query.transactionNo = @"xxxxxxxxxxxxxx";

// 通过 merchandise_record_id 查询
query.merchandiseRecordId = @"xxxxxxxxxxxxxx";

// 通过 merchandise_schema_id 查询
query.merchandiseSchemaId = @"xxxxxxxxxxxxxx";

// 设置分页
query.limit = 10;
query.offset = 0;

// 3. 开始查询
[BaaSPay.shared orderListWithQuery:query completion:^(BaaSOrderList * _Nullable orders, NSError * _Nullable error) {

}];

参数说明

可以设置的查询条件，有订单状态： OrderStatus、退款状态 RefundStatus、支付类型 GateWayType，详见 数据类型 小节

返回结果

数据类型

Order

订单信息

支付结果返回信息 gatewayExtraInfo 参数说明

gatewayExtraInfo 目前只支持 gateWayType == 'weixin_tenpay'（微信支付）时，返回支付成功后回调的订单详细信息。

gatewayExtraInfo 返回的数据结构如下：

{
    "wechat_response": {
      "appid": "wx3b040d33346exxxx",
      "bank_type": "OTHERS",
      "cash_fee": "1",
      "fee_type": "CNY",
      "is_subscribe": "N",
      "mch_id": "1501889000",
      "nonce_str": "1jFEJyNvEkr2IePMYXOeUEOHP11eXXXX",
      "openid": "om4vu0FZiwoQbTVAt0U-FEzXXXXX",
      "out_trade_no": "1jFEJyxlAuqzAtGcd4uuNxJwMS1TXXXX",
      "result_code": "SUCCESS",
      "return_code": "SUCCESS",
      "sign": "AB329F580E6E342246350DFE96AEXXXX",
      "time_end": "20200320175220",
      "total_fee": "1",
      "trade_type": "JSAPI",
      "transaction_id": "4200000519202003205153312216"
    }
}

wechat_response 中部分关键字段：

具体返回参数详情可参照微信支付结果通知

OrderList

OrderList 表示一次查询数据库所返回的订单列表以及元数据。

订单状态

• Swift
• Objective-C

退款状态

• Swift
• Objective-C

支付方式

• Swift
• Objective-C