Back to Docs

Settings


The Settings page is your control center for managing your PlayerPing account, notification preferences, and credit balance. This guide covers all available settings.


Accessing Settings


Navigate to Settings from the main menu or bottom navigation (on mobile).


Settings Overview


The Settings page includes these main sections:

  • Credits - View balance and purchase credits
  • Invite friends - Share invite link / email; earn credits when friends join
  • Notification Settings - Configure SMS, Email, and WhatsApp preferences
  • Push Notifications - Browser push alerts
  • API Keys - Create and revoke keys for the public API
  • Account Security - Change your password
  • Danger Zone - Permanently delete your account

Credits Section


Viewing Balance


Your current credit balance is displayed prominently:

  • Large Number - Shows current credit count
  • "Credits" label
  • Updates automatically after purchases

Understanding Credits


  • Email notifications - Free (no credits)
  • SMS notifications - 1 credit per player
  • WhatsApp notifications - 1 credit per player (coming soon)

New accounts start with 50 credits.


Purchasing Credits


  • Select Package
  • Three packages available:
  • 671 Credits - $5.00
  • 1,383 Credits - $10.00
  • 2,097 Credits - $15.00
  • Click on desired package

  • Complete Payment
  • Redirected to Stripe Checkout
  • Enter payment information
  • Complete transaction

  • Credits Added
  • Credits added automatically
  • Success message displayed
  • Balance updates immediately

See Credits & Notifications for detailed credit information.


Invite Friends


Share your personal invite link from Settings. When a friend registers with your link, you earn 30 free credits. You can copy the link, use device share, or send an email invite (email is free). The page also shows successful joins and credits earned.


Notification Settings


SMS Notifications


Toggle Switch:

  • ON (blue) - SMS notifications enabled
  • OFF (gray) - SMS notifications disabled

When Enabled:

  • SMS sent when pinging players
  • Costs 1 credit per player
  • Sent immediately with event details

When Disabled:

  • No SMS notifications sent
  • Saves credits
  • Email still sent (if enabled)

Best For:

  • Urgent invitations
  • Players who prefer text messages
  • Important events

Email Notifications


Toggle Switch:

  • ON (blue) - Email notifications enabled
  • OFF (gray) - Email notifications disabled

When Enabled:

  • Email sent when pinging players
  • Free (no credits required)
  • Includes detailed event information

When Disabled:

  • No email notifications sent
  • Only SMS/WhatsApp sent (if enabled)

Best For:

  • Standard invitations
  • Detailed event information
  • Cost-effective communication

WhatsApp Notifications


Status: Coming Soon


Toggle Switch:

  • Currently disabled (grayed out)
  • Will be enabled when feature launches

When Available:

  • WhatsApp messages sent when pinging players
  • Costs 1 credit per player
  • Rich messaging support

Best For:

  • International players
  • Popular messaging platform
  • Enhanced communication

Push Notifications


Receive free browser notifications when players RSVP, send chat messages, or when events are coming up. Works even when the app is in the background (supported browsers: Chrome, Edge, Firefox on desktop or Android).


  • Open Settings and find Push Notifications
  • Toggle Enable push notifications
  • Allow notifications when the browser prompts you

Disable anytime from the same toggle. If your browser does not support push, Settings shows a short explanation.


API Keys


Create API keys to manage players, events, clubs, teams, tournaments, and RSVPs programmatically.


  • Enter a name for the key (e.g. integration name)
  • Click Create API key
  • Copy the secret immediately — it is shown only once
  • Use it as `Authorization: Bearer ` against `/api/v1/*`

You can have up to 10 active keys. Revoke unused or leaked keys from the same section. Revoked keys disappear from the list and stop working immediately. See Public API for endpoint details.


Saving Settings


Automatic Saving


  • Notification toggles save immediately when changed
  • No "Save" button needed for toggles
  • Changes take effect right away

