TicketPayGo Documentation
Welcome to the TicketPayGo documentation. Here you'll find all the information to set up your events, sell tickets and check in visitors.
Quick Start (5 minutes)
Get your first event live in 5 steps. Follow this checklist to get started quickly.
Install Plugin
Download the plugin from your account portal and upload to WordPress via Plugins > Add New > Upload Plugin.
Activate License
Go to TicketPayGo > Settings and enter your license key. You receive this via email after signup.
Connect Payment Provider
Choose Stripe, PayPal or Mollie. Enter your API keys at Settings > Payments. This is a one-time setup.
Create Event
Go to TicketPayGo > Events > New Event. Fill in title, date, location and capacity.
Add Tickets
Add at least one ticket type with name and price. Publish the event and you're ready to sell.
Installation and Activation
System Requirements
- WordPress 5.0 or higher
- PHP 7.4 or higher
- SSL certificate (HTTPS) for payments
Install Plugin
- Log in to your TicketPayGo account
- Download the plugin (.zip file)
- In WordPress go to Plugins > Add New
- Click Upload Plugin and select the .zip file
- Click Install Now and then Activate
Activate License
- Go to TicketPayGo > Settings > License
- Enter your license key (received via email)
- Click Activate
One-time Setup
Configure these settings once. After that, you can create unlimited events.
Connect Payment Provider
Go to TicketPayGo > Settings > Payments. Choose your provider and enter the required details.
Stripe
- Log in to Stripe Dashboard
- Go to Developers > API keys
- Copy the Publishable key and Secret key
- Paste both in the plugin settings
- Configure the webhook URL (shown in the plugin)
PayPal
- Log in to PayPal Developer
- Create an app and copy Client ID and Secret
- Paste both in the plugin settings
- Configure the webhook URL (shown in the plugin)
Mollie
- Log in to Mollie Dashboard
- Go to Developers > API keys
- Copy the Live API key (or Test key for testing)
- Paste in the plugin settings
Email Templates
Go to TicketPayGo > Settings > Emails. Here you can customize:
- Confirmation email: Sent after successful payment
- Ticket email: Contains the QR code and event details
- Sender name and email: Customize to your organization name
Basic Settings
- Currency: Choose your default currency (EUR, USD, etc.)
- Date format: Set how dates are displayed
- Checkout page: Select or create a page for checkout
- Thank you page: Where visitors land after payment
Create Event
Go to TicketPayGo > Events > New Event to add an event.
Basic Information
- Title: The name of your event
- Description: Detailed information about the event
- Featured image: Shown on overview pages
Date and Time
- Start date: When the event begins
- End date: Optional, for multi-day events
- Start and end time: The times of the event
- Timezone: Automatically taken from WordPress
Location
- Venue name: Name of the venue
- Address: Street, number, postal code, city
- Online event: Check for virtual events
Capacity
- Maximum capacity: Total number of available spots
- Per ticket type: You can also set a limit per ticket type
Recurring Events
TicketPayGo supports recurring events:
- Daily, weekly, biweekly, monthly or yearly
- Select specific days (e.g., every Monday and Wednesday)
- Set an end date or number of repetitions
- Apply changes to all future instances
Set Up Tickets
Each event needs at least one ticket type. You can create multiple types.
Add Ticket Type
In the event edit screen, scroll to Tickets and click Add Ticket Type.
- Name: E.g., "Standard", "VIP", "Early Bird"
- Description: What's included with this ticket
- Price: Amount in your set currency
- Stock: Number of available tickets of this type
- Minimum/Maximum per order: How many can someone buy
Free Tickets
Set the price to 0 for free tickets. Visitors still go through checkout to fill in their details and receive a confirmation.
Paid Tickets
For paid tickets, the visitor is redirected to your provider's payment page. After successful payment:
- They receive a confirmation email
- They get an e-ticket with QR code
- They can add the ticket to Apple Wallet
Availability Period
- Sales start: From when tickets are available
- Sales end: Until when tickets can be purchased
Checkout & Emails
Checkout Process
The checkout process works as follows:
- Visitor selects tickets and quantity
- Fills in name and email address
- Chooses payment method (for paid tickets)
- Is redirected to payment provider
- Returns to thank you page after payment
Ticket Email
After successful payment, the buyer automatically receives:
- Confirmation email with order details
- QR code ticket directly in the email (PNG image)
- Link to add ticket to Apple Wallet
- Link to add event to calendar (Google Calendar, Apple Calendar, Outlook)
QR Code
Each ticket contains a unique QR code. This code:
- Is linked to the specific order
- Can only be scanned once
- Shows ticket type and name when scanned
Apple Wallet
Visitors can add their ticket to Apple Wallet via the link in the email. The ticket shows:
- Event name and date
- Location
- QR code for check-in
- Ticket type
"Manage your tickets" link
Every confirmation email automatically includes a "Manage your tickets" link at the bottom. This link allows customers to:
- View their order details and ticket status
- Resend tickets to their email if they lost them
- Access without needing a password or account
Setup (one-time)
- Go to TicketPayGo > Email Settings
- Check "Show 'Manage Tickets' Link" (enabled by default)
- Create a new page (e.g., "My Tickets")
- Add the shortcode
[ticketpaygo_order_lookup]to the page - Publish the page - done!
How it works for customers
When a customer clicks the "Manage your tickets" link in the email:
- They are directly sent to their order overview
- They see their tickets, event details, and order
- They can resend their tickets
- The link remains valid for 30 days
The link is secure and only works for the person who placed the order.
Scanner & Check-in
The web-based scanner works on any device with a camera. No app installation needed.
Set Up Scanner
- Go to TicketPayGo > Scanners
- Click Create New Scanner
- Give the scanner a name (e.g., "Main Entrance")
- Select which events the scanner works for
- Copy the scanner URL or scan the QR code with your phone
Scanning
- Open the scanner URL on your phone or tablet
- Grant permission for camera access
- Point the camera at the ticket's QR code
- The result appears directly on screen
Scan Results
- Green (Valid): Ticket is valid and now checked in
- Orange (Already scanned): Ticket was already checked in earlier
- Red (Invalid): Ticket not found or not valid for this event
Multiple Scanners
Depending on your subscription, you can use multiple scanners simultaneously:
- TicketPayGo: 1 scanner included
- TicketPayGo Multi: 3 scanners included
- Extra scanners: Available for €20 per month per scanner
Offline Mode
The scanner also works with poor internet connection:
- Scans are stored locally
- Automatic synchronization when connection is restored
- Visual indicator shows offline status
Live Statistics
While scanning you see in real-time:
- Number of checked-in visitors
- Total capacity
- Percentage present
Attendees & Export
Attendee Overview
Go to TicketPayGo > Orders to view all orders. Per order you see:
- Name and email address
- Purchased tickets and types
- Payment status
- Check-in status
- Order date
Filtering
Filter orders by:
- Event
- Ticket type
- Payment status (paid, pending, refunded)
- Check-in status
- Date range
Export to CSV
- Go to the orders overview
- Apply filters if needed
- Click Export
- Download the CSV file
The export contains all relevant fields and can be opened in Excel or Google Sheets.
Analytics Dashboard
View statistics per event:
- Revenue and number of tickets sold
- Distribution per ticket type
- Payment method distribution
- Check-in percentage
Styling & Shortcodes
TicketPayGo offers various shortcodes to display events and tickets on your website. Below you'll find an overview of all available shortcodes with their parameters.
Shortcodes Overview
| Shortcode | Purpose | Attributes |
|---|---|---|
[ticketpaygo_events] |
Show an overview of upcoming events | limit, layout, status, upcoming |
[ticketpaygo_event] |
Show a specific event with booking modal | id, layout |
[ticketpaygo_calendar] |
Interactive calendar view (FullCalendar.js) | view, category, filters |
[ticketpaygo_order_lookup] |
Order management page for customers to manage tickets | None (uses magic link from email) |
Events Overview Shortcode
Show an overview of your events on any page:
[ticketpaygo_events]
Available parameters:
limit="10"Number of events to show (default: 10)layout="grid"Display: grid, list, or card (default: grid)status="active"Filter by status (default: active)upcoming="true"Show only future events (default: true)
[ticketpaygo_events limit="6" layout="grid"]
Single Event Shortcode
Show a specific event with booking modal:
[ticketpaygo_event id="123"]
id="123"Event ID (required)layout="default"Layout template (default: default)
The template is loaded from templates/event-{layout}.php. The default template is event-default.php.
Calendar View
Show events in an interactive calendar (uses FullCalendar.js):
[ticketpaygo_calendar]
view="dayGridMonth"View: dayGridMonth, timeGridWeek, timeGridDay, listMonthcategory=""Filter by category (optional)filters="true"Show view filters above calendar (default: true)
Order Management Shortcode
Create a page where customers can manage their tickets:
[ticketpaygo_order_lookup]
This shortcode:
- Shows order details when customers arrive via the magic link from their email
- Provides a form to request a new magic link
- Allows customers to resend their tickets
- Works without customers needing to log in
Customization Settings
Via TicketPayGo > Customization you can adjust the following settings without code:
- Image area background color
- Content area background color
- Button colors
- horizontal or vertical
- small, medium, or large
- Visual effects
Google Analytics and Facebook Pixel
TicketPayGo automatically integrates with:
- Google Analytics 4: E-commerce events for view_item, add_to_cart, begin_checkout, and purchase
- Facebook Pixel: ViewContent, AddToCart, InitiateCheckout, and Purchase events
Configure your tracking IDs at TicketPayGo > Settings > Integrations.
Elementor Integration
TicketPayGo seamlessly integrates with Elementor, allowing you to design event pages with full visual control. When Elementor is detected, TicketPayGo automatically registers custom widgets.
Available Widgets
Find these widgets in the Elementor panel under the "TicketPayGo" category:
Event Card
Display a single event with full styling control. Select any event and customize colors, typography, and layout directly in Elementor.
Events Grid
Show multiple events in a responsive grid or list layout. Control columns, spacing, and which events to display.
Events Calendar
Interactive calendar view with customizable colors. Visitors can browse events by month, week, or day.
How to Use Elementor Widgets
Open Elementor Editor
Edit any page with Elementor. In the widget panel, search for "TicketPayGo" or scroll to the TicketPayGo category.
Drag Widget to Page
Drag the Event Card, Events Grid, or Calendar widget to your desired location on the page.
Select Event(s)
In the Content tab, select which event to display (for Event Card) or configure filters (for Events Grid).
Customize Styling
Switch to the Style tab to customize colors, typography, spacing, and more. You can use global styles or override them per widget.
Styling Options
Each widget offers comprehensive styling controls in the Style tab:
Card Style
- Card background color
- Image area background
- Content area background
- Title and text colors
- Icon and price colors
- Border radius and box shadow
Button Style
- Background and text colors
- Hover colors
- Typography (font, size, weight)
- Padding and border radius
- Border and box shadow
Modal Style
- Header background
- Body background and text colors
- Info grid colors
- Modal button styling
- Price color
Per-Event Customization
You can also set custom styling per event in TicketPayGo > Events > Edit Event. These styles will be applied when displaying that specific event, whether via shortcode or Elementor widget. Elementor widget styles take precedence when "Use Global Styles" is disabled.
Tips for Best Results
- Use Elementor's preview mode to see exactly how your events will look
- Test on different screen sizes using Elementor's responsive mode
- Set up your global styles first in TicketPayGo > Customization, then override only where needed
- For consistent branding, use the same colors across all event widgets
Troubleshooting
Below you'll find solutions for the most common problems.
1. Payments not coming through
Cause: Webhook not correctly configured.
Solution: Check if the webhook URL is correctly set up with your payment provider. You can find the URL at TicketPayGo > Settings > Payments. Make sure your site uses HTTPS.
2. Emails not being sent
Cause: WordPress cannot send emails.
Solution: Install an SMTP plugin like WP Mail SMTP and configure with your email provider. Test with the built-in test function.
3. Scanner shows "No connection"
Cause: REST API blocked or poor internet connection.
Solution: Check if the WordPress REST API is accessible. Some security plugins block the API. Add an exception for the TicketPayGo endpoints.
4. QR code not recognized
Cause: Poor lighting or damaged QR code.
Solution: Ensure sufficient light. Ask the visitor to increase screen brightness. For a printed ticket: check if the print is not faded.
5. Ticket shows "Already checked in" but visitor is new
Cause: Ticket was forwarded or screenshot shared.
Solution: Check the check-in time in the system. Each ticket can only be used once. The original buyer may have shared the ticket.
6. Events not showing on website
Cause: Event not published or shortcode missing.
Solution: Check if the event is set to "Published". Add the shortcode [ticketpaygo_events] to the desired page.
7. License cannot be activated
Cause: License already active on another domain or expired.
Solution: Log in to your account portal and deactivate the license on the old domain. Check if your subscription is active.
8. Checkout page shows error
Cause: Conflict with another plugin or theme.
Solution: Temporarily disable other plugins to identify the conflict. Check the browser console for JavaScript errors.
9. Apple Wallet ticket not working
Cause: SSL certificate problem or server configuration.
Solution: Check if your site has a valid SSL certificate. The .pkpass files require specific MIME types. Contact support if the problem persists.
10. Slow load times with many events
Cause: Hosting not powerful enough or no caching.
Solution: Use a caching plugin like WP Super Cache or W3 Total Cache. Consider better hosting for events with many visitors. Limit the number of events per page with the limit parameter.
Frequently Asked Questions
Which payment providers are supported?
TicketPayGo supports Stripe, PayPal and Mollie. Each provider has webhook handling, automatic refunds and a test mode.
Can I create multiple ticket types?
Yes. Create VIP, Early Bird, Standard or any desired type with their own prices, capacity and availability periods.
Does it work on mobile?
Yes. The entire experience is mobile-first, from the booking form to the e-ticket. Tickets can also be added to Apple Wallet.
How does scanning work with multiple staff?
Create a scanner per staff member or entrance. Each scanner has its own URL that can be opened on any device. Scans are synchronized in real-time.
Does it support recurring events?
Yes. Set up daily, weekly, biweekly, monthly or yearly recurrence. Select specific days and set an end date.
Do I need WooCommerce?
No. TicketPayGo works standalone. If WooCommerce is installed, it automatically integrates with account recognition and My Account page.
Can I customize the ticket templates?
Yes. Copy templates to your theme to customize them, or use the visual customizer for colors and fonts without code.
What happens when my subscription expires?
You cannot create new events and the scanner stops working. Existing tickets remain valid and visitors can still view their tickets.
Are there costs per ticket sold?
No. You pay a fixed monthly amount regardless of how many tickets you sell. The only extra costs are the transaction fees from your payment provider.
Can I process refunds?
Yes. Refunds can be processed via your payment provider dashboard. The ticket status is automatically updated via the webhook.