Need help?



The integration between Shopify and Telr enables seamless transactions by connecting Shopify's fully hosted shopping cart with external payment gateways. To successfully complete the integration, follow these simple steps:

  1. Obtain your Telr Store ID and Authentication Key from the configuration screen for V2 hosted payment pages in the Telradmin system.
  2. Install the "Telr" payment app on Shopify by following one of the two options below:

Option 1

  1. Log in to the Shopify merchant admin.
  2. Go to Settings > Payments.
  3. Click on "Add payment methods."
  4. Select "Search by provider" and type "Telr" in the search field.
  5. Choose "Telr" from the search results.
  6. Ensure that your Shopify system uses the same currency as your merchant account.
  7. Enter only the numeric part of your Store ID into the Shopify configuration.
  8. Click "Activate" and follow the instructions

Option 2

  1. Open a new browser tab and paste the following installation link to install the "TelrApp" in your store:
  2. Follow the screenshots provided below for reference:
    1. Click on the "Connect" button.
    2. Click on the "Install App" button.
    3. Click on the "Manage" button to redirect to the Telr merchant page.
    4. Log in to your Telrmerchant dashboard at> and follow the steps below:
      1. Click on the Integration tab and select "Payment Page V2" from the left panel.
      2. In the "Shopify configuration" section, enter your Shopify domain name (e.g., "").
    5. Refresh the browser page from step c) and click on the "Activate" button.
    6. Verify that "<<" appears in Settings > Payments.
    7. Use "Telr" as a payment option to process payments for different orders.

Adding Domain Name in Sysadmin

This step is only necessary if you're not transacting from Shopify but from your own website. In such cases, please contact Telr Support ( [email protected]) with your domain name and store details.

Uninstalling the Telr Payment App

To uninstall the Telr Payment App, follow these steps:

  1. Go to Settings > Payments in your Shopify dashboard.
  2. Click on "Manage" in front of "Telr."
  3. Click "Deactivate Telr."
  4. Finally, click on "Uninstall Telr."

Payment page customization

The payment page can be customised through the use of a CSS file. The core page display is based on the BootStrap 3 responsive layout. You should ensure that you are familiar with the underlying styles used within Bootstrap before making any CSS changes. For more details please check the Hosted Payment Page integration guide.

Verified by Visa and MasterCard SecureCode

After the consumer enters their card details, the payment gateway will check to see if that card is enrolled as part of the Verified by Visa or MasterCard SecureCode authentication systems (known as 3D-Secure).

If the card is part of one of these authentication systems, then an additional page is displayed which requires the relevant authentication details to be entered. This is usually in the form of a password that has been assigned by the consumer or via a one-time code sent to the customers mobile.

The actual data entry section is presented directly by the card issuer and cannot be customised. It is generally displayed on a white background. Where possible the 3D-Secure authentication form is displayed over the payment page, allowing the customer to see that it is clearly part of the payment process.

Live Transactions

Before processing live transactions, ensure that the IP details of your Shopify server are entered into the Payment Page V2 configuration in the Telr Merchant Administration System.