Skip to content
Log in

Tyro

On this page

Tyro 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) 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 Apple Pay: domain verification through Tyro (see 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 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)
  1. 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.
  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 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 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. :::

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

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.

Was this article helpful?

Was this article helpful?