Onboarding to SVX

To onboard to Secure Value Exchange (SVX) you will first need to sign up. Navigate to our sign up form to gain access to our Sandbox. Once your access has been approved, you will be able to log in to the SVX Portal. From here you can:

• Use the Portal UI to manage workflows, and

• Directly access the SVX Sandbox API.

Using the Portal UI

Navigate to the Portal login page and log in using your SVX credentials. Refer to the Portal tutorials where you can find step-by-step instructions to navigate the Portal and manage a Tenancy and / or an Organisation.

Accessing the SVX Sandbox API

To directly access the SVX Sandbox API you will need to follow the steps below:

1. Access the SVX Sandbox API documentation:

Navigate to the SVX Sandbox API documentation. At the top of the landing page, you will see the OpenAPI3 specification. Download the specification and import it into Postman.

Note To download the OpenAPI3 specification into Postman, follow these simple steps:

1. Download the specification from the API documentation landing page

2. Open Postman

3. Import the downloaded .json file

2. Retrieve a Personal Access Token

Open Postman and create a new request by clicking on the New button in the upper-left corner.

Navigate to the Authorization tab, which is located below the URL field.

In the Authorization tab, select OAuth 2.0 from the Type dropdown menu.

Fill in the OAuth 2.0 Access Token Request Details:

Grant Type: Authorization Code with PKCE
Auth Url: https://login-sandbox.securevalueexchange.com/oauth2/auth
Access Token URL: https://login-sandbox.securevalueexchange.com/oauth2/token
Client ID: ed3d2366-0fb6-406e-ae72-afd7634e6c9f
Scope: openid profile email offline_access

After filling in the required details, click on the Request Token button. This will initiate the OAuth 2.0 authentication process.

You will be redirected to the authorisation page of the service you are connecting to. Log in using your SVX login credentials.

After successful authorisation, you will be redirected back to Postman, and the personal access token will be automatically saved.

Note Your Personal Access Token will expire after 1 hour. Just like the Application Token, you will be required to refresh it to maintain access.

3. Refresh your Personal Access Token

To refresh the Personal Access Token, you need to make a POST request to the OAuth2 token endpoint with a valid refresh token and your client and tenant IDs.

curl 'https://login-sandbox.securevalueexchange.com/oauth2/token' \
  -H 'content-type: application/x-www-form-urlencoded' \
  --data-raw 'grant_type=refresh_token&refresh_token=existing_token&client_id=ed3d2366-0fb6-406e-ae72-afd7634e6c9f&tenant_id=32a08dc4-ad7f-491a-a06c-3284592a3737' \
  --compressed

Make sure to replace existing_token, client_id, and tenant_id with your specific values.

4. Access the SVX Sandbox API

With the obtained personal access token, you can now use the SVX Sandbox API. For example, if you want to access the me endpoint, use the following cURL command:

   curl --location 'https://api-sandbox.svx.exchange/me' \
   --header 'Meeco-Organisation-Id: YOUR_ORGANISATION_ID' \
   --header 'Accept: application/json' \
   --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Replace YOUR_ORGANISATION_ID with the relevant ID for your organisation, and YOUR_ACCESS_TOKEN with the token obtained in the previous step. You should now be able to successfully access the SVX Sandbox API using the provided authorisation token.

For additional support, review the API Guides or contact the Service Desk.