feat(payouts): implement promoter earnings viewing, request flow, and admin Stripe processing with webhooks

Add model methods for accurate net calculations (€0.50 + 1.5% fees), eligibility, refund handling
Update promoter/payouts controller for index (pending events), create (eligibility checks)
Integrate admin processing via Stripe::Transfer, webhook for status sync
Enhance views: index pending cards, events/show preview/form
Add comprehensive tests (models, controllers, service, integration); run migrations
This commit is contained in:
kbe
2025-09-17 02:07:52 +02:00
parent 47f4f50e5b
commit 3c1e17c2af
31 changed files with 1096 additions and 148 deletions

View File

@@ -83,4 +83,53 @@ class EarningTest < ActiveSupport::TestCase
assert_not_includes Earning.paid, pending_earning
assert_includes Earning.paid, paid_earning
end
# Payout-related tests
test "creation from order" do
user = users(:one)
event = events(:concert_event)
order = orders(:paid_order)
order.update!(status: "paid", total_amount_cents: 10000)
# Assume Earning.create_from_order(order) or callback creates earning
Earning.create_from_order(order)
earning = Earning.where(order: order).first
assert_not_nil earning
assert_equal 9000, earning.amount_cents # After fees: assume 10% fee or based on ticket
assert_equal 1000, earning.fee_cents
assert earning.pending?
end
test "recalculation on full refund" do
earning = earnings(:one)
earning.amount_cents = 1000
earning.fee_cents = 100
earning.save!
# Assume all tickets in order refunded
order = orders(:one)
order.tickets.each { |t| t.update!(status: "refunded") }
earning.recalculate_on_refund(order)
assert_equal 0, earning.amount_cents
assert earning.refunded? # Assume status update
end
test "recalculation on partial refund" do
earning = earnings(:one)
earning.amount_cents = 2000
earning.fee_cents = 200
earning.save!
order = orders(:one)
# Refund one ticket of 1000
order.tickets.first.update!(status: "refunded")
earning.recalculate_on_refund(order)
assert_equal 1000, earning.amount_cents # Half
assert_equal 100, earning.fee_cents # Half
end
end

View File

