Support Services

TRANS API Migration Integration Guide

This document serves as a comprehensive migration guide for merchants transitioning from the TRANS API to the Forte API, detailing authentication changes, endpoint mappings, and migration steps.

  • Overview of Migration: The guide outlines the process for merchants moving from the TRANS API to the Forte API, emphasizing the need for updated authentication and endpoint adjustments. 
  • Authentication Changes: Transitioning from API Key authentication in the TRANS API to Basic Authentication with username and password in the Forte API, along with the addition of the X-Forte-Auth-Organization-Id header.  
  • Migration Steps: Key steps include updating authentication methods, modifying API calls to align with Forte’s requirements, and ensuring proper error handling.  
  • Endpoint Definitions: Detailed mappings of various endpoints from the TRANS API to the corresponding Forte API endpoints, including credit card processing and transaction handling.  
  • Testing and Deployment: Recommendations for testing the integration in the Forte sandbox environment before moving to production and monitoring transactions post-deployment.  
  • Error Handling: Guidance on updating error responses to match Forte's error codes, ensuring merchants can effectively manage transaction outcomes. 
  • Customer and Payment Method Management: Instructions for managing customer profiles and payment methods, including storing and deleting tokens for credit cards and checks.  
  • Summary of Endpoints: A table summarizing the TRANS API endpoints alongside their Forte API equivalents for easy reference during migration.


You can find the complete documentation guide attached below. 

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.