Payment Service Providers

Learn how to set up Payment Service Providers (PSP) like PayPal, Stripe, and Patreon with GSA to process payments for your community.

All funds go directly to your PayPal, Stripe, or Patreon account. GSA does not charge any transaction fees.

How does it work?

When a player purchases a Tier, GSA instructs your Payment Service Provider (PSP) to charge the player for the corresponding amount.

Once the payment is completed, GSA verifies its success and delivers the Supporter Tier automatically.

This communication happens behind the scenes using API keys, which you’ll set up in the steps below.

Keep your API keys safe

GSA staff will never ask for your password or API keys. Do not share them with anyone.

Connect PayPal

1. PayPal developers site

Go to developer.paypal.com and log in with a valid PayPal account.

2. Create REST API apps

Ensure you are in LIVE mode.

Click Apps & Credentials in the top menu, then click Create App.

3. Create App

Enter GSA API (or a similar name) in the App Name field.
Click Create App to proceed.

4. Configure API features

Before copying your API keys, scroll to the Features section and grant the required permissions.

Enable Vault and Subscriptions, then click Save Changes.

Only enable Vault and Subscriptions

For security, only activate these two features.

5. Setup webhook

Below the API features section, you can configure webhooks.

info

Webhooks are required for subscriptions. Without them, subscriptions won’t function.

5.1 Add webhook

Click Add Webhook.

5.2 Find your GSA webhook URL

Copy your unique webhook URL from the GSA dashboard and paste it into the Webhook URL field on the PayPal site.

5.3 Activate events

Only check the following events:

• Payment sale completed (under Payments & Payouts)
• Billing subscription cancelled (under Billing subscription)
• Billing subscription expired (under Billing subscription)

Then, save the webhook.

5.4 Confirm

Double-check that only Payment sale completed is tracked.

6. Enter API keys on GSA

Copy your Client ID and Secret from PayPal and paste them into the GSA PayPal settings page.

Done!

After saving the PayPal settings form, your PayPal integration is complete.

Connect Stripe

1. Stripe log in

Go to dashboard.stripe.com and log in with a valid Stripe account.

Stripe account ready?

Make sure your account has completed Stripe’s onboarding process. Test-mode accounts cannot be connected.

2. Click Create restricted key

Visit the API keys page under the Developers section.

Click Create restricted key.

3. Setup name

Name the key GameServerApp.

4. Configure permissions

Enable the following:

• All Checkout resources: Write
• All Billing resources:
  • Prices: Write
  • Subscriptions: Write
• All Webhook resources: Write

caution

Only enable the permissions listed above for optimal security.

Click Create key to continue.

6. Enter API keys on GSA

Click Reveal live key to display your key.

Copy the Restricted key and paste it into the GSA Stripe settings page.

Done!

After saving the Stripe settings form, your Stripe integration is complete.

Connect Patreon

1. Connect Patreon

Click Connect your Patreon on the GSA Patreon settings page.

2. Grant access

Authorize GSA to access your pledge tiers and subscribers.

After granting access, GSA will begin syncing your Patreon pledges.

3. Create Tiers for pledges

Click Create Supporter Tier for each Patreon pledge you want to link to GSA.

When someone subscribes or renews a Patreon pledge, the connected Supporter Tier will be executed by GSA.
If a pledge ends, GSA will automatically remove the corresponding Supporter Tier.
Changes to pledges are handled automatically.

You can view all active Patreon subscriptions on the Subscription overview.