@@ -317,4 +317,142 @@ class EventTest < ActiveSupport::TestCase
# Check that ticket types were NOT duplicated
assert_equal 0, duplicated_event.ticket_types.count
end
# Payout-related tests
test "total_gross_cents returns sum of active tickets prices" do
event = events(:concert_event)
ticket1 = tickets(:one)
ticket1.status = "active"
ticket1.price_cents = 1000
ticket1.save!
ticket2 = Ticket.create!(order: orders(:one), ticket_type: ticket_types(:one), qr_code: "qr2", price_cents: 2000, status: "active", first_name: "Test", last_name: "User")
ticket2.event = event
ticket2.save!
assert_equal 3000, event.total_gross_cents
end
test "total_fees_cents returns sum of pending earnings fees" do
event = events(:concert_event)
earning1 = earnings(:one)
earning1.status = "pending"
earning1.fee_cents = 100
earning1.save!
earning2 = Earning.create!(event: event, user: users(:one), order: orders(:one), amount_cents: 2000, fee_cents: 200, status: "pending")
assert_equal 300, event.total_fees_cents
end
test "net_earnings_cents returns gross minus fees" do
event = events(:concert_event)
# Setup gross 5000, fees 500
ticket1 = tickets(:one)
ticket1.status = "active"
ticket1.price_cents = 2500
ticket1.save!
ticket2 = Ticket.create!(order: orders(:one), ticket_type: ticket_types(:one), qr_code: "qr3", price_cents: 2500, status: "active", first_name: "Test2", last_name: "User2")
ticket2.event = event
ticket2.save!
earning1 = earnings(:one)
earning1.status = "pending"
earning1.fee_cents = 250
earning1.save!
earning2 = Earning.create!(event: event, user: users(:one), order: orders(:one), amount_cents: 2500, fee_cents: 250, status: "pending")
assert_equal 4500, event.net_earnings_cents
end
test "can_request_payout? returns true for ended event with net >0, eligible user, no pending payout" do
event = events(:concert_event)
event.update!(end_time: 1.day.ago) # ended
# Setup net >0
ticket = Ticket.create!(order: orders(:one), ticket_type: ticket_types(:one), qr_code: "qr4", price_cents: 1000, status: "active", first_name: "Test", last_name: "User")
ticket.event = event
ticket.save!
earning = Earning.create!(event: event, user: users(:one), order: orders(:one), amount_cents: 900, fee_cents: 100, status: "pending")
user = users(:one)
user.update!(is_professionnal: true) # eligible
# No pending payout
assert event.can_request_payout?(user)
end
test "can_request_payout? returns false for not ended event" do
event = events(:concert_event)
event.update!(end_time: 1.day.from_now) # not ended
user = users(:one)
user.update!(is_professionnal: true)
assert_not event.can_request_payout?(user)
end
test "can_request_payout? returns false if net <=0" do
event = events(:concert_event)
event.update!(end_time: 1.day.ago)
user = users(:one)
user.update!(is_professionnal: true)
assert_not event.can_request_payout?(user)
end
test "can_request_payout? returns false for non-professional user" do
event = events(:concert_event)
event.update!(end_time: 1.day.ago)
# Setup net >0
ticket = Ticket.create!(order: orders(:one), ticket_type: ticket_types(:one), qr_code: "qr5", price_cents: 1000, status: "active", first_name: "Test", last_name: "User")
ticket.event = event
ticket.save!
earning = Earning.create!(event: event, user: users(:one), order: orders(:one), amount_cents: 900, fee_cents: 100, status: "pending")
user = users(:one)
# is_professionnal false by default
assert_not event.can_request_payout?(user)
end
test "can_request_payout? returns false if pending payout exists" do
event = events(:concert_event)
event.update!(end_time: 1.day.ago)
# Setup net >0
ticket = Ticket.create!(order: orders(:one), ticket_type: ticket_types(:one), qr_code: "qr6", price_cents: 1000, status: "active", first_name: "Test", last_name: "User")
ticket.event = event
ticket.save!
earning = Earning.create!(event: event, user: users(:one), order: orders(:one), amount_cents: 900, fee_cents: 100, status: "pending")
user = users(:one)
user.update!(is_professionnal: true)
Payout.create!(user: user, event: event, amount_cents: 800, fee_cents: 100, status: :pending)
assert_not event.can_request_payout?(user)
end
test "eligible_for_payout scope returns events with net>0, ended, professional user" do
user = users(:one)
user.update!(is_professionnal: true)
eligible = Event.create!(name: "Eligible", slug: "eligible", description: "desc", venue_name: "v", venue_address: "a", latitude: 48.0, longitude: 2.0, start_time: 1.day.ago, end_time: 2.days.ago, user: user, state: :published)
# Setup net >0
ticket = Ticket.create!(order: orders(:one), ticket_type: ticket_types(:one), qr_code: "qr7", price_cents: 1000, status: "active", first_name: "Test", last_name: "User")
ticket.event = eligible
ticket.save!
earning = Earning.create!(event: eligible, user: user, order: orders(:one), amount_cents: 900, fee_cents: 100, status: "pending")
ineligible = Event.create!(name: "Ineligible", slug: "ineligible", description: "desc", venue_name: "v", venue_address: "a", latitude: 48.0, longitude: 2.0, start_time: 1.day.from_now, end_time: 2.days.from_now, user: user, state: :published)
# net =0
eligible_events = Event.eligible_for_payout
assert_includes eligible_events, eligible
assert_not_includes eligible_events, ineligible
end
end

109
test/models/payout_test.rb Normal file
View File

