# EasyOnboarding
## Overview
The EasyOnboarding is a redirect solution as an alternative to the [Javascript-Widget](https://guide.xs2a.com/xs2a/integration-cs/integration-variants/javascript-widget) or the [Wizard-API](https://guide.xs2a.com/xs2a/integration-cs/integration-variants/wizard-api). With this solution, we will host a standalone page on our system that can be used to redirect a user to finish the process there.
## Look and feel
#### **Payment Platform (xs2a.pay)**
For the Payment Platform (xs2a.pay) you can configure your Payform pretty simple, fast, and without any deep technical knowledge in our customer cockpit.
*What do you need to configure your customized Payform?*
1. Go to and log into our customer cockpit with your credentials
2. Select "Configure" and go to "Payform"
3\. Start configuration by editing texts, colors and upload your images:
4\. Save your configured Payform
5\. Check your preview and if needed edit your configuration once again
#### **Analytics Platform (xs2a.risk)**
We are able to design and create the page for your requirements. Starting from the Colors to the Layout around our [Javascript-Widget](https://guide.xs2a.com/xs2a/integration-cs/integration-variants/javascript-widget) everything can be adjusted to fit your needs.
## How to use
### Static configuration
This can be used if the configuration for each session and all customers will stay the same. We create the session then directly if the page is opened so that it is only required to redirect a user to the page. You will receive a url that you can redirect a user to.
It is needed to register two redirect urls where we will redirect the customer in case of success or an error/abort.
{% tabs %}
{% tab title="Example url" %}
```
https://manage.xs2a.com/start/exampledoc
```
{% endtab %}
{% endtabs %}
### Dynamic configuration
This needs to be used if the configuration per session of the customer is different. In this case, you need to create your session via REST-API and pass the `wizard-session-key` from our response combined with the page url to the redirect.
The redirect urls for success and error/abort are also needed here, they can be also configured dynamically in the session you received the `wizard-session-key` from.
{% tabs %}
{% tab title="Example url" %}
```
https://manage.xs2a.com/start/exampledoc/
```
{% endtab %}
{% endtabs %}
For more information on how to create a session please read the guide for the specific product that should be used.
{% content-ref url="../platforms/pay" %}
[pay](https://guide.xs2a.com/xs2a/integration-cs/platforms/pay)
{% endcontent-ref %}
{% content-ref url="../platforms/risk" %}
[risk](https://guide.xs2a.com/xs2a/integration-cs/platforms/risk)
{% endcontent-ref %}
{% content-ref url="../platforms/api" %}
[api](https://guide.xs2a.com/xs2a/integration-cs/platforms/api)
{% endcontent-ref %}
## Metadata
It is possible to pass up to 3 key-value pairs as metadata to the EasyOnboarding. This is limited by a key length of 20 characters and a value length of 128 characters. The key-value pairs will be appended as query parameters
{% tabs %}
{% tab title="Example url with static configuration" %}
```
https://manage.xs2a.com/start/exampledoc?key1=value1&key2=value2&key3=value3
```
{% endtab %}
{% tab title="Example url with dynamic configuration" %}
```
https://manage.xs2a.com/start/exampledoc/?key1=value1&key2=value2&key3=value3
```
{% endtab %}
{% endtabs %}
The Information you provide there can be found in the resulting webhook or in the transaction object itself.
{% content-ref url="../additional-guides/webhooks" %}
[webhooks](https://guide.xs2a.com/xs2a/integration-cs/additional-guides/webhooks)
{% endcontent-ref %}
## Use an own domain
It is possible to use every domain you want as long as you can set the correct DNS record and provide an SSL certificate for it. The address `https://manage.xs2a.com/start/` will then replaced with your domain.
##