admin_api/config/coupon.php

<?php

/**
 * 优惠券配置
 *
 * 自动发放条件说明:
 *   - new_user: 新注册用户（注册天数 <= condition.days 且 无充值记录）
 *   - recharge_total: 累计充值 >= condition.amount (元)
 *   - inactive_days: 最近一次充值距今 >= condition.days 天
 *   - vip_level: VIP等级 >= condition.level
 *
 * 券类型:
 *   - type=1 (fixed): 固定金额赠送, coupon_value 即为赠送金额（元）
 *   - type=2 (percent): 按充值金额百分比赠送, coupon_value=百分比(%), max_bonus=上限(元)
 */
return [

    /*
    |--------------------------------------------------------------------------
    | 自动发放策略
    |--------------------------------------------------------------------------
    |
    | 当用户请求 GET /coupon/list 时，按顺序检查以下策略。
    | 每个策略只能发放一次（同名称有效券不重复发放）。
    |
    */
    'auto_issue_rules' => [

        // 新人优惠券：注册3天内 + 从未充值
        [
            'coupon_name'   => 'new_user_bonus',
            'coupon_type'   => 2,       // 百分比
            'coupon_value'  => 50,      // 50%
            'min_recharge'  => 10,      // 最低充值10元
            'max_bonus'     => 50,      // 最多送50元
            'valid_days'    => 7,       // 7天有效
            'condition'     => [
                'type' => 'new_user',
                'days' => 3,
            ],
        ],

        // 回归优惠券：超过14天未充值
        [
            'coupon_name'   => 'comeback_bonus',
            'coupon_type'   => 2,       // 百分比
            'coupon_value'  => 30,      // 30%
            'min_recharge'  => 20,      // 最低充值20元
            'max_bonus'     => 30,      // 最多送30元
            'valid_days'    => 3,       // 3天有效
            'condition'     => [
                'type' => 'inactive_days',
                'days' => 14,
            ],
        ],

        // 大额充值券：累计充值 >= 500
        [
            'coupon_name'   => 'vip_recharge_bonus',
            'coupon_type'   => 2,       // 百分比
            'coupon_value'  => 20,      // 20%
            'min_recharge'  => 10,      // 最低充值10元可用
            'max_bonus'     => 0,       // 固定金额不需要上限
            'valid_days'    => 14,      // 14天有效
            'condition'     => [
                'type'   => 'recharge_total',
                'amount' => 500,
            ],
        ],
    ],

    /*
    |--------------------------------------------------------------------------
    | 生效规则
    |--------------------------------------------------------------------------
    |
    | 仅在此列表中的优惠券名称才会自动发放。
    | 设为空数组 [] 则关闭所有自动发放。
    | 设为 ['*'] 则全部规则生效。
    |
    */
    'enabled_rules' => [
        // 'new_user_bonus',
        // 'comeback_bonus',
        // 'vip_recharge_bonus',
    ],

    /*
    |--------------------------------------------------------------------------
    | 金币增加原因码 (Reason)
    |--------------------------------------------------------------------------
    |
    | 使用优惠券增加金币时写入 RecordUserScoreChange 的原因码。
    | 需确保不与现有 Reason 冲突（现有: 21,33,36,37,42,44,45,49,51,52,72,73）
    |
    */
    'score_reason' => 55,  // 优惠券赠送
];