Billing & Revenue - EventPalour

The billing dashboard provides comprehensive revenue tracking, transaction management, and withdrawal capabilities for your workspace. All revenue from ticket sales across workspace events flows into a unified billing system.

Access Requirements

Minimum Role: AdminOnly workspace admins and owners can access billing information. This ensures financial data security and proper revenue management.

Billing Overview

The overview dashboard displays key financial metrics:

Total Revenue

All-time revenue from ticket sales across all workspace events.

Your Earnings

Net earnings after platform fees and payment provider fees.

Platform Fees

5% commission charged by EventPalour on all ticket sales.

Transactions

Total transaction count with pending and failed breakdowns.

Revenue Calculation

Total Revenue = Sum of all completed ticket sales
Platform Fee = Total Revenue × 5%
Provider Fee = Charged by payment gateway (varies)
Your Earnings = Total Revenue - Platform Fee - Provider Fee

Billing Tabs

Overview Tab

View high-level financial metrics and trends.

Statistics Cards

Total Revenue: Gross revenue from all ticket sales
Your Earnings: Net revenue available for withdrawal
Platform Fees: 5% commission on all sales
Transactions: Total count with status breakdown
Available Balance: Funds ready for withdrawal
Total Withdrawn: Cumulative withdrawal amount
Pending Withdrawals: Withdrawals being processed

Monthly Earnings Chart

View earnings breakdown for the last 12 months:

Revenue per month
Platform fees per month
Net earnings per month

Use this data to:

Track growth trends
Plan event schedules
Forecast revenue
Identify peak seasons

Transactions Tab

Detailed view of all payment transactions.

Transaction Information

Each transaction displays:

Event Title: Event name
Buyer Email: Purchaser email address
Amount: Total payment amount
Earnings: Your share after fees
Status: Payment status badge
Reference: Provider reference number
Date: Transaction timestamp
Failure Reason: If transaction failed

Payment Statuses

Completed

Payment successfully processed. Funds added to available balance.

Pending

Payment being processed by payment provider. Usually completes within minutes.

Failed

Payment failed. Check failure reason for details. Buyer was not charged.

Refunded

Payment refunded to buyer. A 10% penalty applies to refunded amount.

Refund Processing

Locate Transaction

Find the completed transaction you want to refund in the Transactions tab.

Click Refund

Click the Refund button next to the transaction.

Review Refund Amount

The refund dialog shows:

Original amount
10% penalty deduction
Final refund amount to buyer

A 10% penalty is deducted from all refunds to cover processing costs and prevent abuse.

Provide Reason (Optional)

Enter a refund reason for your records and customer communication.

Confirm Refund

Click Confirm Refund to process. The refund:

Returns funds to buyer minus 10% penalty
Deducts from your available balance
Marks tickets as cancelled
Updates transaction status to “Refunded”

Earnings Tab

Detailed breakdown of revenue and fees.

Earnings Breakdown

Total Revenue:           KES 100,000
- Platform Fees (5%):    KES   5,000
- Provider Fees:         KES   2,000
= Your Earnings:         KES  93,000

This view helps you:

Understand fee structure
Calculate net profit
Plan pricing strategies
Optimize revenue

Withdrawals Tab

Request and manage fund withdrawals to your bank account or mobile money.

KYC Required: You must complete KYC (Know Your Customer) verification before requesting withdrawals. This ensures secure and compliant fund transfers.

Withdrawal Requirements

Minimum Amount

KES 500 (or USD 500 equivalent)

KYC Verification

Approved KYC status required

Available Balance

Sufficient funds in available balance

Valid Account

Bank account or mobile money number

Requesting a Withdrawal

Complete KYC Verification

Before your first withdrawal, complete KYC verification:

Navigate to Workspace > KYC
Submit required documents
Wait for approval (usually 1-3 business days)

KYC Documents

Required documents may include:

National ID or Passport
Business Registration (if applicable)
Tax ID (KRA PIN for Kenya)

Navigate to Withdrawals

Click the Withdrawals tab in the billing dashboard.

Enter Withdrawal Details

Fill out the withdrawal form:

Amount: Enter amount (minimum 500)
Account Number: Bank account or mobile money number
Account Name: Account holder name
Bank Name: Bank name (optional, for bank transfers)

Ensure account details match your KYC information for faster processing.

Review and Submit

Review your withdrawal request:

Withdrawal amount
Processing fee (if applicable)
Net amount you’ll receive

Click Request Withdrawal to submit.

Wait for Processing

Withdrawal requests are typically processed within:

Mobile Money: 1-3 business days
Bank Transfer: 3-5 business days

You’ll receive confirmation once processed.

Withdrawal Status

Track your withdrawals:

Pending: Request submitted, awaiting processing
Processing: Being transferred to your account
Completed: Funds successfully transferred
Failed: Transfer failed (funds returned to balance)

Fee Structure

Platform Fee

EventPalour charges a 5% commission on all ticket sales. This fee covers:

Platform maintenance and hosting
Payment processing infrastructure
Customer support
Security and fraud prevention
Feature development

Payment Provider Fees

