Existing User Onboarding

This page contains the onboarding flow of existing Wise users to the integration.

For this scenario, the user already has an account with the email associated with the Wise Platform and they can authorize via web login and use the services offered by the platform via the API endpoints.

Requirements Authorisation

To get authorisation from an existing user, you will be required the following things:

1. Client Id

2. Redirection Url

Redirection url is the url that the middleware is gonna navigate the user after a succesful auth process. Client id is also required to uniquely indentify the client.

The user will have to login to the existing account with the following link. Please do mention that the following link is a Sandbox url:

https://sandbox.transferwise.tech/oauth/authorize/?client_id={clientId}&redirect_uri={redirectionUrl}

The below is the Production url:

https://wise.com/oauth/authorize/?client_id={clientId}&redirect_uri={redirectUri}

After visiting the link, the user will be asked to log in to the existing account. Once a user gives your banking app authorization to connect to Wise and access their data, the user is redirected back to your redirect_url with a generated code query string value. For example:

https://www.yourbank.com/transferwise-link-page/?code=[CODE]&profileID=123link

Your website or service can then use this code to obtain the access token to act on behalf of the user account. You will need this token to make a POST request to use the other Wise endpoints.

User Session Token

POST {{baseUrl}}/sessions/v1/fx/WISE/oauth/token

Request Body

Name	Type	Description
code*	String
redirectUri*	String

After getting a successful response, you can use the other endpoints related to the service. If the token expires, make another request to the previous endpoint to refresh the token in the middleware.

Profile Update with Address

You can get the address of the user by making a GET request to the following endpoint:

GEThttp://localhost:8084/v1/customers/fx/WISE/profiles/addresses

Path parameters

provider*enum

WISE

Response

202

Accepted

Body

*/*

namestring

addressLine1*string

addressLine2string

addressLine3string

city*string

country*string

postalCode*string

Request

JavaScriptCurl

const response = await fetch('http://localhost:8084/v1/customers/fx/WISE/profiles/addresses', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

[
  {
    "name": "text",
    "addressLine1": "text",
    "addressLine2": "text",
    "addressLine3": "text",
    "city": "text",
    "country": "text",
    "postalCode": "text"
  }
]

If the address is different from the customer bank details address, then update the profile address by making a POST request to the following endpoint below:

PATCHhttp://localhost:8084/v1/customers/fx/WISE/profiles/{profileId}

Path parameters

profileId*integer (int64)

Body

application/json

type*enum

personalbusiness

details*ProfileDetails (object)

Response

202

Accepted

Body

*/*

idinteger (int32)

typeenum

personalbusiness

detailsProfileDetails (object)

Request

JavaScriptCurl

const response = await fetch('http://localhost:8084/v1/customers/fx/WISE/profiles/{profileId}', {
    method: 'PATCH',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "details": {},
      "type": "personal"
    }),
});
const data = await response.json();

Response

{
  "type": "personal",
  "details": {
    "firstName": "text",
    "lastName": "text",
    "dateOfBirth": "text",
    "phoneNumber": "text"
  }
}