Payout Management

module User::PayoutSchedule
  PAYOUT_STARTING_DATE = Date.new(2012, 12, 21)
  PAYOUT_RECURRENCE_DAYS = 7
  PAYOUT_DELAY_DAYS = 7
end

# User model
attr_json_data_accessor :payout_threshold_cents, 
  default: -> { minimum_payout_threshold_cents }

def minimum_payout_amount_cents
  [payout_threshold_cents, minimum_payout_threshold_cents].max
end

# app/controllers/settings/payments_controller.rb
def update
  # Validate threshold
  if params[:payout_threshold_cents].present? && 
     params[:payout_threshold_cents].to_i < current_seller.minimum_payout_threshold_cents
    return redirect_with_error(
      "Your payout threshold must be greater than the minimum payout amount"
    )
  end
  
  # Update payout settings
  current_seller.update(
    params.permit(
      :payouts_paused_by_user,
      :payout_threshold_cents,
      :payout_frequency
    )
  )
end

# User model
validate :payout_frequency_is_valid

def payout_frequency_is_valid
  unless [WEEKLY, MONTHLY, QUARTERLY, DAILY].include?(payout_frequency)
    errors.add(:payout_frequency, "is not a valid frequency")
  end
end

# app/controllers/balance_controller.rb
def index
  payouts_presenter = PayoutsPresenter.new(
    seller: current_seller,
    params: params
  )
  
  render inertia: "Payouts/Index",
    props: {
      next_payout_period_data: payouts_presenter.next_payout_period_data,
      processing_payout_periods_data: payouts_presenter.processing_payout_periods_data,
      payouts_status: current_seller.payouts_status,
      payouts_paused_by: current_seller.payouts_paused_by_source,
      past_payout_period_data: payouts_presenter.past_payout_period_data
    }
end

def upcoming_payouts
  upcoming_payout_date = next_payout_date
  upcoming_payouts = []
  
  while upcoming_payout_date
    payout_amount = payout_amount_for_payout_date(upcoming_payout_date)
    break if payout_amount < minimum_payout_amount_cents
    
    payout_period_end_date = payout_period_end_date_for_payout_date(
      upcoming_payout_date
    )
    payout_balances = unpaid_balances_up_to_date(payout_period_end_date)
    
    upcoming_payout = Payment.new(
      user: self,
      amount_cents: payout_amount,
      payout_period_end_date: payout_period_end_date,
      currency: Currency::USD,
      state: payouts_status,
      created_at: upcoming_payout_date,
      processor: current_payout_processor,
      bank_account: active_bank_account,
      payment_address: paypal_payout_email
    )
    
    upcoming_payouts << upcoming_payout
    upcoming_payout_date = advance_payout_date(upcoming_payout_date)
  end
  
  upcoming_payouts
end

def current_payout_processor
  if (paypal_payout_email.present? && active_bank_account.blank?) || 
     !native_payouts_supported?
    PayoutProcessorType::PAYPAL
  else
    PayoutProcessorType::STRIPE
  end
end

def eligible_for_instant_payouts?
  # Must meet minimum sales threshold
  # Must have good standing (no fraud flags)
  # Must be in supported country
end

def instant_payouts_supported?
  # Must have debit card connected
  active_bank_account&.supports_instant_payouts?
end

# app/controllers/instant_payouts_controller.rb
def create
  result = InstantPayoutsService.new(
    current_seller,
    date: Date.parse(params.require(:date))
  ).perform
  
  if result[:success]
    redirect_to balance_path, notice: "Instant payout initiated successfully"
  else
    redirect_to balance_path, alert: result[:error]
  end
end

# In Settings > Payments
current_seller.update(payouts_paused_by_user: true)

def payouts_paused_by_source
  return nil unless payouts_paused_internally?
  payouts_paused_by || PAYOUT_PAUSE_SOURCE_GUMROAD
end

def payouts_paused?
  payouts_paused_by_user? || payouts_paused_internally?
end

def payouts_paused_for_reason
  # Returns human-readable reason for pause
end

# app/controllers/api/v2/payouts_controller.rb
GET /api/v2/payouts

# Query parameters:
# - before: YYYY-MM-DD (end date)
# - after: YYYY-MM-DD (start date)
# - page_key: pagination token
# - include_upcoming: true/false
# - include_sales: true/false (requires view_sales scope)
# - include_transactions: true/false

{
  "payouts": [
    {
      "id": "payout_abc123",
      "amount_cents": 50000,
      "currency": "USD",
      "status": "paid",
      "payout_date": "2024-03-15",
      "payout_period_end_date": "2024-03-08",
      "processor": "stripe",
      "bank_account_last4": "1234"
    }
  ],
  "next_page_key": "encoded_pagination_token"
}

def supports_stripe_cross_border_payouts?
  # Returns true for countries that support USD payouts
  # but may not support local currency processing
end

def min_cross_border_payout_amount_usd_cents
  # Minimum amount for cross-border USD payouts
end