On April 18 2022, the TranSafe public test server at https://test.transafe.com was upgraded to a preliminary version of our forthcoming version 9 software. This new version 9 release includes a new API, with many enhancements. Updated API documentation with improved descriptions for various parameters is now available at https://developers.transafe.com.
While we do encourage integrators to evaluate the new API, the purpose of this notice is to recommend that you thoroughly test your existing applications against the preliminary version 9 software.
Version 9 maintains API compatibility for existing well-behaved integrations, but some integrations may be impacted by subtle changes that do not in any way conflict with the original API documentation, including, but not limited to:
Other factors that some existing integrations may improperly rely upon include:
Much of the prior API is now implemented through an emulation layer that may internally spawn multiple tasks using the new API to complete the request. In some cases the emulation may return unexpected results if an integration uses a combination of the new API and the old API. (As an example, the tokenization subsystem in the new API has separated the tokens from the recurring schedules so that multiple schedules may be assigned to a single token. The old API did not have this concept, however, so tokens could be either recurring, installment, or card-on-file only. There is no way the emulation layer can show a single token with multiple schedules attached, because the old API does not support that concept.)
The official release of the version 9 software to production will occur on July 12, 2022. This work will occur between the hours of 4 am and 7am EDT, with an expected one hour of downtime. Please test your existing integrations before that time and report any issues you encounter to firstname.lastname@example.org, especially if you believe your integration to be correct but it does not behave as it did previously.
- TranSafe Gateway Team