订单查询

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

查询订单详情

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

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

{% tabs swift1=”Swift”, oc1=”Objective-C” %} {% content “swift1” %}

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

{% content “oc1” %}

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

{% endtabs %}

参数说明

返回结果

订单查询

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

{% tabs swift2=”Swift”, oc2=”Objective-C” %} {% content “swift2” %}

// 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
}

{% content “oc2” %}

// 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) {
}];

{% endtabs %}

参数说明

可以设置的查询条件，有订单状态： 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 表示一次查询数据库所返回的订单列表以及元数据。

订单状态

{% tabs swift4=”Swift”, oc4=”Objective-C” %} {% content “swift4” %}

OrderStatus

{% content “oc4” %}

BaaSOrderStatus

{% endtabs %}

退款状态

{% tabs swift5=”Swift”, oc5=”Objective-C” %} {% content “swift5” %}

RefundStatus

{% content “oc5” %}

BaaSRefundStatus

{% endtabs %}

支付方式

{% tabs swift6=”Swift”, oc6=”Objective-C” %} {% content “swift6” %}

GateWayType

{% content “oc6” %}

BaaSGateWayType

{% endtabs %}