> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kyrenpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# api.php order query and refund compatibility

> Use Epay-compatible api.php order query and understand refund compatibility behavior.

`/epay/api.php` provides Epay-compatible operational actions. Use `act=order` to query migrated Epay-style orders. `act=refund` is currently unsupported and returns a compatibility error; refunds are handled separately with platform assistance.

## Order query

Call `GET` or `POST` `/epay/api.php?act=order` with `pid`, raw merchant `key`, and one of `out_trade_no` or `trade_no`.

This endpoint uses the raw merchant `key` with `pid` for compatibility order query. It may be subject to the API IP allowlist when enabled.

```bash theme={null}
curl "https://api.kyren.top/epay/api.php?act=order&pid=10001&key=merchant_secret&out_trade_no=ORDER_10002"
```

Example success response:

```json theme={null}
{
  "code": 1,
  "msg": "查询订单号成功！",
  "trade_no": "K202605260001",
  "out_trade_no": "ORDER_10002",
  "type": "alipay",
  "pid": "10001",
  "addtime": "2026-05-26 10:30:00",
  "endtime": "2026-05-26 10:31:12",
  "name": "AI credits",
  "money": "9.99",
  "status": 1,
  "param": "account_123",
  "buyer": ""
}
```

`addtime` and `endtime` are Epay-compatible datetime strings when exposed by this compatibility query.

Example failure response:

```json theme={null}
{
  "code": 0,
  "msg": "order not found"
}
```

## Refund compatibility

`GET` or `POST` `/epay/api.php?act=refund` is currently unsupported and returns a compatibility error. Do not build automated refund logic against this path. Coordinate refund handling separately with Kyren platform assistance.

Example response:

```json theme={null}
{
  "code": 0,
  "msg": "refund compatibility endpoint is currently unsupported"
}
```

See the [`api.php` API reference](/api-reference/epay-compatibility/apiphp-order-queryrefund-compatibility-endpoint).