Payment gateway fees vary by provider:

M-Pesa: ~2-3% of transaction
Card Payments: ~2.5-3.5% of transaction
Bank Transfer: Flat fee or percentage

These fees are automatically deducted before calculating your earnings.

Refund Penalty

A 10% penalty applies to all refunds to:

Cover payment processing costs
Prevent refund abuse
Compensate for transaction fees

Example:

Original Payment: KES 1,000
Refund Penalty:   KES   100 (10%)
Buyer Receives:   KES   900

Billing Data Structure

Payment Record

{
  id: string;
  providerReference: string;    // Payment gateway reference
  provider: string;             // Payment method used
  status: PaymentStatus;        // Transaction status
  amount: string;               // Total amount
  currency: string;             // KES or USD
  platformFee: string;          // 5% platform fee
  providerFee: string;          // Gateway fee
  organizerShare: string;       // Your earnings
  createdAt: Date;
  completedAt: Date | null;
  failureReason: string | null;
  eventTitle: string;
  eventId: string;
  buyerEmail: string;
  buyerId: string;
  ticketPrice: string;
  metadata: {
    tickets?: Array<{
      ticketId: string;
      quantity: number;
      price: string;
    }>
  } | null;
}

Best Practices

Complete KYC Early

Submit KYC verification before your first event to ensure smooth withdrawals when revenue starts flowing.

Monitor Transactions Regularly

Review transactions frequently to:

Identify and resolve failed payments
Track revenue trends
Reconcile ticket sales
Respond to buyer inquiries

Maintain Sufficient Balance

Keep enough available balance to handle potential refunds without withdrawal delays.

Document Refunds

Always provide a reason when processing refunds for internal records and customer communication.

Plan Withdrawals

Schedule withdrawals strategically:

After events complete
Before major expenses
Considering processing times

Accurate Account Details

Double-check withdrawal account information to prevent failed transfers and delays.

Troubleshooting

Cannot access billing

Ensure you have Admin or Owner role. Contact your workspace owner to upgrade your role if needed.

Withdrawal blocked - KYC required

Complete KYC verification:

Go to Workspace > KYC
Submit required documents
Wait for approval
Retry withdrawal after approval

Withdrawal failed

Common reasons:

Incorrect account details
Insufficient balance
Bank/provider issues
KYC information mismatch

Verify account details and retry. Contact support if issue persists.

Transaction shows as pending

Most payments complete within minutes. If a transaction is pending for over 1 hour:

Check payment provider status
Verify buyer completed payment
Contact support for investigation

Refund not processed

Ensure:

Transaction status is “Completed”
Sufficient balance available
You confirmed the refund dialog

Check transaction history for refund status.

Balance doesn't match expectations

Remember that available balance excludes:

Pending transactions
Pending withdrawals
Platform fees (5%)
Payment provider fees

Revenue Optimization Tips

Strategic Pricing

Factor in the 5% platform fee and payment fees when setting ticket prices to maintain target profit margins.

Early Bird Discounts

Offer early bird pricing to generate cash flow early and gauge event interest.

Tiered Tickets

Create multiple ticket tiers (VIP, Regular, Early Bird) to maximize revenue from different audience segments.

Minimize Refunds

Set clear event policies and communicate effectively to reduce refund requests and 10% penalties.

Next Steps

Complete KYC

Submit verification to enable withdrawals

Manage Team

Add team members to help manage events

Configure Settings

Customize workspace profile

Create Events

Start organizing and selling tickets

Getting Started

Core Concepts

Features

Workspace Management

Event Organizers

Attendees

​Access Requirements

​Billing Overview

Total Revenue

Your Earnings

Platform Fees

Transactions

​Revenue Calculation

​Billing Tabs

​Overview Tab

​Statistics Cards

​Monthly Earnings Chart

​Transactions Tab

​Transaction Information

​Payment Statuses

​Refund Processing

​Earnings Tab

​Earnings Breakdown

​Withdrawals Tab

​Withdrawal Requirements

Minimum Amount

KYC Verification

Available Balance

Valid Account

​Requesting a Withdrawal

KYC Documents

​Withdrawal Status

​Fee Structure

​Platform Fee

​Payment Provider Fees

​Refund Penalty

​Billing Data Structure

​Payment Record

​Best Practices

​Troubleshooting

​Revenue Optimization Tips

Strategic Pricing

Early Bird Discounts

Tiered Tickets

Minimize Refunds

​Next Steps

Complete KYC

Manage Team

Configure Settings

Create Events

Build docs developers (and LLMs) love

Access Requirements

Billing Overview

Revenue Calculation

Billing Tabs

Overview Tab

Statistics Cards

Monthly Earnings Chart

Transactions Tab

Transaction Information

Payment Statuses

Refund Processing

Earnings Tab

Earnings Breakdown

Withdrawals Tab

Withdrawal Requirements

Requesting a Withdrawal

Withdrawal Status

Fee Structure

Platform Fee

Payment Provider Fees

Refund Penalty

Billing Data Structure

Payment Record

Best Practices

Troubleshooting

Revenue Optimization Tips

Next Steps