Versioning

Overview

All endpoints in the Paytronix REST API are versioned. This enables us to change the required fields for each endpoint between software releases without breaking existing integrations.

Example

The specific version is included in the endpoint for each of our calls. In this example:

https://www.servernamegoeshere.paytronix.com/rest/13.2/transaction/addRedeem.json

13.2 is the version number and the request body will be held to the requirements of version 13.2 of our software.

Best Practice

New Integrations
We recommend developing new integrations using the most current version number. This allows you to take advantage of the latest and greatest features. The most current version is 16.3
Existing Integrations
We recommend keeping the version number the same once your integration is certified. Changing the version number could ultimately harm the integration, as unexpected behavior may occur. If you would like to update your integration, please reach out to your Paytronix contacts to start the re-certification process.

Server Responses

While we do not change the request fields for older versions of our API, we do occasionally add fields to the server response. You should build the integration such a way that unexpected fields will not affect the integration.