Stripe Setup
Updated 2 weeks ago
Stripe Setup
Use Stripe Setup when your organization is ready to accept credit card donations and sponsorship payments. The recommended setup path uses Stripe Connect from Organization settings > Payment gateways.
Open Organization settings from the account menu when you need to manage account-wide payment setup.
Create or Prepare Your Stripe Account
Use Stripe when your organization wants card payments to move through a Stripe account your team owns.
Go to stripe.com and create a Stripe account, or sign in to the Stripe account your organization already uses.
Complete the business, identity, and payout verification steps Stripe asks for.
Add the bank account or payout details Stripe requires before live payments can be processed.
Return to Gratona to connect Stripe from Organization settings > Payment gateways.
You do not need to copy API keys for the recommended Stripe Connect flow. Stripe handles the connection on its hosted setup pages in the current tab.
Open Payment Gateways
Use Payment gateways when you need to connect or review the payment providers available to your account.
Open the account menu at the bottom of the sidebar.
Select Organization settings.
Select Payment gateways.
Payment gateways is the Organization settings area for Stripe Connect and other payment providers.
Connect Stripe
Use Stripe Connect when you want Stripe to handle credit card payment processing for the account. Use the Stripe Connect card and available action to review the connection for your workspace.
Use the current action and status on the Stripe Connect card rather than inferring the integration type from the visible tab. If the expected Stripe Connect card or action is unavailable, contact Gratona support.
Select Set up Stripe on the Stripe Connect card.
Choose Use an existing Stripe account or Create a new Stripe account. For a new account, review the Base currency and choose the Registration country before continuing.
Complete the Stripe Connect setup steps in Stripe.
Stripe opens in the current tab. After Stripe sends you back to Gratona, the app shows whether Stripe Connect was completed successfully or if setup failed.
If Stripe Connect is already configured, use View payments or, depending on the connection state, Continue in Stripe or Open Stripe when you need to review the connected Stripe account.
Disconnecting Stripe Connect removes that connection and prevents processing through the disconnected Stripe account until it is connected again. Only disconnect Stripe Connect when your organization is ready to stop processing payments through that connected Stripe account.
Enable Credit Cards for a Program
After Stripe is connected for the account, turn on credit card processing for each program setting that should accept card payments.
Open Program Setup.
Open the program setting you want to update.
In Order Page Options, enable Use Credit Card processing (Stripe setup in the Account).
Save the program setting when you are ready for the change to go live.
Program settings control whether a specific program can use credit card processing after Stripe is connected.
Legacy Stripe API Keys
Some older accounts may still use legacy Stripe API keys instead of Stripe Connect. In that flow, Stripe appears under the Payment Gateways tab with a drawer for the private key, public key, and webhook signing secret.
If Gratona support directs you to use the legacy flow, sign in to Stripe and open Developers > API keys. Use live keys when you are ready to accept real payments. Test keys should only be used for testing.
Use the legacy flow only when your account is already configured that way or Gratona support directs you to use it. For webhook details, see Stripe Webhook.