If you're running a scavenger hunt, team-building event, or paid tour using PlayTours, you can now accept payments directly with Stripe. This integration allows you to sell access per device, and PlayTours will automatically send access links once a payment is confirmed.
The best part? There are no additional subscription fees for using Stripe with PlayTours. Stripe only charges per transaction, as detailed on their official pricing page.
This tutorial will walk you through each step from enabling the integration to creating a working payment flow, so you can start collecting payments in less than 15 minutes.
Why Stripe + PlayTours Is a Perfect Solution For Organizers
This integration is designed for event organizers who want a secure, automated way to collect payments and grant access. It’s ideal for:
- Corporate team-building events
- School or university challenges
- Guided city or museum tours
- Public scavenger hunts or fundraising games
You only need to set it up once. After that, players can pay, receive their access link automatically, and start playing, no manual intervention required.
Step-by-Step Tutorial: Set Up Stripe with PlayTours
Step 1: Enable Stripe Integration on PlayTours
- First, you need to have already created your game on PlayTours Admin Account.
- Go to your PlayTours Organisation Settings:
https://admin.playtours.app/organisation - Enable the toggle for “Enable Stripe Integration.”
This activates Stripe payment support for your account.
Step 2: Prepare Your Game Session
- Create a session for your game.
- Click “Manage” and copy the Game Code shown on the page.
This Game Code will be used later to identify your session within Stripe.
Next, go to the “Configure” tab of your session.
- Customize the email message that players will receive after payment.
- Ensure you include team link in your message. This placeholder is required; it automatically inserts the unique access link for each team.
Step 3: Set Up a Stripe Account
If you don’t already have a Stripe account:
- Sign up here: https://dashboard.stripe.com/register
- Complete the identity verification process.
- Upload any documents that Stripe requests.
Stripe is a trusted payment processor used by businesses worldwide and supports multiple currencies.
Step 4: Create a Product in Stripe
- In your Stripe dashboard, go to Product catalog from the left sidebar.
2. Click “Create product.”
- Enter the product name (e.g., “City Scavenger Hunt” or “Team Building Access”).
- Save the product.
This product will be linked to your payment page.
Step 5: Create a Payment Link
- Go to the Payment Links section in Stripe.
2. Click “New” and select your product.
- Configure purchase settings:
- If your teams use one device only, set quantity to 1 and disable quantity adjustments.
- If you allow multiple devices, enable quantity adjustment so users can pay for more than one.
4. Click “Create link.”
This payment link is what you’ll share with participants.
Step 6: Add Required Metadata to the Payment Link
After creating the link, go to the Payment Links section again and edit the link metadata.
You must add both of the following fields:
1. playtoursgamecode - Paste your PlayTours session Game Code (e.g., LWIP, XZYV)
2. playtourscostperdevice - Input the cost per device (e.g., 10 for $10/device). This is required to calculate the number of devices that the customer has paid for.
This metadata enables PlayTours to process the payment and deliver access appropriately.
Step 7: Set Up a Webhook in Stripe
Webhooks allow Stripe to notify PlayTours when a payment is completed.
- Go to the Developers section at the bottom left of the Stripe dashboard.
- Click “Webhooks” then tab “Create an event destination.”
3. Configure as follows and enter the following Endpoint URL: https://asia-northeast1-monabrun-cff9c.cloudfunctions.net/stripe
- Click “Select events” and choose: checkout.session.completed
- Save your configuration.
This step ensures that PlayTours can detect when a customer has paid and automatically send the game access link.
Final Step: Share the Payment Link with Players
Now that the payment setup is complete, you can:
- Embed the payment link on your event website
- Send it directly to participants by email or message
- Link it from a registration form or event landing page.
Once someone completes a payment, they’ll automatically receive their access email with a personalized game link.
This integration is a scalable solution if you’re running paid games or want to simplify participant onboarding. Whether you're hosting a one-time event or offering recurring public tours, the Stripe + PlayTours workflow saves time, reduces manual work, and keeps your event operations smooth.
Need Help?
If you get stuck or want help reviewing your setup, reach out to the PlayTours team at:
hello@playtours.app .
We’re happy to walk you through it or help troubleshoot.