Skip to main content

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 money goes straight to your PayPal, Stripe or Patreon account. GSA charges no fees for any transaction.

How does it work?

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

When a payment is finished GSA will verify if the payment was successful and deliver the Supporter Tier.

Communication between GSA and the PSPs happen behind the scenes using the API keys you learn to set up 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. PayPay developers site​

Navigate to developer.paypal.com and log in. You need to have a valid PayPal account for this.

2. Create REST API apps​

First, make sure you are using the LIVE mode

Then click Apps & Credentials in the top menu and hit Create App.

Monetization - Payment Service Provider - Set up PayPal 1

3. Create App​

Enter GSA API (or something similar) in the App Name field.
Hit Create App to continue.

Monetization - Payment Service Provider - Set up PayPal 2

4. Configure API features​

Before you can copy your API keys, you need to grant the necessary permissions to the new API keys.
Scroll down to the Features section.

Monetization - Payment Service Provider - Set up PayPal 3

Enable Vault and Subscriptions. Then click Save Changes.

Only enable Vault and Subscriptions

For security reasons we recommend you only enable Vault and Subscriptions.

Monetization - Payment Service Provider - Set up PayPal 4

5. Setup webhook​

Underneath the API features section you can set up webhooks.

info

Webhooks are used for subscriptions. Without webhooks your subscriptions won't work.

5.1 Add webhook​

Click Add Webhook to add your personal GSA webhook url.

Monetization - Payment Service Provider - Set up PayPal webhook 1

5.2 Find your personal GSA webhook url​

Copy your unique webhook URL from your GSA dashboard and enter it in the Webhook URL field on the PayPal developer website.

Monetization - Payment Service Provider - Set up PayPal webhook 2

Monetization - Payment Service Provider - Set up PayPal webhook 3

5.3 Activate event​

Ensure only the following checkboxes are checked:

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

Now you can save the webhook.

Monetization - Payment Service Provider - Set up PayPal webhook 4

Monetization - Payment Service Provider - Set up PayPal webhook 4.1

5.4 Confirm​

Confirm that the webhook only tracks Payment sale completed events.

Monetization - Payment Service Provider - Set up PayPal webhook 5

6. Enter API keys on GSA​

Copy the Client ID and Secret from PayPal over to the PayPal settings page at GSA.

Monetization - Payment Service Provider - Set up PayPal 5

Done!

After saving the PayPal settings form on the dashboard your PayPal account is successfully configured.

Connect Stripe​

1. Stripe log in​

Navigate to dashboard.stripe.com and login. You need to have a valid Stripe account for this.

Stripe account ready?

Make sure your Stripe account has gone through all the steps to accept payments. You won't be able to connect a Stripe account in test-mode.

2. Click Create restricted key​

Go to the API keys page, under Developers.

Click Create restricted key to generate the API key.

Monetization - Payment Service Provider - Set up Stripe 1

3. Setup name​

Enter "GameServerApp" in the Key name field.

Monetization - Payment Service Provider - Set up Stripe 2

4. Configure permissions​

Enable the following permissions:

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

Monetization - Payment Service Provider - Set up Stripe 3 Monetization - Payment Service Provider - Set up Stripe 4 Monetization - Payment Service Provider - Set up Stripe 5

caution

For security reasons we recommend you only enable the resources listed in this guide.

Click Create key to continue.

Monetization - Payment Service Provider - Set up Stripe 6

6. Enter API keys on GSA​

Click on Reveal live key to show your API key.

Copy the Restricted key from Stripe over to the Stripe settings page at GSA.

Monetization - Payment Service Provider - Set up Stripe 7

Done!

After saving the Stripe settings form on the dashboard your Stripe account is successfully configured.

Connect Patreon​

1. Connect Patreon​

Click Connect your Patreon on the Patreon settings page at GSA.

2. Grant access​

Grant GSA access to your pledge tiers and subscribers. After granting access GSA will gather information about your Patreon pledges.

Monetization - Payment Service Provider - Set up Patreon 1

3. Create Tiers for pledges​

Click Create Supporter Tier for each Patreon pledge that you want to use on GSA.

GSA will automatically execute the connected Supporter Tier actions when someone subscribes to a Patreon pledge or renews.

When a pledge ends GSA will end the Supporter Tier. Pledge changes are automatically handled by GSA.

All active Patreon subscriptions can be found on the Subscription overview.

Monetization - Payment Service Provider - Set up Patreon 2

In this article