Apple 查询

WARNING

Apple 的实现由 AI 生成并经人工审核，但由于测试资源限制，尚未经过实际测试，请在充分验证后再用于生产环境。

方法名	参数	返回值
query	array $order	Collection

query 通过 _action 参数支持三种查询：

_action	说明	端点
transaction（默认）	单笔交易	GET /inApps/v1/transactions/
history	交易历史	GET /inApps/v2/history/
subscriptions	订阅状态	GET /inApps/v1/subscriptions/{anyTransactionId}?status=1&status=4

单笔交易

Pay::config($this->config);

$result = Pay::apple()->query([
    'transaction_id' => '1234567890',
]);

交易历史

Pay::config($this->config);

$result = Pay::apple()->query([
    'transaction_id' => '1234567890',
    '_action' => 'history',
]);

订阅状态

Pay::config($this->config);

$result = Pay::apple()->query([
    'transaction_id' => '1234567890',
    '_action' => 'subscriptions',
]);

默认查询 status=1&status=4（活跃 + 账单宽限期，与官方文档示例一致）。可通过 _status 覆盖，支持 SubscriptionStatus 枚举或 1-5 的整数：

use Yansongda\Pay\Enum\Apple\SubscriptionStatus;

$result = Pay::apple()->query([
    'transaction_id' => '1234567890',
    '_action' => 'subscriptions',
    // ACTIVE=1 活跃、EXPIRED=2 已过期、BILLING_RETRY=3 账单重试、BILLING_GRACE_PERIOD=4 账单宽限期、REVOKED=5 已撤销
    '_status' => [SubscriptionStatus::ACTIVE, SubscriptionStatus::EXPIRED],
]);

也可直接传整数：

$result = Pay::apple()->query([
    'transaction_id' => '1234567890',
    '_action' => 'subscriptions',
    '_status' => [1, 2],
]);