jXchange REST-Legacy Migration
Overview
We are migrating all jXchange REST‑Legacy translation services from Mulesoft to a new, high‑performance architecture running in Google Cloud Platform (GCP).
Notable Items
Items to Update: This transition requires updates to both the authentication method (moving from Client Id/Secret to OAuth 2.0/Signed JWT), environmental variables and the API endpoints.
API Formatting: API formatting in JSON DOES NOT change with this migration. No need to modify the body of the API calls.
Migration Timeline
Work on your Jack Henry DMZ Sandbox institution should begin immediately.
All existing jXchange REST‑Legacy clients are expected to migrate no later than July 31, 2026.
Performing The Migration
Step 1: Development using DMZ Bank 100
To begin testing in the DMZ Bank 100 environment, complete the following steps:
- Generate a PEM Public/Private Key Pair
- All integrations must now use Signed JWT authentication.
- Reference: Public Key + Private Key | Digital Toolkit | Jack Henry Docsand Development Using OAuth REST-Legacy
- Request Credentials
- Email your Public Key and a list of required API Authorizations (e.g., AcctAdd, AcctInq, TrnAdd) to: Developer Relations
- Be sure to specify that the request is for DMZ Bank 100.
- Reference: Fintech Integration Phases: New Solution: Phase 3
- Update Your Endpoints
- Point your application to the new GCP REST‑Legacy endpoints listed in our Dev Portal
- Reference: Development Using OAuth REST-Legacy
- Update your environmental access variables
- This migration requires changes to the environmental access variables and new variables for token generation.
- Reference: Development Using OAuth Rest-Legacy: Pre-production access variables
Step 2: Production Readiness (Fintechs Only)
Once you complete and validate your testing:
- Integration Readiness Check
- Submit the Integration Readiness Check Request Form to request an Integration Readiness Check.
- Coordinate with the Financial Institution
- Once the Integration Readiness check is complete a fintech will need to coordinate the update with their banks to have them request the update.
- Reference: See phases 7-9 of the Fintech Integration Phases: Implementation Phases
- Have a how-to question? Seeing a weird error? Get help on StackOverflow.
- Register for the Developer Office Hours where we answer technical Q&A from the audience.