Gentrack Integration Resources

Migrating from Data Gateway to Direct Connection (Velocity)

On this page

Overview

This guide describes migrating from a Data Gateway setup to Direct Connection for Velocity. In Direct Connection mode, Velocity communicates directly with Gentrack Cloud Integration Services (GCIS) over the internet using your proxy server.

Prerequisites

Before starting, ensure:

  1. Your Velocity server has a CA-signed SSL certificate with a fully qualified domain name
  2. Your Velocity server is accessible from the internet
  3. You have administrator access to Velocity
  4. You have administrator access to the Integration Portal
  5. You know your proxy server configuration

GCIS IP Addresses

Configure firewall rules to allow inbound traffic from these GCIS IP addresses:

RegionIP Address 1IP Address 2
AU52.65.53.113.236.220.175
UK35.176.213.7518.130.141.102

Proxy Configuration

If your network requires a proxy server:

  1. Configure your proxy to allow outbound HTTPS connections to:

    • https://api-uk.integration.gentrack.cloud (UK region)
    • https://api-au.integration.gentrack.cloud (AU region)
    • https://uk.id.gentrackcloud.com (UK region)
    • https://au.id.gentrackcloud.com (AU region)

  2. Ensure the proxy does not interfere with SSL/TLS certificate validation

  3. Document your proxy settings (host, port, authentication if required) for use in Velocity configuration

Migration Steps

Step 1: Select Tenant in Integration Portal

  1. Log into the Integration Portal as a user with administrator access.

  2. In the Integration Portal, open the Tenants page from the Manage Access section.

  3. Select the tenant you want to migrate from Data Gateway to Direct Connection.

  4. Click Connect tenant button and fill out the form with the following settings:

    • Product type - Velocity
    • Core Product URL - Full URL of the Velocity API server. This URL must be accessible by GCIS over the internet.
    • Use Gentrack Cloud identity authentication - Turn ON to use Direct Connection authentication
    • Username and Password - Leave empty when “Use Gentrack Cloud identity authentication” is ON
    • Tenant is hosted in Gentrack Cloud - Set based on your hosting arrangement
    • Data Gateway URL - Leave empty for Direct Connection
    • Verify SSL certificate - Turn ON to verify the Velocity server’s SSL certificate

  5. Click Connect Tenant.

  6. Enable Billing under Services. Copy Client ID and Client Secret for later configuration in Velocity.

  7. Copy the Tenant Id for later configuration in Velocity.

The data you entered is validated by performing a complete trip between Gentrack Cloud and Velocity. An error will be displayed if the connection was unsuccessful. Resubmit the form once the information has been corrected.

Step 2: Configure Gentrack Cloud Credentials in Velocity

  1. Log in to Velocity as a system administrator.

  2. Go to Gentrack Launch Pad > Configuration Search. The Search for a Configuration Option screen displays.

  3. In Search Term, type Gentrack Cloud Credentials.

  4. In the Configuration Options list, click CLOUD.CREDENTIALS.

  5. Click Finish. The Gentrack Cloud Credentials screen displays.

  6. Click the Maintain Gentrack Cloud Credentials action and fill the following fields:

    • Token URL - Select based on your region:
      • UK: https://uk.id.gentrackcloud.com/v1/token
      • AU: https://au.id.gentrackcloud.com/v1/token
    • Client Id - Client ID of the Billing service from Step 1
    • Client Secret - Client Secret of the Billing service from Step 1
    • Tenant Id - Tenant Id from Step 1

  7. Click Finish.

Step 3: Update Message Service Configuration

  1. Log in to Velocity as a system administrator.

  2. Go to Gentrack Launch Pad > Configuration Search. The Search for a Configuration Option screen displays.

  3. In Search Term, type interface.

  4. In the Configuration Options list, click FILEMANAGER.MESSAGESERVICE.

  5. Click Finish. The Interface Message Service screen displays.

  6. Find the message service with Service ID GCIS and click to edit it.

  7. Update the Send URL field to:

    • UK region: https://api-uk.integration.gentrack.cloud
    • AU region: https://api-au.integration.gentrack.cloud

  8. Verify the following fields:

    • Service ID - GCIS
    • Service Name - Integration Services
    • Send Procedure - Select the one that contains Integration Platform or Integration Services
    • Send Retry Interval - 2 minutes
    • Send Logging Enabled - Leave disabled unless troubleshooting

  9. Click Finish.

Step 4: Verify Connection

  1. Log into the Integration Portal as a user with administrator access.

  2. In the Integration Portal, open the Tenants page from the Manage Access section.

  3. Click the tenant to open tenant details page.

  4. Click the Test Connection button in the Connection Details section.

  5. Wait a few seconds. The connection test verifies:

    • Network connectivity from GCIS to Velocity
    • API call to Velocity using the configured credentials

  6. If the test fails, verify:

    • Velocity server is accessible from the internet
    • SSL certificate is valid and CA-signed
    • Firewall rules allow GCIS IP addresses
    • Proxy configuration is correct (if applicable)
    • Gentrack Cloud Credentials are correctly configured

Step 5: Test Event Delivery

  1. In Velocity, trigger a test event (for example, create a bill or accept a payment).

  2. Verify the event is delivered to GCIS:

    • Check Integration Portal for event activity
    • Verify connectors or integrations receive the event

  3. If events are not delivered:

    • Verify Message Service configuration
    • Check Velocity application logs
    • Verify proxy configuration allows outbound connections
    • Confirm Gentrack Cloud Credentials are correct

Step 6: Remove Data Gateway Components

After verifying Direct Connection is working:

  1. Log into the Integration Portal.

  2. Navigate to the Tenants page.

  3. Click the tenant and verify it shows Direct Connection (not Data Gateway URL).

  4. If you have a Data Gateway server that is no longer needed:

    • Stop the Data Gateway service
    • Uninstall the Data Gateway software
    • Remove firewall rules specific to Data Gateway
    • Decommission the Data Gateway server

  5. Remove any monitoring or alerting configured for Data Gateway.

Troubleshooting

Connection Test Fails

  • Verify Velocity server URL is accessible from the internet
  • Check SSL certificate is valid and CA-signed with FQDN
  • Confirm firewall rules allow GCIS IP addresses
  • Verify proxy configuration (if applicable)

Events Not Delivering

  • Verify Gentrack Cloud Credentials are correctly configured
  • Check Message Service Send URL matches your region
  • Verify proxy allows outbound HTTPS to GCIS endpoints
  • Check Velocity application logs for errors
  • Confirm Send Procedure is correctly configured

Authentication Errors

  • Verify Client ID and Client Secret are correct
  • Check Tenant Id matches the tenant in Integration Portal
  • Verify Token URL matches your region
  • Confirm Billing service is enabled in Integration Portal
Last updated on 25 Nov 2025