Best Practicies

Up-to-Date Integration

We are currently working on a major upgrade of essCert to DTO and as a result are actively developing and enhancing our endpoints. By using the newest API version, you will ensure that your app has access to the latest resources. You will also be better positioned to provide a user experience consistent with what merchants will see in their ICE DTO integrated applications. To stay up to date, bookmark our changelog.

Anticipating Changes

At ICE Digital Trade, we make a distinction between Breaking and Non-Breaking changes.

Breaking Changes

Any breaking changes listed below will always be made with early warning via our developer change-log and other channels. There are several exceptional cases. ICE DTO will make breaking changes without warning to non-production staging API's.

  • Removal of a field from an API response.
  • Changing the data type of a field.
  • Changing the structure of an object.
  • Removal of an entire endpoint.
  • Adding a new required field to a POST/PUT body.

Non-Breaking Changes

We encourage developers to write code against our API that will not break if an endpoint begins returning additional fields. Without warning, we will push these non-breaking changes to the code base as part of our normal development.

  • Adding a new field to a GET response.
  • Adding a new optional field to a POST/PUT body.
  • Adding new endpoints.