Skip to main content
PassTru offers two ways to purchase tokens: online payment via Stripe or manual top-up by a Super Admin.

​
Online Purchase via Stripe

The primary method for purchasing tokens is through Stripe Checkout.

​
Purchase Process

1

Navigate to Purchase Tokens

From the Client Portal sidebar, click Tokens or go to /purchase.
2

View current balance

At the top of the page, you’ll see two cards displaying:
  • Current Event Tokens balance
  • Current Attendee Tokens balance
3

Select token quantities

Use the sliders or input fields to select:
  • Number of event tokens (0–25)
  • Number of attendee tokens (0–3,000)
The calculator shows real-time pricing based on volume tiers.
4

Review pricing

The page displays:
  • Rate per unit for your selected quantity (based on pricing tiers)
  • Breakdown: quantity × rate for each token type
  • Estimated Total cost in RM
5

Click Purchase via Stripe

Click the Purchase via Stripe button at the bottom right.
6

Complete Stripe Checkout

  • A new browser tab opens with Stripe Checkout
  • Enter your payment details (card number, expiry, CVC)
  • Complete the payment
7

Confirmation

  • After successful payment, you’re redirected back to PassTru
  • A success toast notification confirms the purchase
  • Tokens are credited to your balance within moments
The Stripe Checkout opens in a new browser tab. Do not close the original PassTru tab while the payment is processing.

​
Payment Status Handling

After completing or cancelling a Stripe Checkout session:

​
Successful Payment

  • You’re redirected to /purchase?status=success
  • A green toast notification: “Payment successful! Tokens will be credited shortly.”
  • Your token balance is updated automatically
  • Refresh the page if you don’t see the updated balance immediately

​
Cancelled Payment

  • You’re redirected to /purchase?status=cancelled
  • A blue info toast: “Payment was cancelled.”
  • No tokens are deducted or added
  • You can retry the purchase at any time

​
Important Notes

You can only purchase one token type per transaction. If you select both event and attendee tokens, the system will process the event token purchase first. You’ll need to make a separate transaction for attendee tokens.

​
Edge Function Integration

The purchase process uses the create-checkout-session edge function: 
// Example request
{
  token_type: "event",  // or "attendee"
  quantity: 10
}
The function:
  • Validates your organization ID
  • Fetches the current pricing tier for the quantity
  • Creates a Stripe Checkout session
  • Returns the Checkout URL

​
Manual Top-Up by Super Admin

For organizations with special arrangements or enterprise agreements, Super Admins can manually add tokens.

​
Manual Top-Up Process

1

Super Admin access

Super Admin logs in and navigates to /super-admin/clients.
2

Select your organization

Super Admin finds your organization in the client list.
3

Edit Package

Super Admin clicks Edit Package on your organization row.
4

Adjust token allocations

Super Admin modifies:
  • Event Tokens — adds to your current balance
  • Attendee Tokens — adds to your current balance
5

Save changes

Super Admin saves the changes, and tokens are immediately available in your account.

​
When to Use Manual Top-Up

  • Enterprise agreements — Organizations with negotiated bulk pricing
  • Promotional credits — Free tokens as part of a campaign or trial
  • Payment issues — Temporary token allocation while resolving payment problems
  • Custom arrangements — Special pricing or packages not available through Stripe

​
Troubleshooting

​
Payment Failed

If your Stripe payment fails:
  • Check your card details and billing address
  • Ensure your card has sufficient funds
  • Try a different payment method
  • Contact your bank if the issue persists

​
Tokens Not Credited

If you completed payment but don’t see tokens in your balance:
  1. Refresh the page — Token updates are near-instant but may require a page refresh
  2. Check payment status — Verify the payment succeeded in your Stripe receipt email
  3. Contact support — If tokens aren’t credited within 5 minutes, contact your Super Admin with your payment receipt

​
Cannot Purchase

If the Purchase via Stripe button is disabled:
  • Ensure you’ve selected at least one token type with a quantity > 0
  • Verify the total cost is greater than RM 0.00
  • Check that you’re not already in a pending checkout session

​
Viewing Token Usage

To track how your purchased tokens are being used:
  • Dashboard (/dashboard) — See current balance and active events
  • Reports (/reports) — Download event data showing attendee counts
  • Event List (/events) — View all events and their attendee numbers

​
Next Steps

After purchasing tokens:

Create Events

Use your event tokens to create new events.

Add Attendees

Upload attendees to your events using attendee tokens.

Build docs developers (and LLMs) love

Get started for freeTalk to us