Get Started

Introduction

The Van Lanschot XS2A sandbox contains documentation and specification for the XS2A endpoints it will expose. These endpoints show the format and structure of these API's and can be used to develop against. The data provided by these API's is fictious and is in no way connected to the existing Van Lanschot backend systems.

Registering

In order to use the API's in this sandbox you need to acquire a subscription key. To get a subscription key you first need to register. You can either register by entering your details or use an existing account (for example from Microsoft of Github) through Active Directory B2C (follow the link on the signup/signin pages).

Subscribing

Once you're registered you can view API Marketplace. Here you can see the API's that we have on offer. While you can try out the API's directly from this portal you will need to subcribe first. For this you need to select the product you are interested in from the subscribe page. Each product corresponds to various TPP roles. Select the product you need and then hit the subcribe button.

In order to try out our interactive development portal we require you to connect with a (test) QWAC for the TLS connection and sign your messages with a (test) Qseal certificate.

For the signature please follow the instructions in chapter 12 of the Berlin group: https://docs.wixstatic.com/ugd/c2914b_4a9b0db8c35841adb91531ef0faba4c2.pdf

Besides the header elements mentioned in this guide, we also require the Date header as was indicated in previous Berlin group specs iterations

Accessing the API's

After you've subscribed you can find your subscription key in your profile. With this key you can also access the sandbox API's outside of this portal. A fixed set of cases has been defined that cover the functionality provided.

In order to call the API's outside of this portal you'll need to provide the subscription key through a Ocp-Apim-Subscription-Key header in your request.

Registration for production environment

We are now accepting registrations to our production environment. In order to register, please send an e-mail to xs2a-registrations@vanlanschotkempen.com. In order to register we require the following information:

  • A copy of your license showing what roles you have
  • The name of your organization
  • Your name, address, phone number and e-mail address
  • The contact information for your organization's technical support.

After verifying your information we will contact you with details on how to access our production environment.