Skip to content
Last updated

API Migration Guide: Moving to OAuth 2.0 and mTLS

The purpose of this guide is to help you seamlessly transition from personal token authentication to the more secure OAuth 2.0 with mTLS.

This guide is intended for Wise partners who are the direct customer of Wise by transacting on their own account (First Party).

Key Differences between Personal token and OAuth+mTLS Authentication:

  • Personal token is replaced with a set of Refresh and Access Tokens
  • Token expiration and refresh mechanism

To understand the basics of OAuth 2.0, have a look at our Security & Access guide.

To understand the basics mTLS, have a look at our Enhanced Security guide.

In depth resources:

Migration Steps

Please execute the steps in the order they are listed in this guide and make sure to verify a step is successfully completed before moving to the next one.

We recommend you do the migration in our Sandbox test environment first, and only move to Production once you have verified that all business flows are working.

  1. Integrate and test in Sandbox
  2. Integrate and test in Production