HomeDocumentationAPI Reference
Documentation

My Shop's Custom Code

Once the Reach Localize apps are installed on your store, this page will help you guide you through the steps to customize the code for your needs.

Use our custom code widget to help you find out the right code to install in your shop.
Answer a few questions and get the right code for your store.

Questions? We're here for you.
[email protected]

Additional Scripts

Add snippet to Settings > Checkout > Additional Scripts

<script>
  // Required for Reach Gateway
  var gip_order_id = '{{ checkout.order_id }}';
</script>

Script Tag Options

To further customize your shop's code, you can use the attributes described below.

Attribute

Required

Value

id

Yes

'gointerpay_localize'

src

Yes

Localize.js script source

data-merchant_id

Yes

Your Merchant ID

data-store_currency

No

The store currency. Defaults to 'USD' if omitted. Set to the 3-char currency code for all other currencies.

data-process_store_currency

No

Set to 'true' if Reach will process store currency orders. Reach payment methods will be shown for all currencies including the store currency. Shopify payment methods will always be hidden unless the 'data-whitelisted_store_currency_gateways' flag is used.

data-whitelisted_gateways

No

A comma separated list of Shopify gateway codes. Each gateway included will be enabled for localized orders. See Gateway Codes below for more information.

data-whitelisted_store_currency_gateways

No

Used together with the 'data-process_store_currency' attribute. A comma separated list of Shopify gateway codes. Each gateway included will be enabled for store currency orders if 'data-process_store_currency' is also set to true. See Gateway Codes below for more information.

data-env

No

Script environment. Defaults to 'production' if omitted, which will use production APIs. Set to 'sandbox' or 'development' when using the corresponding MIDs/API. See Environments below for more information.

data-flc_only

No

Set to 'true' if only Reach DHL app functionality is required. Will disable price conversion and payment processing functions.

data-currency_tag

No

This flag can be used to force a shop's visitors to re-localize (clear their cached currency) once every time a new value is set. The value can be any alphanumeric string.

data-disabled_countries

No

A comma separated list of 2-character country codes. The script will be disabled if the shopper is localized to any of these countries.

data-auto_round_prices

No

This flag is used to enable automatic rounding on all prices across the store.

data-block_ga_crawlers

No

This flag is used to force web crawlers like Google crawlers to use store currency and remain undetected

data-hide_zero_decimal

No

Set to "true" to remove .00 from rounding values. Set to "false" if you want decimal .00 with your rounded prices. e.g. If set to "true" $35.00 CAD is displayed as $35 CAD