Integration Center
The Integration Center module guides client VASPs through the complete API integration readiness process with GTR. It provides a step-by-step workflow to configure prerequisites, submit test data, execute integration test cases, complete a self-declaration questionnaire, and verify go-live readiness.
This module is designed for VASPs integrating with GTR via API. If you plan to use manual operations to initiate and respond to Travel Rule requests within the GTR network, you may skip this section and refer to the Manual Travel Rule instead.
The Integration Center page is organized into the following sequential sections:
| Section | Description |
|---|---|
| Before Start Integration | Complete prerequisite configurations including web server preparation, IP whitelisting, dashboard settings, and integration resources. |
| Submit Integration Test Data | Provide test account details from both Test and Production environments for integration verification. |
| Travel Rule Request Initialize Test | Test your VASP's capability to initiate Travel Rule requests (17 test cases). |
| Travel Rule Request Receive Test | Test your VASP's ability to receive and process Travel Rule requests (10 test cases). |
| Travel Rule Request PII Verification Test | Test your VASP's capability to verify PII after receiving Travel Rule requests (8 test cases). |
| Questionnaire - Self-Declaration | Complete a self-assessment questionnaire covering GTR implementation, communication, data protection, PII handling, and sunrise procedures. |
| Post-Integration Checklist: Ready for Go-Live | Final checklist covering technical configurations, compliance configurations, and go-live activation. |
How to Use
- Navigate to the Integration Center menu from the left sidebar after logging in.
- Complete each section if applicable from top to bottom.
- Follow the documentation links provided in each section for detailed guidance.
- After completing all integration tests and the questionnaire, proceed to the Go-Live checklist.
Before Start Integration
This section outlines the prerequisite steps that must be completed before starting the integration process. Please follow the guideline provided in each document to finish all preparation steps.
- Web Server Preparation: Set up and configure your web server environment to communicate with GTR.
- Whitelist GTR IP Addresses: Configure your firewall to allow traffic from GTR IP addresses.
- Settings on GTR Dashboard: Complete the required configuration settings on your GTR Dashboard.
- Integration Resources: Download and review the integration resources provided, including API tools, demo projects, and helper scripts.
Submit Integration Test Data
To verify your integration, you must provide test account details from both your Test and Production environments. If you haven't created test accounts yet, please set them up in your respective environments before completing this section.
How It Works
- Create test data within your own environment (both Test and Production).
- Click "Add Test Data" below the corresponding environment tab to submit the details.
- Review the submitted data in the table. You can edit or delete entries as needed.
Test Data Fields
Each test data entry requires the following information:
| Field | Description |
|---|---|
| Test Data Name | A unique identifier for the test data entry. |
| Person Type | Natural Person or Legal Person. |
| First Name / Legal Name | First name (natural person) or legal entity name. |
| Last Name | Last name of the natural person (if applicable). |
| VASP Name | The counterparty VASP name for testing. |
| Network | The blockchain network used for the test transaction. |
| Coin | The cryptocurrency used for the test transaction. |
| Address | The wallet address used for the test transaction. |
- You must submit test data for both the Test Environment and Production Environment.
- The Test Data Name must be unique within each environment. Duplicate Test Data Names will not be accepted.
Integration Test Suites
The Integration Center provides three test suites. Your VASP should select one or more test suites based on your business scenarios and compliance requirements. For the complete test case documentation, refer to the Integration Test Cases Overview.
Choose your test suites:
- Does your VASP need to send Travel Rule requests and customer's PII to other VASPs? -> Complete Test Suite 1: Initialize Test
- Does your VASP need to receive Travel Rule requests from other VASPs? -> Complete Test Suite 2: Receive Test
- After receiving a Travel Rule request, does your VASP need to verify the accuracy of the PII data from the counterparty? -> Complete Test Suite 3: PII Verification Test
- You are not required to complete all three test suites. Select the suite(s) that match your VASP's integration scope.
- Most VASPs that both send and receive Travel Rule requests should complete all three suites.
Travel Rule Request Initialize Test
This section tests your VASP's capability to initiate Travel Rule requests (Test Suite 1: Initiator-Side API Tests). It contains 17 test cases covering authentication, VASP discovery, address routing, PII verification (Natural Person / Legal Person), TX ID update, and cancellation. For the full test case list and detailed instructions, refer to the Initializer Test Cases.
How It Works
- Refer to the Initializer Test Cases and initiate a Travel Rule request using the test data you submitted previously.
- After sending the request, click the "Check Status" button to view the outcome.
- You may perform multiple tests and click "Check Status" as many times as needed.
- The pass rate is displayed at the top of the section.
Travel Rule Request Receive Test
This section tests your VASP's ability to receive and process Travel Rule requests (Test Suite 2: Receiver-Side Callback Server Tests). It contains 10 test cases covering callback server health check, address routing, address and TX verification, TX ID update, cancellation, and receive-only flows. For the full test case list and detailed instructions, refer to the Receiver Test Cases.
How It Works
- Refer to the Receiver Test Cases for detailed information about each test case.
- For each test case, select the appropriate Test Person Type and Test Person from the dropdown menus.
- Click "SEND REQUEST" to trigger the test.
- The Test Result and Last Test At columns will update automatically after each test.
- Select the correct Test Person Type (Originator or Beneficiary) for each test case.
- The "Server Health Check" test does not require a Test Person and uses a dedicated health check endpoint.
Travel Rule Request PII Verification Test
This section tests your VASP's PII (Personally Identifiable Information) verification capability (Test Suite 3: Receiver-Side PII Verification Callback Tests). It contains 8 test cases covering KYC (Natural Person) and KYB (Legal Person) verification for both pre-transaction and post-transaction flows, with correct and incorrect PII data scenarios. For the full test case list and detailed instructions, refer to the PII Verifier Test Cases.
How It Works
- Refer to the PII Verifier Test Cases and ensure your system can receive requests and perform PII verification using your submitted test data.
- For each case, click "SEND REQUEST" to trigger the verification test and view the outcome.
- The pass rate is displayed at the top of the section.
Questionnaire - Self-Declaration
This section contains a self-assessment questionnaire that covers key aspects of your GTR integration. Your responses will be publicly shared with all GTR VASP members to promote transparency and interoperability.
- Your responses to this questionnaire will be publicly shared with all GTR VASP members.
- You can click "Edit" to update your answers at any time.
- This is a required action to complete this questionnaire before your VASP goes live in GTR Network. You can click "Edit" to update your answers at any time.
This questionnaire contains 19 questions organized into 5 categories:
| Category | Topics Covered | Questions |
|---|---|---|
| 1. GTR Implementation | Environment separation, test data sharing, session management, zero-downtime updates, callback server setup. | Q1 – Q5 |
| 2. Communication | Address routing, access control, tag/memo field support. | Q6 – Q8 |
| 3. Confidentiality and Data Protection | Pre-transaction and post-transaction verification, post-transaction wait protocol. | Q9 – Q11 |
| 4. PII Data Fields and IVMS | IVMS101 interpretation, PII verification, field-by-field verification, fuzzy name matching, matching thresholds. | Q12 – Q16 |
| 5. Sunrise Issue | Data retention policies, fallback procedures for system errors and counterparty connectivity issues. | Q17 – Q19 |
Post-Integration Checklist: Ready for Go-Live
Congratulations on completing your integration! Before going live, please ensure you have completed all the steps in the prior sections and reviewed the following checklist.
- Technical Configurations: Verify all technical settings including API endpoints, callback server URLs, mTLS certificates, and IP whitelisting are correctly configured for the production environment.
- Compliance Configurations: Ensure all compliance-related settings are properly configured, including Travel Rule thresholds, jurisdiction rules, and PII handling policies.
- Final Go-Live Activation: Once all technical and compliance configurations are verified, on your designated go-live date, you can go to Network Visibility and enable Visible as an API Member.
- Once you enable Visible as an API Member, your VASP will immediately appear on the GTR VASP Network list, both on UI and API Query.
- Ensure your server is fully ready and stable to process PROD requests before activating this setting.