566 lines
29 KiB
PHP
566 lines
29 KiB
PHP
<?php
|
||
/** Forward-only affiliate commission ledger. */
|
||
namespace AKSRT\Payment;
|
||
|
||
defined('ABSPATH') || exit;
|
||
|
||
final class CommissionLedger {
|
||
private static ?self $instance = null;
|
||
public static function get_instance(): self { return self::$instance ??= new self(); }
|
||
private function __construct() {}
|
||
public function init(): void {
|
||
add_action('rest_api_init', [$this, 'register_routes']);
|
||
add_action('aksrt_order_commission', [$this, 'record_order_transition']);
|
||
// 佣金已改为即时入账，历史遗留的结算 cron 需主动清理（无兼容层）。
|
||
$timestamp = wp_next_scheduled('aksrt_affiliate_settle_due');
|
||
if ($timestamp) {
|
||
wp_unschedule_event($timestamp, 'aksrt_affiliate_settle_due');
|
||
}
|
||
}
|
||
private function table(string $name): string { return \AKSRT\Core\DBMigrator::table($name); }
|
||
public function record_order_transition(string $order_number, string $status, array $order = []) {
|
||
if ($status !== Order::STATUS_PAID) {
|
||
return true;
|
||
}
|
||
$result = $this->record_paid_order(array_merge($order, [
|
||
'order_number' => $order_number,
|
||
'status' => $status,
|
||
]));
|
||
return $result >= 0
|
||
? true
|
||
: new \WP_Error('aksrt_commission_write_failed', __('返佣记录写入失败', 'aksrt'), ['status' => 500]);
|
||
}
|
||
public function record_points_exchange(int $user_id, string $amount, int $points, string $operation_key, string $order_number): bool {
|
||
$result = $this->record_paid_order([
|
||
'order_number' => $order_number,
|
||
'product_type' => 'credits',
|
||
'user_id' => $user_id,
|
||
'amount' => $amount,
|
||
'exchange_ref' => $operation_key,
|
||
'points' => $points,
|
||
]);
|
||
return $result >= 0;
|
||
}
|
||
public function record_paid_order(array $order): int {
|
||
$currency = sanitize_key((string) ($order['currency'] ?? ''));
|
||
if ($currency === \AKSRT\Ledger\AssetType::POINTS->value) return 0;
|
||
if (!\AKSRT\Settings\Settings::affiliate_enabled()) return 0;
|
||
$type = sanitize_key((string) ($order['product_type'] ?? ''));
|
||
$map = [
|
||
'vip' => 'membership',
|
||
'resource' => 'content',
|
||
'reading' => 'content',
|
||
'download' => 'content',
|
||
'image' => 'content',
|
||
'video' => 'content',
|
||
];
|
||
$order_type = $map[$type] ?? $type;
|
||
$settings = \AKSRT\Settings\Settings::get_affiliate_settings();
|
||
$order_no = sanitize_text_field((string) ($order['order_number'] ?? ''));
|
||
$buyer = (int) ($order['user_id'] ?? 0);
|
||
try {
|
||
$amount = \AKSRT\Ledger\AssetAmount::balance(is_string($order['amount'] ?? null) ? $order['amount'] : '');
|
||
} catch (\InvalidArgumentException $e) {
|
||
return -1;
|
||
}
|
||
if ($order_no === '' || $buyer <= 0 || $amount->minor() <= 0) return 0;
|
||
$promoter = ReferralAttribution::get_instance()->resolve($buyer);
|
||
// 自我返佣（参考主题「自己推广自己」，购买时归因）：无外部推广人且开关开启时，
|
||
// 买家用自己的（有效）推广码即成为自身推广人。resolve() 结构上永不返回自身，
|
||
// 故这里显式补齐，且要求买家推广码有效以复用「禁用即停返佣」的口径。
|
||
if ($promoter <= 0
|
||
&& !empty($settings['self_rebate'])
|
||
&& ReferralAttribution::get_instance()->is_promoter_code_active($buyer)) {
|
||
$promoter = $buyer;
|
||
}
|
||
if ($promoter <= 0) return 0;
|
||
// 开关开启时，推广者的推广码已被禁用（或缺失）则不再产生新佣金。
|
||
if (!empty($settings['disabled_code_stops_commission'])
|
||
&& !ReferralAttribution::get_instance()->is_promoter_code_active($promoter)) {
|
||
return 0;
|
||
}
|
||
// 返佣订单类型按推广者会员等级分档（参考主题：每档独立勾选）。
|
||
$promoter_level = function_exists('aksrt_get_user_vip_level') ? (int) aksrt_get_user_vip_level($promoter) : 0;
|
||
if (!in_array($order_type, \AKSRT\Settings\PaymentRuntime::affiliate_order_types_for_level($promoter_level), true)) return 0;
|
||
$ratio = \AKSRT\Settings\PaymentRuntime::affiliate_ratio_for_user($promoter);
|
||
$commission_minor = \AKSRT\Ledger\AssetAmount::percentage($amount->minor(), $ratio);
|
||
if ($commission_minor <= 0) return 0;
|
||
$commission = \AKSRT\Ledger\AssetAmount::commission_from_minor($commission_minor)->decimal();
|
||
global $wpdb;
|
||
$table = $this->table('commission_ledger');
|
||
$identity = $order_type === 'credits' && !empty($order['exchange_ref'])
|
||
? 'credits:' . sanitize_key((string) $order['exchange_ref'])
|
||
: $order_no . ':' . $order_type;
|
||
$key = hash('sha256', 'affiliate:' . $identity);
|
||
$now = current_time('mysql', true);
|
||
// 佣金明细账先落库（status=credited），作为入账溯源；随后把佣金即时
|
||
// credit 到 COMMISSION 资金池（先抵扣欠款）。两步分别幂等。
|
||
$ok = $wpdb->insert($table, ['promoter_id'=>$promoter,'source_user_id'=>$buyer,'order_number'=>$order_no,'order_type'=>$order_type,'eligible_base'=>$amount->decimal(),'ratio'=>$ratio,'original_amount'=>$commission,'adjustment_total'=>'0.00','status'=>'credited','idempotency_key'=>$key,'created_at'=>$now], ['%d','%d','%s','%s','%s','%d','%s','%s','%s','%s','%s']);
|
||
if ($ok) {
|
||
$ledger_id = (int) $wpdb->insert_id;
|
||
$this->credit_commission($promoter, $commission_minor, $ledger_id, $order_no);
|
||
return $ledger_id;
|
||
}
|
||
$existing = $wpdb->get_row($wpdb->prepare("SELECT * FROM {$table} WHERE idempotency_key=%s", $key), ARRAY_A);
|
||
if (!is_array($existing)
|
||
|| (int) $existing['promoter_id'] !== $promoter
|
||
|| (int) $existing['source_user_id'] !== $buyer
|
||
|| (string) $existing['order_number'] !== $order_no
|
||
|| (string) $existing['order_type'] !== $order_type
|
||
|| (string) $existing['eligible_base'] !== $amount->decimal()
|
||
|| (int) $existing['ratio'] !== $ratio
|
||
|| (string) $existing['original_amount'] !== $commission
|
||
) {
|
||
return -1;
|
||
}
|
||
// 明细行已存在（订单支付回调重放）：入账用确定性 operation_key 幂等，安全重放。
|
||
$this->credit_commission($promoter, $commission_minor, (int) $existing['id'], $order_no);
|
||
return (int) $existing['id'];
|
||
}
|
||
|
||
/**
|
||
* 佣金即时入账：全额 credit 到 COMMISSION 资金池，再机会性偿还历史欠款。
|
||
*
|
||
* 两段式而非「净额入池」，是为了金额守恒可证：
|
||
* 1) 入池分录金额固定 = 佣金全额，operation_key 由明细行 id 派生，天然幂等/防重放。
|
||
* 2) 偿债在独立账务事务里做：池扣减 min(欠款, 池余额) 且欠款同额递减，两者在同一
|
||
* 事务内以锁定值为准，等额增减 → 永不凭空增减钱；并发导致失败则本次跳过，
|
||
* 欠款留到下一笔佣金再偿，绝不出错。
|
||
*/
|
||
private function credit_commission(int $promoter, int $commission_minor, int $ledger_id, string $order_no): void {
|
||
if ($promoter <= 0 || $commission_minor <= 0) {
|
||
return;
|
||
}
|
||
$credit = \AKSRT\Ledger\LedgerService::get_instance()->credit(
|
||
$promoter, \AKSRT\Ledger\AssetType::COMMISSION, $commission_minor,
|
||
\AKSRT\Ledger\OperationKey::deterministic('commission-credit', [$ledger_id]),
|
||
'affiliate_commission',
|
||
['type' => 'commission', 'id' => $ledger_id],
|
||
sprintf(__('推广佣金入账（订单 %s）', 'aksrt'), $order_no)
|
||
);
|
||
if (!is_wp_error($credit)) {
|
||
$this->repay_debt_from_pool($promoter);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 机会性偿债：从 COMMISSION 池扣减 min(欠款, 池余额)，欠款同额递减，单个账务事务内原子完成。
|
||
* 偿债额 ≤ 池余额 → 扣减不会透支；扣减额 == 欠款递减额 → 金额守恒。并发/余额不足则本次跳过。
|
||
*/
|
||
private function repay_debt_from_pool(int $promoter): void {
|
||
if ($promoter <= 0) {
|
||
return;
|
||
}
|
||
global $wpdb;
|
||
$debt_table = $this->table('commission_debt');
|
||
$debt = (int) $wpdb->get_var($wpdb->prepare("SELECT debt_minor FROM {$debt_table} WHERE user_id=%d", $promoter));
|
||
if ($debt <= 0) {
|
||
return;
|
||
}
|
||
$pool = \AKSRT\Ledger\LedgerService::get_instance()->balance($promoter, \AKSRT\Ledger\AssetType::COMMISSION);
|
||
$repay = max(0, min($debt, $pool));
|
||
if ($repay <= 0) {
|
||
return;
|
||
}
|
||
// guard 内锁定欠款行复核：并发偿债已把欠款降到不足 repay，则可重试/跳过。
|
||
$guard = function () use ($debt_table, $promoter, $repay) {
|
||
global $wpdb;
|
||
$locked = (int) $wpdb->get_var($wpdb->prepare("SELECT debt_minor FROM {$debt_table} WHERE user_id=%d FOR UPDATE", $promoter));
|
||
return $locked >= $repay ? true : new \WP_Error('aksrt_commission_debt', __('佣金欠款已变化', 'aksrt'), ['status' => 409]);
|
||
};
|
||
$mutation = function () use ($debt_table, $promoter, $repay) {
|
||
global $wpdb;
|
||
return $wpdb->query($wpdb->prepare(
|
||
"UPDATE {$debt_table} SET debt_minor = debt_minor - %d, updated_at = %s WHERE user_id=%d AND debt_minor >= %d",
|
||
$repay, current_time('mysql', true), $promoter, $repay
|
||
)) === 1 ? true : new \WP_Error('aksrt_commission_debt', __('佣金欠款抵扣失败', 'aksrt'), ['status' => 409]);
|
||
};
|
||
// 偿债是机会性动作、由锁定的 debt_minor>=repay 保证不重复扣减，无需跨调用幂等；
|
||
// 故用唯一 operation_key，避免 (promoter,debt,pool) 元组偶然重现被误判为重放而漏偿。
|
||
\AKSRT\Ledger\LedgerService::get_instance()->debit(
|
||
$promoter, \AKSRT\Ledger\AssetType::COMMISSION, $repay,
|
||
\AKSRT\Ledger\OperationKey::unique('commission-debt-repay'),
|
||
'affiliate_commission_debt',
|
||
['type' => 'commission_debt', 'id' => $promoter],
|
||
__('推广佣金偿还历史欠款', 'aksrt'),
|
||
0, [], $mutation, $guard
|
||
);
|
||
}
|
||
/**
|
||
* 退款准备：返回本订单待收回的佣金计划。即时入账模型下佣金状态只有
|
||
* credited | cancelled，可收回额 = original + 既有调整（正值）。
|
||
*
|
||
* @return array<string,mixed>|\WP_Error
|
||
*/
|
||
public function prepare_full_refund(string $order_number) {
|
||
global $wpdb;
|
||
$row = $wpdb->get_row($wpdb->prepare(
|
||
"SELECT * FROM {$this->table('commission_ledger')} WHERE order_number = %s LIMIT 1",
|
||
$order_number
|
||
), ARRAY_A);
|
||
if (!is_array($row) || (string) ($row['status'] ?? '') === 'cancelled') {
|
||
return ['active' => false];
|
||
}
|
||
try {
|
||
$original_minor = $this->signed_balance_minor((string) ($row['original_amount'] ?? '0'));
|
||
$adjustment_minor = $this->signed_balance_minor((string) ($row['adjustment_total'] ?? '0'));
|
||
} catch (\InvalidArgumentException $e) {
|
||
return new \WP_Error('aksrt_commission_amount', __('返佣金额无效', 'aksrt'), ['status' => 500]);
|
||
}
|
||
$remaining_minor = $original_minor + $adjustment_minor;
|
||
if ($remaining_minor <= 0) {
|
||
return ['active' => false];
|
||
}
|
||
$status = (string) ($row['status'] ?? '');
|
||
if ($status !== 'credited') {
|
||
return new \WP_Error('aksrt_commission_state', __('返佣记录状态不可退款', 'aksrt'), ['status' => 409]);
|
||
}
|
||
return [
|
||
'active' => true,
|
||
'id' => (int) $row['id'],
|
||
'promoter_id' => (int) $row['promoter_id'],
|
||
'status' => $status,
|
||
'original_amount' => (string) $row['original_amount'],
|
||
'adjustment_total' => (string) $row['adjustment_total'],
|
||
'amount_minor' => $remaining_minor,
|
||
'source_key' => hash('sha256', 'order-full-refund:' . $order_number),
|
||
];
|
||
}
|
||
|
||
/**
|
||
* 退款守卫（在买家退款账务事务内运行）：锁定佣金明细行并复核未变化。
|
||
* 仅校验明细行，不触碰资金池，故不会因促推者池不足而使买家退款失败。
|
||
*
|
||
* @param array<string,mixed> $plan
|
||
*/
|
||
public function guard_full_refund(array $plan) {
|
||
if (empty($plan['active'])) return true;
|
||
global $wpdb;
|
||
$current = $wpdb->get_row($wpdb->prepare(
|
||
"SELECT promoter_id, status, original_amount, adjustment_total FROM {$this->table('commission_ledger')} WHERE id = %d FOR UPDATE",
|
||
(int) $plan['id']
|
||
), ARRAY_A);
|
||
if (!is_array($current)
|
||
|| (int) ($current['promoter_id'] ?? 0) !== (int) $plan['promoter_id']
|
||
|| (string) ($current['status'] ?? '') !== (string) $plan['status']
|
||
|| (string) ($current['original_amount'] ?? '') !== (string) $plan['original_amount']
|
||
|| (string) ($current['adjustment_total'] ?? '') !== (string) $plan['adjustment_total']
|
||
) {
|
||
return new \WP_Error('aksrt_commission_state', __('返佣记录状态已变化', 'aksrt'), ['status' => 409]);
|
||
}
|
||
return true;
|
||
}
|
||
|
||
/**
|
||
* 退款应用（在买家退款账务事务内运行）：仅做佣金明细账的登记——冲正
|
||
* adjustment_total 并置为 cancelled，写入不可变调整记录。这里不移动资金池
|
||
* （避免池不足时中止买家退款）；真正的池收回 + 欠款挂账由 clawback_after_refund
|
||
* 在退款事务提交后独立执行。
|
||
*
|
||
* @param array<string,mixed> $plan
|
||
*/
|
||
public function apply_full_refund(array $plan) {
|
||
if (empty($plan['active'])) return true;
|
||
global $wpdb;
|
||
$negative = '-' . \AKSRT\Ledger\AssetAmount::commission_from_minor((int) $plan['amount_minor'])->decimal();
|
||
$inserted = $wpdb->insert($this->table('commission_adjustment'), [
|
||
'ledger_id' => (int) $plan['id'],
|
||
'promoter_id' => (int) $plan['promoter_id'],
|
||
'amount' => $negative,
|
||
'reason' => 'order_refund',
|
||
'source_key' => (string) $plan['source_key'],
|
||
'operator_id' => get_current_user_id(),
|
||
'created_at' => current_time('mysql', true),
|
||
], ['%d', '%d', '%s', '%s', '%s', '%d', '%s']);
|
||
if ($inserted !== 1) {
|
||
return new \WP_Error('aksrt_commission_adjustment', __('返佣退款记录写入失败', 'aksrt'), ['status' => 409]);
|
||
}
|
||
$updated = $wpdb->query($wpdb->prepare(
|
||
"UPDATE {$this->table('commission_ledger')} SET adjustment_total = adjustment_total + %s, status = 'cancelled' WHERE id = %d AND status = %s",
|
||
$negative,
|
||
(int) $plan['id'],
|
||
(string) $plan['status']
|
||
));
|
||
return $updated === 1
|
||
? true
|
||
: new \WP_Error('aksrt_commission_state', __('返佣记录状态已变化', 'aksrt'), ['status' => 409]);
|
||
}
|
||
|
||
/**
|
||
* 退款后的资金池收回（在买家退款事务提交后调用，不属于买家退款关键路径）：
|
||
* 从 COMMISSION 池收回 min(应收回, 池余额)，不足部分记为欠款，后续新佣金优先偿还。
|
||
*
|
||
* 金额守恒 + 幂等：
|
||
* - 池扣减带重试，locked 池余额 < take 时重试并缩小 take，绝不透支中止；
|
||
* - 池扣减用 source_key 派生的确定性 operation_key，重复调用天然去重；
|
||
* - 欠款挂账用独立 source_key 一次性插入 commission_adjustment（唯一约束），
|
||
* 仅首次插入成功者累加欠款，杜绝重复挂账。
|
||
*
|
||
* @param array<string,mixed> $plan
|
||
*/
|
||
public function clawback_after_refund(array $plan): void {
|
||
if (empty($plan['active'])) {
|
||
return;
|
||
}
|
||
$promoter = (int) ($plan['promoter_id'] ?? 0);
|
||
$clawback = (int) ($plan['amount_minor'] ?? 0);
|
||
$source_key = (string) ($plan['source_key'] ?? '');
|
||
if ($promoter <= 0 || $clawback <= 0 || $source_key === '') {
|
||
return;
|
||
}
|
||
$ledger = \AKSRT\Ledger\LedgerService::get_instance();
|
||
// 收回的幂等边界是明细行的 cancelled 状态（apply_full_refund 已置位且带唯一 source_key）：
|
||
// 单笔退款只会调用一次收回。这里每次 debit 用唯一 operation_key，避免「不同金额复用
|
||
// 同一确定性 key 被当作重放而漏收」。池扣减额恒 ≤ 锁定池余额，绝不透支。
|
||
$remaining = $clawback;
|
||
for ($attempt = 1; $attempt <= 5 && $remaining > 0; $attempt++) {
|
||
$pool = $ledger->balance($promoter, \AKSRT\Ledger\AssetType::COMMISSION);
|
||
$take = max(0, min($remaining, $pool));
|
||
if ($take <= 0) {
|
||
break;
|
||
}
|
||
$guard = function () use ($promoter, $take, $ledger) {
|
||
$locked = $ledger->balance($promoter, \AKSRT\Ledger\AssetType::COMMISSION);
|
||
return $locked >= $take ? true : new \WP_Error('aksrt_commission_pool', __('佣金池余额已变化', 'aksrt'), ['status' => 409]);
|
||
};
|
||
$result = $ledger->debit(
|
||
$promoter, \AKSRT\Ledger\AssetType::COMMISSION, $take,
|
||
\AKSRT\Ledger\OperationKey::unique('commission-refund-clawback'), 'affiliate_commission_refund',
|
||
['type' => 'commission_refund', 'key' => $source_key],
|
||
__('推广佣金退款收回', 'aksrt'),
|
||
get_current_user_id(), [], null, $guard
|
||
);
|
||
if (!is_wp_error($result)) {
|
||
$remaining -= $take;
|
||
continue;
|
||
}
|
||
// 池余额被并发提现/收回改变：重试并以新的锁定余额缩小 take。
|
||
}
|
||
if ($remaining > 0) {
|
||
$this->record_debt($promoter, $remaining, $source_key, (int) ($plan['id'] ?? 0));
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 挂账欠款：以独立 source_key 一次性写入调整记录（唯一约束保证幂等），
|
||
* 仅首次插入成功时累加用户欠款计数。
|
||
*/
|
||
private function record_debt(int $promoter, int $shortfall_minor, string $source_key, int $ledger_id): void {
|
||
if ($promoter <= 0 || $shortfall_minor <= 0) {
|
||
return;
|
||
}
|
||
global $wpdb;
|
||
$debt_source = hash('sha256', 'commission-refund-debt:' . $source_key);
|
||
$inserted = $wpdb->insert($this->table('commission_adjustment'), [
|
||
'ledger_id' => $ledger_id,
|
||
'promoter_id' => $promoter,
|
||
'amount' => '-' . \AKSRT\Ledger\AssetAmount::commission_from_minor($shortfall_minor)->decimal(),
|
||
'reason' => 'refund_debt',
|
||
'source_key' => $debt_source,
|
||
'operator_id' => get_current_user_id(),
|
||
'created_at' => current_time('mysql', true),
|
||
], ['%d', '%d', '%s', '%s', '%s', '%d', '%s']);
|
||
if ($inserted !== 1) {
|
||
// 已挂账（重复调用）：唯一约束拦截，不重复累加欠款。
|
||
return;
|
||
}
|
||
$debt_table = $this->table('commission_debt');
|
||
$now = current_time('mysql', true);
|
||
$wpdb->query($wpdb->prepare(
|
||
"INSERT INTO {$debt_table} (user_id, debt_minor, updated_at) VALUES (%d, %d, %s)
|
||
ON DUPLICATE KEY UPDATE debt_minor = debt_minor + %d, updated_at = %s",
|
||
$promoter, $shortfall_minor, $now, $shortfall_minor, $now
|
||
));
|
||
}
|
||
|
||
private function signed_balance_minor(string $decimal): int {
|
||
$negative = str_starts_with($decimal, '-');
|
||
$value = $negative ? substr($decimal, 1) : $decimal;
|
||
$minor = \AKSRT\Ledger\AssetAmount::balance($value)->minor();
|
||
return $negative ? -$minor : $minor;
|
||
}
|
||
/**
|
||
* 佣金总览（即时入账模型）：
|
||
* - total 累计佣金（明细账原始佣金累加，不含退款冲正）
|
||
* - pool 当前可提现佣金（COMMISSION 资金池余额）
|
||
* - withdrawn 已提现（佣金来源、已完成的提现毛额累加）
|
||
* - debt 当前挂账欠款（退款收回不足产生，后续佣金优先偿还）
|
||
* 无冻结结算期，故不再有 pending/settled/wallet 语义。
|
||
*/
|
||
public function overview(int $user_id): array {
|
||
global $wpdb; $table=$this->table('commission_ledger');
|
||
$total = (string) $wpdb->get_var($wpdb->prepare(
|
||
"SELECT COALESCE(SUM(original_amount),0) FROM {$table} WHERE promoter_id=%d",
|
||
$user_id
|
||
));
|
||
$withdrawn = '0.00';
|
||
$withdrawal_table = $this->table('withdrawal');
|
||
if ($withdrawal_table !== '') {
|
||
$withdrawn = $this->balance_decimal((string) $wpdb->get_var($wpdb->prepare(
|
||
"SELECT COALESCE(SUM(CASE WHEN status='completed' THEN gross_amount ELSE 0 END),0) FROM {$withdrawal_table}
|
||
WHERE user_id=%d AND account_info LIKE %s",
|
||
$user_id,
|
||
'%"source":"commission"%'
|
||
)));
|
||
}
|
||
$debt_minor = (int) $wpdb->get_var($wpdb->prepare(
|
||
"SELECT debt_minor FROM {$this->table('commission_debt')} WHERE user_id=%d",
|
||
$user_id
|
||
));
|
||
$pool_minor = \AKSRT\Ledger\LedgerService::get_instance()->balance($user_id, \AKSRT\Ledger\AssetType::COMMISSION);
|
||
return [
|
||
'total' => $this->balance_decimal($total),
|
||
'pool' => \AKSRT\Ledger\AssetAmount::commission_from_minor($pool_minor)->decimal(),
|
||
'withdrawn' => $withdrawn,
|
||
'debt' => \AKSRT\Ledger\AssetAmount::commission_from_minor(max(0, $debt_minor))->decimal(),
|
||
];
|
||
}
|
||
public function list_entries(int $user_id, array $args=[]): array {
|
||
global $wpdb; $table=$this->table('commission_ledger'); $limit=max(1,min(100,(int)($args['per_page']??20))); $page=max(1,(int)($args['page']??1)); $offset=($page-1)*$limit; $where='promoter_id=%d'; $params=[$user_id]; $status=sanitize_key((string)($args['status']??'')); if(in_array($status,['credited','cancelled'],true)){ $where.=' AND status=%s'; $params[]=$status; } $total=(int)$wpdb->get_var($wpdb->prepare("SELECT COUNT(*) FROM {$table} WHERE {$where}",$params)); $rows=$wpdb->get_results($wpdb->prepare("SELECT * FROM {$table} WHERE {$where} ORDER BY id DESC LIMIT %d OFFSET %d",array_merge($params,[$limit,$offset])),ARRAY_A); return ['items'=>$rows?:[],'total'=>$total,'page'=>$page,'per_page'=>$limit,'max_pages'=>max(1,(int)ceil($total/$limit))];
|
||
}
|
||
public function register_routes(): void {
|
||
$list_args = [
|
||
'page' => ['type' => 'integer', 'minimum' => 1, 'default' => 1],
|
||
'per_page' => ['type' => 'integer', 'minimum' => 1, 'maximum' => 100, 'default' => 20],
|
||
'status' => ['type' => 'string', 'enum' => ['pending', 'processing', 'completed', 'rejected', 'settled', 'cancelled']],
|
||
];
|
||
register_rest_route('aksrt/v1', '/earnings/overview', [
|
||
'methods' => \WP_REST_Server::READABLE,
|
||
'callback' => fn() => rest_ensure_response($this->overview(get_current_user_id())),
|
||
'permission_callback' => [$this, 'check_user_rest'],
|
||
]);
|
||
register_rest_route('aksrt/v1', '/earnings/commissions', [
|
||
'methods' => \WP_REST_Server::READABLE,
|
||
'callback' => fn(\WP_REST_Request $request) => rest_ensure_response($this->list_entries(get_current_user_id(), $request->get_params())),
|
||
'permission_callback' => [$this, 'check_user_rest'],
|
||
'args' => $list_args,
|
||
]);
|
||
$withdrawal_args = $list_args;
|
||
$withdrawal_args['per_page']['default'] = 10;
|
||
$withdrawal_args['per_page']['maximum'] = 10;
|
||
$withdrawal_args['source'] = ['type' => 'string', 'enum' => ['balance', 'commission'], 'default' => 'commission'];
|
||
register_rest_route('aksrt/v1', '/earnings/withdrawals', [
|
||
[
|
||
'methods' => \WP_REST_Server::READABLE,
|
||
'callback' => fn(\WP_REST_Request $request) => rest_ensure_response($this->withdrawals(get_current_user_id(), $request->get_params())),
|
||
'permission_callback' => [$this, 'check_user_rest'],
|
||
'args' => $withdrawal_args,
|
||
],
|
||
|
||
[
|
||
'methods' => \WP_REST_Server::CREATABLE,
|
||
'callback' => [$this, 'create_withdrawal'],
|
||
'permission_callback' => [$this, 'check_user_write_rest'],
|
||
'args' => [
|
||
'amount' => ['type' => 'string', 'required' => true, 'pattern' => '^(0|[1-9]\d*)(?:\.\d{1,2})?$'],
|
||
'method' => ['type' => 'string', 'required' => true, 'sanitize_callback' => 'sanitize_key'],
|
||
'account' => ['type' => 'string', 'required' => true, 'minLength' => 1, 'maxLength' => 500, 'sanitize_callback' => 'sanitize_text_field'],
|
||
'source' => ['type' => 'string', 'enum' => ['balance', 'commission'], 'default' => 'commission'],
|
||
],
|
||
],
|
||
]);
|
||
register_rest_route('aksrt/v1', '/payment/withdrawals/(?P<id>\d+)/transition', [
|
||
'methods' => \WP_REST_Server::CREATABLE,
|
||
'callback' => [$this, 'transition_withdrawal'],
|
||
'permission_callback' => [$this, 'check_admin_write_rest'],
|
||
'args' => [
|
||
'id' => ['type' => 'integer', 'minimum' => 1, 'required' => true],
|
||
'status' => ['type' => 'string', 'required' => true, 'enum' => ['processing', 'completed', 'rejected']],
|
||
'note' => ['type' => 'string', 'default' => '', 'maxLength' => 1000, 'sanitize_callback' => 'sanitize_textarea_field'],
|
||
],
|
||
]);
|
||
}
|
||
public function check_user_rest(\WP_REST_Request $request) {
|
||
return is_user_logged_in() ? true : new \WP_Error('aksrt_auth_required', __('请先登录', 'aksrt'), ['status' => 401]);
|
||
}
|
||
public function check_user_write_rest(\WP_REST_Request $request) {
|
||
$allowed = $this->check_user_rest($request);
|
||
return is_wp_error($allowed) ? $allowed : $this->verify_rest_nonce($request);
|
||
}
|
||
public function check_admin_rest(\WP_REST_Request $request) {
|
||
return current_user_can('manage_options') ? true : new \WP_Error('aksrt_admin_forbidden', __('无权执行此操作', 'aksrt'), ['status' => 403]);
|
||
}
|
||
public function check_admin_write_rest(\WP_REST_Request $request) {
|
||
$allowed = $this->check_admin_rest($request);
|
||
return is_wp_error($allowed) ? $allowed : $this->verify_rest_nonce($request);
|
||
}
|
||
private function verify_rest_nonce(\WP_REST_Request $request) {
|
||
$nonce = (string) $request->get_header('X-WP-Nonce');
|
||
return $nonce !== '' && wp_verify_nonce($nonce, 'wp_rest')
|
||
? true
|
||
: new \WP_Error('aksrt_rest_nonce', __('安全验证失败，请刷新页面后重试', 'aksrt'), ['status' => 403]);
|
||
}
|
||
public function withdrawals(int $user_id, array $args): array {
|
||
$service = \AKSRT\Payment\Withdrawal::get_instance();
|
||
$page = max(1, (int) ($args['page'] ?? 1));
|
||
$per_page = 10;
|
||
$status = sanitize_key((string) ($args['status'] ?? ''));
|
||
// 提现记录按来源隔离：历史弹窗仅在余额页调用（无 source），默认 balance；
|
||
// 佣金页如需查询佣金提现记录须显式传 source=commission。
|
||
$source = sanitize_key((string) ($args['source'] ?? '')) === \AKSRT\Payment\Withdrawal::SOURCE_COMMISSION
|
||
? \AKSRT\Payment\Withdrawal::SOURCE_COMMISSION
|
||
: \AKSRT\Payment\Withdrawal::SOURCE_BALANCE;
|
||
$filters = ['user_id' => $user_id, 'source' => $source];
|
||
if ($status !== '') {
|
||
$filters['status'] = $status;
|
||
}
|
||
$total = $service->get_count($filters);
|
||
$max_pages = max(1, (int) ceil($total / $per_page));
|
||
$page = min($page, $max_pages);
|
||
return [
|
||
'items' => $service->get_user_withdrawals($user_id, [
|
||
'status' => $status,
|
||
'source' => $source,
|
||
'limit' => $per_page,
|
||
'offset' => ($page - 1) * $per_page,
|
||
]),
|
||
'total' => $total,
|
||
'page' => $page,
|
||
'per_page' => $per_page,
|
||
'max_pages' => $max_pages,
|
||
];
|
||
}
|
||
public function create_withdrawal(\WP_REST_Request $request): \WP_REST_Response|\WP_Error {
|
||
$user_id=get_current_user_id(); $method=sanitize_key((string)$request->get_param('method')); $account=sanitize_text_field((string)$request->get_param('account')); $settings=\AKSRT\Settings\Settings::get_withdrawal_settings();
|
||
// 提现来源：commission → 佣金池；其余 → 余额钱包（充值 + 创作分成）。
|
||
$source = sanitize_key((string) $request->get_param('source')) === \AKSRT\Payment\Withdrawal::SOURCE_COMMISSION
|
||
? \AKSRT\Payment\Withdrawal::SOURCE_COMMISSION
|
||
: \AKSRT\Payment\Withdrawal::SOURCE_BALANCE;
|
||
$raw_amount=$request->get_param('amount');
|
||
try { $amount=\AKSRT\Ledger\AssetAmount::balance(is_string($raw_amount)?$raw_amount:''); }
|
||
catch (\InvalidArgumentException $e) { return new \WP_Error('affiliate_withdraw_amount',__('提现金额格式无效。','aksrt'),['status'=>400]); }
|
||
$operation_key=\AKSRT\Ledger\OperationKey::from_request($request,'affiliate-withdraw',$user_id); if(is_wp_error($operation_key)) return $operation_key;
|
||
// 来源各自独立的开关闸门：佣金提现需返佣启用；余额提现需余额提现开关。
|
||
if ($source === \AKSRT\Payment\Withdrawal::SOURCE_COMMISSION) {
|
||
if (empty(\AKSRT\Settings\Settings::get_affiliate_settings()['enabled'])) return new \WP_Error('affiliate_disabled',__('推广返佣未启用。','aksrt'),['status'=>403]);
|
||
} else {
|
||
$all=\AKSRT\Settings\Settings::get_all();
|
||
if (empty($all['pay_balance_withdraw_s'])) return new \WP_Error('balance_withdraw_disabled',__('余额提现未启用。','aksrt'),['status'=>403]);
|
||
}
|
||
if (class_exists('\AKSRT\Settings\Capabilities') && !\AKSRT\Settings\Capabilities::user_can('balance_withdraw', $user_id)) {
|
||
return new \WP_Error('withdraw_forbidden',__('当前账号不可提现。','aksrt'),['status'=>403]);
|
||
}
|
||
$minimum=\AKSRT\Ledger\AssetAmount::balance(is_string($settings['min_amount'] ?? null) ? $settings['min_amount'] : '');
|
||
if ($amount->minor() < $minimum->minor()) return new \WP_Error('affiliate_withdraw_min',__('未达到最低提现金额。','aksrt'),['status'=>400]);
|
||
if (!in_array($method,(array)$settings['payout_channels'],true) || $account==='') return new \WP_Error('affiliate_withdraw_account',__('请提供有效的收款渠道和收款码。','aksrt'),['status'=>400]);
|
||
$result=\AKSRT\Payment\Withdrawal::get_instance()->create_balance_request($user_id,$amount->minor(),$method,$account,$settings,$operation_key,$source); if(is_wp_error($result)) return $result; return new \WP_REST_Response(['success'=>true,'data'=>$result],201);
|
||
}
|
||
public function admin_withdrawals(array $args): array { $service=\AKSRT\Payment\Withdrawal::get_instance(); return ['items'=>$service->get_all(['status'=>sanitize_key((string)($args['status']??'')),'limit'=>max(1,min(100,(int)($args['per_page']??20))),'offset'=>max(0,((int)($args['page']??1)-1)*max(1,(int)($args['per_page']??20)))]),'stats'=>$service->get_stats()]; }
|
||
public function transition_withdrawal(\WP_REST_Request $request): \WP_REST_Response|\WP_Error {
|
||
$operation_key = \AKSRT\Ledger\OperationKey::from_request($request, 'admin-withdraw-transition', get_current_user_id());
|
||
if (is_wp_error($operation_key)) return $operation_key;
|
||
$status = sanitize_key((string) $request->get_param('status'));
|
||
$result = \AKSRT\Payment\Withdrawal::get_instance()->process_status_change((int) $request['id'], $status, (string) $request->get_param('note'), $operation_key);
|
||
if (is_wp_error($result)) return $result;
|
||
$data = is_array($result) ? $result : [];
|
||
return new \WP_REST_Response(array_merge(['success' => true, 'status' => $status], $data), 200);
|
||
}
|
||
private function balance_decimal(string $value): string {
|
||
try {
|
||
return \AKSRT\Ledger\AssetAmount::balance($value)->decimal();
|
||
} catch (\InvalidArgumentException $e) {
|
||
return '0.00';
|
||
}
|
||
}
|
||
}
|