Shopify is a fully hosted shopping cart, which can link to external payment gateways in order to complete transactions.

Only a few simple steps are required in order to complete this process.

You will need your Telr Store ID and Authentication Key. These can be located in the configuration screen for the V2 hosted payment pages in the Telr admin system.

Please follow the below steps to install “Telr” as new integration on Shopify to make payments.

Steps to Install Telr payment app: 

Login to the Shopify merchant admin.

Option 1:

  • Go to Settings > Payments, Then Click on ” Add payment methods”, Select “Search by provider” and type “Telr” and click on Telr drop

Please make sure your Shopify system is using the same currency as your merchant account. Please also ensure that you enter only the numeric part of your Store ID into the Shopify configuration, not your store name or login username

  • Click “Activate” & Follow point ‘a’ mentioned


Option 2:

  • Open another tab on the browser and paste the below installation link to install “Telr App” in the store – providers%2F3211265

Below are the screenshots which can be referred –

a) Click on connect button:


b) Click on Install App button:


c) Click on “Manage” button, it will redirect to Telr merchant:


d) Login to Telr merchant dashboard – and follow below steps:

    1. Click Integration tab & select “Payment Page V2” from left panel
    2. Click
    3. Under “Shopify configuration” section, Fill the “Shopify domain name”. eg: “test-store-”
    4. Click


e) Refresh the browser page ( in point c) above ) & click on Activate button:


f) Check in Settings -> Payments, “Telr” name would start appearing:


g) Use “Telr” as payment option to make payment for different orders:


Adding Domain Name in Sysadmin

This section is only required if merchant is not transacting from Shopify but transacting from his own website. In this case, please contact Telr Support ( with your domain name & store details.


Steps to Un-Install Telr Payment App

  1. Check in Settings -> Payments and click on “Manage” in front of “Telr” and then click “Deactivate Telr”


2. Now click on “Uninstall Telr”

Payment page customisation

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

When you are ready to start processing live transactions, you must ensure that the IP details of your Shopify server have been entered into the Payment Page V2 configuration with the Telr Merchant Administration System.

Test Cards

These card numbers can be used when testing your integration to the payment gateway. These cards will not work for live transactions.

Card numberTypeCVVMPI
4000 0000 0000 0002Visa123No
4111 1111 1111 1111Visa123Yes
4444 3333 2222 1111Visa123Yes
4444 4244 4444 4440Visa123Yes
4444 4444 4444 4448Visa123Yes
4012 8888 8888 1881Visa123Yes
5105 1051 0510 5100Mastercard123No
5454 5454 5454 5454Mastercard123Yes
5555 5555 5555 4444Mastercard123Yes
5555 5555 5555 5557Mastercard123Yes
5581 5822 2222 2229Mastercard123Yes
5641 8209 0009 7002Maestro UK123Yes
6767 0957 4000 0005Solo123No
3434 343434 34343American Express1234No
3566 0020 2014 0006JCB123No
3111 1111 1111 1111MADA123No

The card security code (CVV) to use with the test cards is 123 (except for American Express, which should be 1234) for an authorised response, other codes will be declined.

Cards which show ‘Yes’ in the MPI column will use a simulated 3D Secure authentication page, allowing you to test the transaction flow when Verified by Visa or MasterCard SecureCode is used.

Simulating decline/error responses

When it test mode, and when using the above test cards, you can simulate any of the transaction response codes by using specific values for the card security code (CVV). By taking the response code you want to simulate, pad that code with a leading ‘0’ in order to make it a 3 digit code and use that for the CVV.

For example, to simulate the Insufficient Funds response (status ‘D’, code ‘41’) use 041 as the CVV.

You can also simulate an on-hold transaction in the same way. On hold is where the transaction has been authorised, but the anti-fraud system has flagged the transaction for inspection. Whilst the transaction is on-hold, no funds will be debited from the customers’ card. You would need to use the Merchant Administration System to either accept or reject the transaction. To simulate the on-hold response within the test system, use a CVV value of ‘999’ with one of the above test cards.

Updated on March 2, 2023

Related Articles