# 说明

| 方法名 | 参数 | 返回值 |
| :---: | :---: | :---: |
| find | string/array $order | Collection |

# 使用方法

## 查询普通订单

```PHP
$order = [
    'out_trade_no' => '1514027114',
];

// $order = '1514027114';

$result = $alipay->find($order);
```

## 查询退款订单

> v2.4.0 及以上可用

```PHP
$order = [
    'out_trade_no' => '1514027114',
    'out_request_no' => '1514027114'
];

// v2.7.2 及以下版本请使用
// $result = $alipay->find($order, true);

// v2.7.3 及以上版本请使用
$result = $alipay->find($order, 'refund');
```

## 查询转账订单

> v2.5.2 及以上可用

```PHP
$order = [
    'out_trade_no' => '1514027114',
];

// $order = '1514027114';

// v2.7.2 及以下版本请使用
// $result = $alipay->find($order, false, true);

// v2.7.3 及以上版本请使用
$result = $alipay->find($order, 'transfer');
```

## 订单配置参数

所有订单配置参数和官方无任何差别，兼容所有功能，所有参数请参考[这里](https://docs.open.alipay.com/api_1/alipay.trade.query/)，查看「请求参数」一栏。

# 返回值

返回 Collection 类型，可以通过 `$collection->xxx` 得到服务器返回的数据。

# 异常

* Yansongda\Pay\Exceptions\InvalidGatewayException ，表示使用了除本 SDK 支持的支付网关。
* Yansongda\Pay\Exceptions\InvalidSignException ，表示验签失败。
* Yansongda\Pay\Exceptions\InvalidConfigException ，表示缺少配置参数，如，`ali_public_key`, `private_key` 等。
* Yansongda\Pay\Exceptions\GatewayException ，表示支付宝/微信服务器返回的数据非正常结果，例如，参数错误，对账单不存在等。