# Tyro

Source: https://support.storeconnect.com/articles/tyro-payment-provider · Last modified 21 August 2026

[Tyro](https://www.tyro.com/) is a payment provider that supports both POS and eCommerce payments. With Tyro integrated into StoreConnect, your clients can use a single payment solution for all in-store and online orders. Tyro works for:

-   Standard checkout and POS transactions
-   Google Pay and Apple Pay wallet payments
-   Subscriptions
-   Stored card payments

Tyro includes [3D Secure (3DS)](https://docs.connect.tyro.com/app/apis/pay/3d-secure) fraud detection, which is automatic and cannot be disabled. Most transactions pass through silently, but some may prompt customers to verify with their bank.

## What you need

-   Tyro account enabled for ecommerce, POS, or both
-   Client ID and Client Secret from Tyro onboarding
-   Tyro location ID (provided during onboarding, e.g. `tc-yourbusiness-1234`)
-   Sandbox environment (recommended for initial testing)
<!-- -   For Google Pay: a Google Pay Business Console account (see [Google Pay setup](#google-pay-setup) below) -->
-   For Apple Pay: domain verification through Tyro (see [Apple Pay setup](#apple-pay-setup) below)
-   Outlets set up in StoreConnect (POS only)

## Get credentials from Tyro

Tyro provide assistance with onboarding and supply credentials for both sandbox and production environments.

Refer to their [app documentation](https://docs.connect.tyro.com/app/) for instructions on how to obtain auth credentials.

You will need:
-   **Client ID** — This is the **API Key** in StoreConnect
-   **Client Secret** — This is the **API Secret** in StoreConnect
-   **Location ID** — Add to the **API Options** field in StoreConnect (e.g. `location_id: tc-yourbusiness-1234`)

## Configure Tyro in StoreConnect

### Basic configuration

1.  Open StoreConnect and go to **Settings > Payments > Payment providers**.
2.  Select **New**. Complete the fields as follows, then **Save**:

| StoreConnect field | Select or enter |
|---|---|
| Name | Tyro (or "Tyro - test" for sandbox) |
| Provider | Select **Tyro** from the list |
| Channel | Select **Web**, **POS**, or **Both** |
| API Mode | `sandbox` or `production` |
| API Key | Your Client ID (from Tyro) |
| API Secret | Your Client Secret (from Tyro) |

3.  In the **API Options** field, add the following (one option per line):

```
location_id: tc-yourbusiness-1234
show_wallets: true
```

:::note
Replace `tc-yourbusiness-1234` with the location ID provided by Tyro during onboarding. Set `show_wallets` to `true` only after completing the Google Pay and/or Apple Pay setup steps below.
:::

### AMEX support

AMEX may not be enabled by default on all Tyro locations. During onboarding, verify with Tyro that AMEX is enabled for your location. If AMEX is not available, contact Tyro support to request it be activated. You can confirm which card types are enabled by checking the card logos displayed in the Tyro payment form at checkout — the AMEX logo should appear alongside Visa, Mastercard, etc.
<!--
## Google Pay setup

Each client needs their own Google Pay merchant account. StoreConnect passes the client's merchant ID to the Tyro Pay Form at checkout.

### Step 1: Register with the Google Pay Business Console

1.  Go to the [Google Pay & Wallet Console](https://pay.google.com/business/console).
2.  In the **Type of business** list, select **Merchant** and fill out the required business information.
3.  Complete your **Business Profile**.
4.  On the left-side navigation menu, click the **Google Pay API** tab.
5.  Click **Get Started**.
6.  Accept the Google Pay API Terms of Service and Acceptable Use Policy.
7.  Note your **Merchant ID** shown in the top-right corner of the page (format: `BCR2DN...`).

### Step 2: Submit your website for approval

1.  In the Google Pay & Wallet Console, navigate to **Google Pay API > Integrations**.
2.  In the **Integrate with your website** section, click **Add website**.
3.  Enter the top-level domain of the client's store (e.g. `beyondplumbingsupplies.com`).
4.  Select Integration type: **Gateway** (Tyro is the gateway).
5.  Upload screenshots showing the Google Pay button on the checkout page.
6.  Click **Save**, then **Submit for approval**.
7.  Wait for Google to approve the integration.

Refer to Google's [Publish your integration](https://developers.google.com/pay/api/web/guides/test-and-deploy/publish-your-integration) guide for full details.

### Step 3: Add Google Pay to StoreConnect API Options

Once approved, add the following to the Payment Provider's **API Options**:

```
google_merchant_name: Your Store Name
google_merchant_id: BCR2DN5XXXXXXXXX
```

:::warning
Do not wrap the merchant ID in quotes. Enter the value directly, e.g. `google_merchant_id: BCR2DN5XXXXXXXXX` not `google_merchant_id: 'BCR2DN5XXXXXXXXX'`.
:::

### Complete API Options example (with Google Pay)

```
location_id: tc-yourbusiness-1234
show_wallets: true
google_merchant_name: My Store
google_merchant_id: BCR2DN5XXXXXXXXX
```
-->
## Apple Pay setup

Tyro acts as the aggregator for Apple Pay. You do **not** need to create an Apple Developer account, Apple Pay Merchant ID, or certificates. Tyro handles this via their own Apple Developer account.

Follow [Tyro's wallet documentation](https://docs.connect.tyro.com/app/apis/pay/accept-a-wallet-payment/#1-verify-your-website-domain-for-apple-pay) for the full process.

### Step 1: Host the domain association file

1.  Download the domain association file from Tyro.
2.  Add the file contents to the Payment Provider's **API Options** using the `applepay_verification` key you have been provided with. Below is an example:

```
applepay_verification: |-
  MIIQXgYJKoZIhvcNAQcCoIIQTzCCEEsCAQExCzAJBgUrDgMCGgUAMG0GCSqGSIb3DQEHAaBgBF57
  InRlYW1JZCI6Ilo0UlVIWjJDM0siLCJkb21haW4iOiJteXN0b3JlLmNvbSIsImRhdGVDcmVhdGVk
  IjoiMjAyNS0wNi0yMCwwNDoxMzo0MiIsInZlcnNpb24iOjF9oIINPzCCBDQwggMcoAMCAQICCD1Z
  ...
```

:::warning
Salesforce may alter the YAML formatting. The lines after `applepay_verification: |-` **must** be indented by exactly two spaces. Verify the formatting after saving.
:::

3.  Save the Payment Provider. Verify the file is publicly accessible at:
    `https://yourdomain.com/.well-known/apple-developer-merchantid-domain-association`

:::note
The Payment Provider may need to be in an **Active** state for the verification URL to be served. If testing before go-live, the provider can be set to active temporarily for domain verification.
:::

### Step 2: Register the domain with Tyro

Contact Tyro support (connect-support@tyro.com) and request they verify your domain with Apple. Both sandbox and production domains need to be verified separately.

### Step 3: Verify Apple Pay is working

Once Tyro confirms the domain is verified, test Apple Pay on a supported device:
-   Safari on iOS 10+ or macOS Sierra+
-   Chrome, Edge, or Firefox on iOS 16+

The Apple Pay button will only appear on supported devices when `show_wallets: true` is set.

### Complete API Options example (with Apple Pay and Google Pay)

```
location_id: tc-yourbusiness-1234
show_wallets: true
google_merchant_name: My Store
google_merchant_id: BCR2DN5XXXXXXXXX
applepay_verification: |-
  <paste the full contents of the domain association file here, indented by two spaces>
```

## Troubleshooting

<!--
### Google Pay: OR_BIBED_11 error

**"This merchant is having trouble accepting your payment"**

This means the Google Pay Merchant ID is not approved for production. The client needs to complete the [Google Pay Business Console](#step-1-register-with-the-google-pay-business-console) setup and have their website approved by Google. Ensure:
-   The merchant ID in API Options matches the one in the Google Pay Business Console
-   The website has been submitted and approved by Google
-   Integration type is set to **Gateway**
-   There are no quotes around the merchant ID value
-->

### Apple Pay: 404 on domain verification

The domain association file is not being served. Check:
-   The `applepay_verification` key is correctly formatted in API Options (indented by two spaces after `|-`)
-   The Payment Provider is in an Active state
-   The URL `https://yourdomain.com/.well-known/apple-developer-merchantid-domain-association` returns the verification text

### AMEX transactions not accepted

AMEX is not enabled by default. Contact Tyro to request AMEX be enabled for your location. Verify by checking the `supportedNetworks` in the Tyro API response includes `"amex"`.

### 3DS bank verification pop-ups

3D Secure is automatic on Tyro and cannot be disabled. Some customers may see bank verification pop-ups (e.g. from ANZ, CBA) during checkout — this is expected behaviour. Most transactions pass through silently via frictionless flow, but Tyro's fraud engine may trigger a challenge requiring customer input.

## Reference links

-   [Tyro Connect documentation](https://docs.connect.tyro.com/app/)
-   [Tyro Going Live guide](https://docs.connect.tyro.com/app/apis/pay/going-live)
-   [Tyro Wallet Payments](https://docs.connect.tyro.com/app/apis/pay/accept-a-wallet-payment/)
-   [Google Pay & Wallet Console](https://pay.google.com/business/console)
-   [Google Pay: Publish your integration](https://developers.google.com/pay/api/web/guides/test-and-deploy/publish-your-integration)

---

## Follow StoreConnect

- [Email Newsletter](https://getstoreconnect.com/c/lp-newsletter)
- [LinkedIn Newsletter](https://www.linkedin.com/build-relation/newsletter-follow?entityUrn=7444956928444862464)
- [YouTube](https://www.youtube.com/channel/UCngKdP2x8l1wcbAKW3tvU8g)
- [LinkedIn](https://www.linkedin.com/company/storeconnect)
- [X / Twitter](https://x.com/storeconnecthq)

## Popular Links

- [Partners](https://getstoreconnect.com/partners)
- [News](https://getstoreconnect.com/articles/news)
- [Events](https://getstoreconnect.com/articles/events)
- [Feature Comparison](https://getstoreconnect.com/how-we-compare)
- [Download a free trial](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3A00000FMkeKUAT)
- [Book a Demo](https://getstoreconnect.com/contact)

## Documentation

- [Help documentation](https://support.storeconnect.com/help-documentation)
- [AI agents](https://support.storeconnect.com/ai)
- [Videos & tutorials](https://support.storeconnect.com/videos-tutorials)
- [Developer reference](https://support.storeconnect.com/developer-reference)
- [Release notes](https://support.storeconnect.com/release-notes)
- [Troubleshooting](https://support.storeconnect.com/troubleshooting)
- [Trust Center](https://trust.getstoreconnect.com/)
- [Status Page](https://status.storeconnect.com/)

## Contact

- info@getstoreconnect.com
- US +1 415 745 3230
- AUS +61 2 8365 2308

100 S Ashley Dr, Suite 600-2461
Tampa FL 33602-600 USA

Level 22, Sydney Place
180 George Street
Sydney, NSW, 2000, AUS

---

StoreConnect Support — https://support.storeconnect.com/articles/tyro-payment-provider