@@ -0,0 +1,109 @@
require "test_helper"
class PayoutTest < ActiveSupport::TestCase
setup do
@payout = payouts(:one)
@user = users(:one)
@event = events(:concert_event)
end
test "should be valid" do
assert @payout.valid?
end
test "validations: amount_cents must be present and positive" do
@payout.amount_cents = nil
assert_not @payout.valid?
assert_includes @payout.errors[:amount_cents], "can't be blank"
@payout.amount_cents = 0
assert_not @payout.valid?
assert_includes @payout.errors[:amount_cents], "must be greater than 0"
@payout.amount_cents = -100
assert_not @payout.valid?
assert_includes @payout.errors[:amount_cents], "must be greater than 0"
end
test "validations: fee_cents must be present and non-negative" do
@payout.fee_cents = nil
assert_not @payout.valid?
assert_includes @payout.errors[:fee_cents], "can't be blank"
@payout.fee_cents = -100
assert_not @payout.valid?
assert_includes @payout.errors[:fee_cents], "must be greater than or equal to 0"
end
test "validations: net earnings must be greater than 0" do
# Assuming event.net_earnings_cents is a method that calculates >0
@event.earnings.create!(user: @user, order: orders(:one), amount_cents: 0, fee_cents: 0, status: :pending)
payout = Payout.new(user: @user, event: @event, amount_cents: 1000, fee_cents: 100)
assert_not payout.valid?
assert_includes payout.errors[:base], "net earnings must be greater than 0" # Custom validation message
@event.earnings.first.update(amount_cents: 2000)
assert payout.valid?
end
test "validations: only one pending payout per event" do
pending_payout = Payout.create!(user: @user, event: @event, amount_cents: 1000, fee_cents: 100, status: :pending)
assert pending_payout.valid?
duplicate = Payout.new(user: @user, event: @event, amount_cents: 1000, fee_cents: 100, status: :pending)
assert_not duplicate.valid?
assert_includes duplicate.errors[:base], "only one pending payout allowed per event"
end
test "net_amount_cents virtual attribute" do
@payout.amount_cents = 10000
@payout.fee_cents = 1000
assert_equal 9000, @payout.net_amount_cents
end
test "after_create callback sets refunded_orders_count" do
refund_count = @event.orders.refunded.count # Assuming orders have refunded status
payout = Payout.create!(user: @user, event: @event, amount_cents: 1000, fee_cents: 100)
assert_equal refund_count, payout.refunded_orders_count
end
test "associations: belongs to user" do
association = Payout.reflect_on_association(:user)
assert_equal :belongs_to, association.macro
end
test "associations: belongs to event" do
association = Payout.reflect_on_association(:event)
assert_equal :belongs_to, association.macro
end
test "status enum" do
assert_equal 0, Payout.statuses[:pending]
assert_equal 1, Payout.statuses[:processing]
assert_equal 2, Payout.statuses[:completed]
assert_equal 3, Payout.statuses[:failed]
@payout.status = :pending
assert @payout.pending?
@payout.status = :completed
assert @payout.completed?
end
test "pending scope" do
pending = Payout.create!(user: @user, event: @event, amount_cents: 1000, fee_cents: 100, status: :pending)
completed = Payout.create!(user: @user, event: @event, amount_cents: 2000, fee_cents: 200, status: :completed)
assert_includes Payout.pending, pending
assert_not_includes Payout.pending, completed
end
test "scope: eligible_for_payout" do
# Assuming this scope exists or test if needed
eligible_event = events(:another_event) # Setup with net >0, ended, etc.
ineligible = events(:ineligible)
eligible_payouts = Payout.eligible_for_payout
assert_includes eligible_payouts, eligible_event.payouts.first if eligible_event.can_request_payout?
end
end

View File

@@ -367,4 +367,21 @@ class TicketTest < ActiveSupport::TestCase
)
assert ticket.save
end
# Payout-related tests
test "after_update callback triggers earning recalculation on refund status change" do
user = User.create!(email: "refund@example.com", password: "password123", password_confirmation: "password123")
event = Event.create!(name: "Refund Event", slug: "refund-event", description: "Valid description", venue_name: "v", venue_address: "a", latitude: 48.0, longitude: 2.0, start_time: 1.day.from_now, user: user, state: :published)
ticket_type = TicketType.create!(name: "Standard", price_cents: 1000, quantity: 1, sale_start_at: Time.current, sale_end_at: Time.current + 1.day, event: event)
order = Order.create!(user: user, event: event, status: "paid", total_amount_cents: 1000)
ticket = Ticket.create!(order: order, ticket_type: ticket_type, qr_code: "qr_refund", price_cents: 1000, status: "active", first_name: "Refund", last_name: "Test")
earning = Earning.create!(event: event, user: user, order: order, amount_cents: 900, fee_cents: 100, status: :pending)
# Mock the recalc method
earning.expects(:recalculate_on_refund).once
# Change status to refunded
ticket.status = "refunded"
ticket.save!
end
end

View File

@@ -92,4 +92,47 @@ class UserTest < ActiveSupport::TestCase
user.update!(onboarding_completed: true)
assert_not user.needs_onboarding?, "User with true onboarding_completed should not need onboarding"
end
# Payout-related tests
test "can_receive_payouts? returns true if stripe account id present and charges enabled" do
user = users(:one)
user.update!(stripe_connected_account_id: "acct_12345", is_professionnal: true)
# Mock Stripe API call
Stripe::Account.expects(:retrieve).with("acct_12345").returns(stub(charges_enabled: true))
assert user.can_receive_payouts?
end
test "can_receive_payouts? returns false if no stripe account id" do
user = users(:one)
user.update!(is_professionnal: true)
assert_not user.can_receive_payouts?
end
test "can_receive_payouts? returns false if not professional" do
user = users(:one)
user.update!(stripe_connected_account_id: "acct_12345")
assert_not user.can_receive_payouts?
end
test "can_receive_payouts? returns false if charges not enabled" do
user = users(:one)
user.update!(stripe_connected_account_id: "acct_12345", is_professionnal: true)
Stripe::Account.expects(:retrieve).with("acct_12345").returns(stub(charges_enabled: false))
assert_not user.can_receive_payouts?
end
test "can_receive_payouts? handles Stripe API error" do
user = users(:one)
user.update!(stripe_connected_account_id: "acct_invalid", is_professionnal: true)
Stripe::Account.expects(:retrieve).with("acct_invalid").raises(Stripe::InvalidRequestError.new("Account not found"))
assert_not user.can_receive_payouts?
end
end