API Versions

We version our API to ensure that we can improve the system with new breaking features but ensure that our previous integrators will not be affected.

📘

You should always include the pinch-version header when making requests to our API.

Though technically optional, without it you will always be routed the latest version, which may introduce breaking changes as new versions are released.

Usage:
pinch-version: 2020.1

Current API Versions

2020.1 (Latest)

Stable, long-running version. Uses nonce for replay protection on payments and refunds.

2019.1

• Updated the Merchant endpoints to add/retrieve more data especially contact information for both the company and the primary contact at that company.
• Brought Merchants and Managed Merchants into line so they have the same properties.

2017.2 (obsolete)

• Added credit card endpoints and the concept of payment sources.

2017.1 (obsolete)

• The initial public release of the Pinch API.