Important Update: Changes in the Merchant API Versioning System

Greetings Developers and API Users,

We are excited to announce a significant update to our Merchant API: A versioning system!

As part of our ongoing commitment to improving the developer experience and maintaining robust system functionality, these changes are critical for ensuring a seamless integration with our services.

The introduced changes are available on the new APIs we are launching and future updates will follow the same versioning approach. Although implementing the new versioning system will be mandatory going forward, endpoints in past versions will still work and won’t be decommissioned to not break existing integrations and offer time for necessary updates.

Key Highlights:

  1. Mandatory Versioning on new APIs: Not specifying a version in the request header where required will result in an error response. This change is to ensure that you are always interacting with the expected version of the API.
  2. Version-Specific Behaviours: Different versions of the Merchant API may exhibit distinct behaviours for specific operations. This allows us to introduce new functionalities and optimizations without disrupting existing integrations.
  3. Documentation Update: We have updated our API documentation to reflect these changes. The documentation includes detailed guidelines on how to specify versions in your API requests and the implications of different version numbers on API behaviour.

Recommended Actions:

  • Review the updated API documentation, focusing on the versioning section.
  • Update your API calls to the new version and include the required version headers.
    NOTE: Existing implementations will not break, deprecated endpoints remain operational until further notice.
  • Test your systems to ensure compatibility with the latest API versions.

Updated Endpoints:

With the latest updates, the following endpoints changed:

We understand that changes like these require some adjustments in your current setups. Our team is committed to support you through this transition. For any questions or assistance, feel free to reach out on this forum or contact our support team.

Thank you for your continued partnership and understanding as we strive to enhance our services.

Best Regards,

Revolut Acquiring Team

2 Likes