37 lines
1.3 KiB
PHP
37 lines
1.3 KiB
PHP
<?php
|
||
|
||
namespace App\Services\Wallet;
|
||
|
||
use App\Models\TransferOrder;
|
||
|
||
/**
|
||
* 调用主站钱包 HTTP 后的统一结果（转入扣主站 / 转出加主站）。
|
||
*/
|
||
final readonly class MainSiteWalletResult
|
||
{
|
||
public function __construct(
|
||
public bool $ok,
|
||
public ?string $externalRefNo,
|
||
/** @var array<string, mixed>|null */
|
||
public ?array $responsePayload,
|
||
/** 发往主站的 JSON 请求体快照，写入 {@see TransferOrder::external_request_payload} */
|
||
public ?array $requestPayload,
|
||
public ?string $errorMessage,
|
||
/**
|
||
* 网络超时/连接类不确定结果：由 {@see HttpMainSiteWalletGateway} 设置，上层将订单标为 pending_reconcile，
|
||
* 不重复扣加款（PRD §6.2 / §6.7）。
|
||
*/
|
||
public bool $uncertain = false,
|
||
) {}
|
||
|
||
public static function success(?string $ref, ?array $payload = null, ?array $requestPayload = null): self
|
||
{
|
||
return new self(true, $ref, $payload, $requestPayload, null, false);
|
||
}
|
||
|
||
public static function failure(string $message, ?array $payload = null, bool $uncertain = false, ?array $requestPayload = null): self
|
||
{
|
||
return new self(false, null, $payload, $requestPayload, $message, $uncertain);
|
||
}
|
||
}
|