订单查询

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

查询订单详情

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

• 查询订单列表中某个订单的详细信息；
• 用户发起支付，并在微信或支付宝完成支付后，调用该接口获取订单的详细信息。开发者可以根据该订单的状态进行后续操作，比如订单状态(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

订单信息

OrderList

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

订单状态

• Swift
• Objective-C

OrderStatus

BaaSOrderStatus

退款状态

• Swift
• Objective-C

RefundStatus

BaaSRefundStatus

支付方式

• Swift
• Objective-C

GateWayType

BaaSGateWayType