Payment providers

A payment provider is your organisation's connection to a payment service: Stripe, PayWay, Payfast, or a simulated provider used for testing. This page covers the settings every provider shares. To connect a real account, see Connecting Stripe or Connecting PayWay or Payfast.

A provider does not decide by itself which donations it takes. Your payment routes decide that, by currency.

Find your payment settings

1. Select Settings in the sidebar.
2. Select the Payments tab.

The tab shows four panels, in this order:

• Currencies: the currencies your organisation accepts. See Currencies and routes.
• Providers: your payment providers. Described below.
• Routes: which provider takes a donation in each currency. See Currencies and routes.
• Tipping: whether donors can add a tip. See Tipping.

Only administrators can use these settings.

The Providers panel

The Providers panel lists every provider with these columns:

• ID: select it to open the provider.
• Name: the provider's title. The default provider has a Default label.
• Type: Simulation, Stripe, PayWay or Payfast.
• Status: one of the statuses below.

A club can only go live if every currency it accepts is routed to a provider that is Ready. See Currencies and routes.

Add a provider

1. On the Providers panel, select Add provider.
2. Under Choose a payment provider, select one card: Simulation, Stripe, PayWay or Payfast.
3. Select Continue.

What happens next depends on the type:

• Stripe opens the Connect a Stripe account screen. See Connecting Stripe.
• Simulation, PayWay and Payfast open the Configuration step. Enter a Title ("Short title for this payment provider") and the fields for that type, then select Create payment provider. The Title can't be left empty.

A new Simulation provider takes you back to the Payments tab. A new PayWay or Payfast provider has its credentials checked first, then opens the provider's own screen showing the result, or the Payments tab if the check couldn't be completed. See Connecting PayWay or Payfast.

To leave without adding anything:

• On Choose a payment provider, Cancel returns to the Payments tab.
• On Configuration, Cancel deletes the unfinished provider straight away, without asking you to confirm.

View a provider

Select a provider's ID in the Providers panel. The provider's screen shows its Type, whether it is the Default, and its Status.

Some providers open somewhere else instead:

• A Stripe provider you haven't finished connecting, or one that is still Awaiting Stripe, opens the Connect a Stripe account screen.
• Any other provider you haven't finished adding opens its Configuration step.

The buttons at the top of the provider's screen are:

• Edit.
• Verify credentials, for a PayWay or Payfast provider that has its credentials stored.
• One of these, depending on the provider:
  • Enable, if the provider is disabled.
  • Disable, if it is a Stripe provider with a connected account.
  • Delete, for any other provider.

The built-in Simulated Payment provider is never offered Disable or Delete.

Edit a provider

1. Open the provider and select Edit.
2. Change the Title and any fields for that type. A Stripe provider has only the Title.
3. Select Save changes.

After saving, you go back to the Payments tab. A PayWay or Payfast provider has its credentials checked again first, and then you land on the provider's own screen instead, or on the Payments tab if the check couldn't be completed.

The Edit payment provider screen also has these actions at the top:

• Enable, if the provider is disabled, or Disable, if the provider can be disabled.
• A More menu with Set as default (only if this provider is not already the default) and Delete (only if the provider can be deleted).

Set a default provider

1. Open the provider and select Edit.
2. Select More > Set as default.

The provider becomes your organisation's only default, and the Default label moves to it in the Providers panel.

Being the default does one thing: the default provider can't be disabled or deleted. It does not make the provider take donations. Your payment routes decide which provider takes each donation.

Disable or enable a provider

To disable a provider:

1. Open the provider, or its Edit screen, and select Disable.
2. On Disable payment provider, read the warning: "Doing so will mean that this payment provider can't be used by any payment routes."
3. Select Disable payment provider. To keep it, select Cancel.

Disabling is refused while the provider is still in use. The screen says "This payment provider can't be disabled because:" and lists each reason:

• "it is the default payment provider". Make another provider the default first.
• "it is being used by" a number of payment routes. Change or delete those routes first. See Currencies and routes.

A disabled provider can't be chosen for a payment route.

To turn a disabled provider back on, open it and select Enable. It is enabled straight away, and you return to the Payments tab.

Delete a provider

1. Open the provider and select Delete. You can also select More > Delete on its Edit screen.
2. On Delete payment provider, read the warning: "This action is permanent and can't be undone."
3. Select Delete payment provider. To keep it, select Cancel.

Deleting is refused while the provider is in use or has been used. The screen says "This configuration can't be deleted because:" and lists each reason:

• "it is the default payment provider".
• "it is being used by" a number of payment routes.
• "it has been used by" a number of payments "in the past". Once any donation has been sent to a provider, the provider can never be deleted. Disable it instead.

A Stripe provider that holds a connected Stripe account is never deleted, even if you confirm on the delete screen. You return to the Payments tab and the provider is still there. Disable it instead.

The Simulated Payment provider

Every organisation starts with a provider called Simulated Payment, of type Simulation. It starts as your default provider, and the built-in route at the bottom of your Routes panel ("All other payments") points at it. Its status is always Not connected, because it never takes real money.

Donations to a club that isn't published always go through a simulated provider. Supporters see a payment simulation page instead of a real payment form, so you can test the club without charging anyone. See How supporters pay.

You can't disable or delete the Simulated Payment provider. You can edit its Title and its fee fields.

You can also add more Simulation providers with Add provider. Unlike the built-in one, those can be disabled and deleted.

Simulation fee fields

A simulation provider has two fee fields:

• Processing fee percentage: entered as a percentage. "1.5 means 1.5%". It must be between 0 and 100.
• Fixed fee: "A whole number of cents added to every donation". It must be a whole number, 0 or more.

If you leave a field blank, the default is used: 1.5% and 20 cents.

As the note under the fields says: "These figures decide only what a simulated donation appears to cost. No real money is involved."