# Adding a payment processor

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

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

![Adding a payment processor](/_astro/cdn/b4eed7bdfe/add-integration-list.png)

### Where to find it

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

### What you see

- 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.

### What you can do

| 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 processor. Rules: [Connect a payment processor](/platforms/user-guides/rules-gateway-connect/). |
| **Skip** | In test mode with no providers yet, installs a sandbox provider so you can try checkout straight away. Rules: [Connect a payment processor](/platforms/user-guides/rules-gateway-connect/). |

![Adding a payment processor](/_astro/cdn/d90da0ec6f/add-integration-oauth-modal.png)

### Things to note

- **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 criterion, 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.

### Related tasks

- Connecting a payment processor
- Setting up in single-provider mode