{"title":"Tyro","slug":"tyro-payment-provider","url":"https://support.storeconnect.com/articles/tyro-payment-provider","url_markdown":"https://support.storeconnect.com/articles/tyro-payment-provider.md","subtitle":null,"summary":"Configure Tyro for online and POS payments in StoreConnect, including Google Pay, Apple Pay, 3DS, and subscription support.","type":"Help_Documentation","video_url":"","keywords":"tyro, payment provider, pos payments, ecommerce payments, apple pay, google pay, 3d secure, 3ds, subscriptions, stored card payments, wallet payments, amex support","last_modified":"2026-08-21T07:12:35+0000","body_markdown":"[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:\n\n-   Standard checkout and POS transactions\n-   Google Pay and Apple Pay wallet payments\n-   Subscriptions\n-   Stored card payments\n\nTyro 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.\n\n## What you need\n\n-   Tyro account enabled for ecommerce, POS, or both\n-   Client ID and Client Secret from Tyro onboarding\n-   Tyro location ID (provided during onboarding, e.g. `tc-yourbusiness-1234`)\n-   Sandbox environment (recommended for initial testing)\n\u003c!-- -   For Google Pay: a Google Pay Business Console account (see [Google Pay setup](#google-pay-setup) below) --\u003e\n-   For Apple Pay: domain verification through Tyro (see [Apple Pay setup](#apple-pay-setup) below)\n-   Outlets set up in StoreConnect (POS only)\n\n## Get credentials from Tyro\n\nTyro provide assistance with onboarding and supply credentials for both sandbox and production environments.\n\nRefer to their [app documentation](https://docs.connect.tyro.com/app/) for instructions on how to obtain auth credentials.\n\nYou will need:\n-   **Client ID** — This is the **API Key** in StoreConnect\n-   **Client Secret** — This is the **API Secret** in StoreConnect\n-   **Location ID** — Add to the **API Options** field in StoreConnect (e.g. `location_id: tc-yourbusiness-1234`)\n\n## Configure Tyro in StoreConnect\n\n### Basic configuration\n\n1.  Open StoreConnect and go to **Settings \u003e Payments \u003e Payment providers**.\n2.  Select **New**. Complete the fields as follows, then **Save**:\n\n| StoreConnect field | Select or enter |\n|---|---|\n| Name | Tyro (or \"Tyro - test\" for sandbox) |\n| Provider | Select **Tyro** from the list |\n| Channel | Select **Web**, **POS**, or **Both** |\n| API Mode | `sandbox` or `production` |\n| API Key | Your Client ID (from Tyro) |\n| API Secret | Your Client Secret (from Tyro) |\n\n3.  In the **API Options** field, add the following (one option per line):\n\n```\nlocation_id: tc-yourbusiness-1234\nshow_wallets: true\n```\n\n:::note\nReplace `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.\n:::\n\n### AMEX support\n\nAMEX 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.\n\u003c!--\n## Google Pay setup\n\nEach client needs their own Google Pay merchant account. StoreConnect passes the client's merchant ID to the Tyro Pay Form at checkout.\n\n### Step 1: Register with the Google Pay Business Console\n\n1.  Go to the [Google Pay \u0026 Wallet Console](https://pay.google.com/business/console).\n2.  In the **Type of business** list, select **Merchant** and fill out the required business information.\n3.  Complete your **Business Profile**.\n4.  On the left-side navigation menu, click the **Google Pay API** tab.\n5.  Click **Get Started**.\n6.  Accept the Google Pay API Terms of Service and Acceptable Use Policy.\n7.  Note your **Merchant ID** shown in the top-right corner of the page (format: `BCR2DN...`).\n\n### Step 2: Submit your website for approval\n\n1.  In the Google Pay \u0026 Wallet Console, navigate to **Google Pay API \u003e Integrations**.\n2.  In the **Integrate with your website** section, click **Add website**.\n3.  Enter the top-level domain of the client's store (e.g. `beyondplumbingsupplies.com`).\n4.  Select Integration type: **Gateway** (Tyro is the gateway).\n5.  Upload screenshots showing the Google Pay button on the checkout page.\n6.  Click **Save**, then **Submit for approval**.\n7.  Wait for Google to approve the integration.\n\nRefer to Google's [Publish your integration](https://developers.google.com/pay/api/web/guides/test-and-deploy/publish-your-integration) guide for full details.\n\n### Step 3: Add Google Pay to StoreConnect API Options\n\nOnce approved, add the following to the Payment Provider's **API Options**:\n\n```\ngoogle_merchant_name: Your Store Name\ngoogle_merchant_id: BCR2DN5XXXXXXXXX\n```\n\n:::warning\nDo not wrap the merchant ID in quotes. Enter the value directly, e.g. `google_merchant_id: BCR2DN5XXXXXXXXX` not `google_merchant_id: 'BCR2DN5XXXXXXXXX'`.\n:::\n\n### Complete API Options example (with Google Pay)\n\n```\nlocation_id: tc-yourbusiness-1234\nshow_wallets: true\ngoogle_merchant_name: My Store\ngoogle_merchant_id: BCR2DN5XXXXXXXXX\n```\n--\u003e\n## Apple Pay setup\n\nTyro 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.\n\nFollow [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.\n\n### Step 1: Host the domain association file\n\n1.  Download the domain association file from Tyro.\n2.  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:\n\n```\napplepay_verification: |-\n  MIIQXgYJKoZIhvcNAQcCoIIQTzCCEEsCAQExCzAJBgUrDgMCGgUAMG0GCSqGSIb3DQEHAaBgBF57\n  InRlYW1JZCI6Ilo0UlVIWjJDM0siLCJkb21haW4iOiJteXN0b3JlLmNvbSIsImRhdGVDcmVhdGVk\n  IjoiMjAyNS0wNi0yMCwwNDoxMzo0MiIsInZlcnNpb24iOjF9oIINPzCCBDQwggMcoAMCAQICCD1Z\n  ...\n```\n\n:::warning\nSalesforce may alter the YAML formatting. The lines after `applepay_verification: |-` **must** be indented by exactly two spaces. Verify the formatting after saving.\n:::\n\n3.  Save the Payment Provider. Verify the file is publicly accessible at:\n    `https://yourdomain.com/.well-known/apple-developer-merchantid-domain-association`\n\n:::note\nThe 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.\n:::\n\n### Step 2: Register the domain with Tyro\n\nContact Tyro support (connect-support@tyro.com) and request they verify your domain with Apple. Both sandbox and production domains need to be verified separately.\n\n### Step 3: Verify Apple Pay is working\n\nOnce Tyro confirms the domain is verified, test Apple Pay on a supported device:\n-   Safari on iOS 10+ or macOS Sierra+\n-   Chrome, Edge, or Firefox on iOS 16+\n\nThe Apple Pay button will only appear on supported devices when `show_wallets: true` is set.\n\n### Complete API Options example (with Apple Pay and Google Pay)\n\n```\nlocation_id: tc-yourbusiness-1234\nshow_wallets: true\ngoogle_merchant_name: My Store\ngoogle_merchant_id: BCR2DN5XXXXXXXXX\napplepay_verification: |-\n  \u003cpaste the full contents of the domain association file here, indented by two spaces\u003e\n```\n\n## Troubleshooting\n\n\u003c!--\n### Google Pay: OR_BIBED_11 error\n\n**\"This merchant is having trouble accepting your payment\"**\n\nThis 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:\n-   The merchant ID in API Options matches the one in the Google Pay Business Console\n-   The website has been submitted and approved by Google\n-   Integration type is set to **Gateway**\n-   There are no quotes around the merchant ID value\n--\u003e\n\n### Apple Pay: 404 on domain verification\n\nThe domain association file is not being served. Check:\n-   The `applepay_verification` key is correctly formatted in API Options (indented by two spaces after `|-`)\n-   The Payment Provider is in an Active state\n-   The URL `https://yourdomain.com/.well-known/apple-developer-merchantid-domain-association` returns the verification text\n\n### AMEX transactions not accepted\n\nAMEX 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\"`.\n\n### 3DS bank verification pop-ups\n\n3D 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.\n\n## Reference links\n\n-   [Tyro Connect documentation](https://docs.connect.tyro.com/app/)\n-   [Tyro Going Live guide](https://docs.connect.tyro.com/app/apis/pay/going-live)\n-   [Tyro Wallet Payments](https://docs.connect.tyro.com/app/apis/pay/accept-a-wallet-payment/)\n-   [Google Pay \u0026 Wallet Console](https://pay.google.com/business/console)\n-   [Google Pay: Publish your integration](https://developers.google.com/pay/api/web/guides/test-and-deploy/publish-your-integration)"}