Manual Save


  • Click "Save Settings" button to ensure all changes are saved
  • Button appears below notification settings
  • Shows "Saving..." while processing

Confirmation


  • Success message appears after saving
  • Settings are stored permanently
  • Changes apply to future invitations

Recommended Settings


Cost-Effective Setup


  • ✅ Email - Enabled (free)
  • ❌ SMS - Disabled (saves credits)
  • ❌ WhatsApp - Disabled (not available yet)

Best for: Users who want to minimize costs


Maximum Reach Setup


  • ✅ Email - Enabled (free)
  • ✅ SMS - Enabled (for urgent events)
  • ✅ WhatsApp - Enabled (when available)

Best for: Users who want maximum notification delivery


Balanced Setup


  • ✅ Email - Enabled (primary method)
  • ⚠️ SMS - Enabled selectively (for important events)
  • ❌ WhatsApp - Disabled (until needed)

Best for: Most users, balances cost and reach


Managing Your Account


Changing Your Password


From Settings, scroll to the Account security section:


  • Enter your current password
  • Enter and confirm your new password
  • Click Update password

Your new password must be at least 8 characters and include uppercase, lowercase, and a number.


Changing your password ends other sessions and revokes all API keys. Create new keys in Settings if you still need programmatic access.


Forgot Your Password


If you are logged out:


  • Go to the login page
  • Click Forgot password?
  • Enter your email address
  • Check your email for a reset link (expires in 1 hour)
  • Set a new password and sign in

Resetting via the email link also signs you in with a fresh session. If you changed the password while logged in (Account security), all API keys are revoked.


Deleting Your Account


From Settings, scroll to the Danger zone section:


  • Read the warning — this permanently deletes all your data
  • Enter your current password
  • Type your account email to confirm
  • Click Delete my account

This removes your players, events, clubs, API keys, unused credits, and billing records. This action cannot be undone.


Profile Information


Account profile information is managed during registration:

  • Email address (used for login)
  • Password (change from Settings or via forgot-password reset)

Account Security


  • Use strong passwords
  • Keep login credentials secure
  • Log out when using shared devices

Settings Best Practices


Notification Preferences


  • Start with Email - Enable email as primary method
  • Add SMS Selectively - Enable SMS for important events
  • Monitor Credits - Keep track of credit balance
  • Adjust as Needed - Change settings based on usage

Credit Management


  • Check Balance Regularly - Monitor credit usage
  • Purchase Before Needed - Buy credits in advance
  • Use Free Options - Rely on email when possible
  • Track Spending - Understand credit consumption

Optimization Tips


  • Email First - Use free email notifications primarily
  • SMS for Urgent - Reserve SMS for important events
  • Combine Methods - Use both for maximum reach
  • Review Regularly - Adjust settings based on results

Troubleshooting


Settings Not Saving


  • Ensure you clicked "Save Settings"
  • Check internet connection
  • Refresh the page
  • Try again

Credits Not Updating


  • Refresh the Settings page
  • Verify payment was successful
  • Check Stripe transaction status
  • Contact support if needed

Notifications Not Working


  • Verify settings are enabled
  • Check credit balance (for SMS/WhatsApp)
  • Confirm player contact information
  • Review notification preferences

Can't Purchase Credits


  • Check internet connection
  • Verify payment method
  • Ensure Stripe loads properly
  • Try different browser

Toggle Not Responding


  • Refresh the page
  • Check browser compatibility
  • Try clicking again
  • Clear browser cache

Status Messages


Success Messages


  • Green Background - Settings saved successfully
  • Green Background - Payment successful, credits added

Error Messages


  • Red Background - Failed to save settings
  • Red Background - Payment failed or error occurred

Information Messages


  • Yellow Background - Payment canceled (no charges)

Related Guides




*Need help with credits? Check out the Credits & Notifications guide!*


Previous: Credits & NotificationsNext: Public API
Back to Documentation Index