Adding a payment provider

This is where you pick a payment provider to connect. You can filter the list by country to see the providers available where you operate.

Choose Add on your integrations list. If you don't have any providers connected yet, you're brought here automatically.

A list of available providers, each with its name and — where relevant — a Recommended or Beta badge:
- Recommended — providers Shuttle works most closely with. These are the best-supported choices and give the smoothest experience.
- Beta — providers Shuttle fully supports, but which have been integrated for a shorter time or are used by a smaller number of merchants so far. The path is a little less well-trodden, so it's worth checking carefully during onboarding that the provider meets all your requirements.
A country filter (a convenience search — see Things to note).
A compare processors link that opens Shuttle's marketplace in a new tab.

Control	What it does
Country	Narrows the list to providers that operate in that country, to help you find one. Choose All to see every available provider. It's only a search aid — see Things to note.
Choose a provider	Starts connecting it. Depending on how the provider authenticates, this either opens a secure login window to authorise the connection (OAuth providers) or takes you to the Entering connection details screen to enter the provider's API keys (all other providers). See Things to note and Connecting a payment provider.
Skip	In test mode with no providers yet, installs a sandbox provider so you can try checkout straight away.

There are two ways a provider connects, and the provider decides which:
- OAuth — choosing the provider opens a secure login window where you sign in to the provider directly and authorise the connection. You don't enter any keys in Shuttle; the provider hands the connection back once you've approved it. This happens here on the add screen, in a pop-up window.
- Connection details — choosing the provider takes you to the Entering connection details screen, where you enter the provider's API keys or account identifiers yourself.
The country filter is purely a convenience for finding providers that operate in a given country — it only narrows what's shown in the list. It doesn't restrict where you can take payments, change how anything is processed, or alter a provider's own country coverage. It's a search criteria, nothing more.
First-time users see slightly different introductory wording.
If only one provider is available to you, you're taken straight to connecting it without seeing the list.
When payment setup is opened for a single provider, the list header is hidden and you go straight to that provider. See Setting up in single-provider mode.