# Setup instructions

**Why do you need to create a widget?**\
A project represents an entity through which interaction with Inqud is conducted. By creating different projects (widgets), you can separate the flow of funds, which allows for more efficient financial operations. For example, if a merchant has two websites, they can create two separate projects with individual settings for each. This will not only separate the flow of funds but also allow unique parameters for each project, enabling more flexible management.

### <mark style="color:green;">**How to create a new widget**</mark>**&#x20;(required step)**

To create a new project (widget), follow these steps:

1. Go to your dashboard.
2. Open the **Widgets** page.
3. Click on **Add new widget**.
4. Enter the name of the widget in the form that appears.
5. Set the activation status using the **Active** toggle.

{% hint style="info" %}
You can activate or deactivate the widget at any time.
{% endhint %}

<figure><img src="https://2493659114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVvChLJdAqFu9uz7E-7%2Fuploads%2FCTXMYh8khBWnW7Svkn3o%2Fcreating%20flow.gif?alt=media&#x26;token=192965e1-c769-42ac-bdd2-f6129bc176b3" alt=""><figcaption></figcaption></figure>

### <mark style="color:green;">**Currency settings**</mark>**&#x20;(required step)**

This section displays all currently available deposit options that your users can use. You will see a list of cryptocurrencies and their corresponding networks. The list of activated currencies and networks determines what your users will see in their deposit currency list.

Use the **Active** toggle to manage currencies. When activated, all networks for the selected currency will be enabled.

If you wish to enable or disable specific networks, you can activate or deactivate the necessary networks by checking or unchecking the respective boxes.

<figure><img src="https://2493659114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVvChLJdAqFu9uz7E-7%2Fuploads%2Fu447f247hOurwPnvPWW7%2Fcurrency%20settings.gif?alt=media&#x26;token=1b40e561-141c-4eb9-a6ed-446319e373d1" alt=""><figcaption></figcaption></figure>

### <mark style="color:green;">**Auto-conversion**</mark>**&#x20;(optional step)**

You can choose the currency to which incoming funds will be converted for each specific cryptocurrency. To set up auto-conversion, select the desired currency from the list. All incoming payments in Currency 1 will be automatically converted to Currency 2.

<figure><img src="https://2493659114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVvChLJdAqFu9uz7E-7%2Fuploads%2FnGVekUGXNaME4mLrWhON%2Fauto%20convert%20settings.gif?alt=media&#x26;token=e375b5bc-12ee-41b2-9b8c-782af12d9c50" alt=""><figcaption></figcaption></figure>

### <mark style="color:green;">**Fee settings**</mark>

A platform fee is charged for each transaction, which is deducted at the time the funds are received. For example, when 100 USDT is received, the fee might be 5 USDT, resulting in 95 USDT being credited to the balance. However, you can pass this fee on to your users by enabling the \
\ <mark style="background-color:green;">**Fee is paid by end user**</mark> setting. In this case, the fee will be passed to the end user after all calculations. Note that when this setting is enabled (when using the Inqud-branded UI), the user will be informed about the fee they will pay. If you do not want the user to see this information, you can activate the \
\ <mark style="background-color:green;">**Hide fee from user**</mark> setting. This way, the fee will still be charged to the user, but the information will not be displayed.

{% hint style="warning" %}
*Important*: This function is relevant only for checkouts with the **Fixed\_price** type.
{% endhint %}

<figure><img src="https://2493659114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVvChLJdAqFu9uz7E-7%2Fuploads%2FlNJhn2kz83A4LlgbXAFw%2Ffee%20settings.gif?alt=media&#x26;token=13e794f0-8815-4d6e-af62-3bf08306d3cb" alt=""><figcaption></figcaption></figure>

### <mark style="color:green;">**Domain management**</mark>**&#x20;(optional step)**

To use acquiring in the widget format, it is necessary to verify the domain on which the widget will be placed. To verify a domain, follow these steps:

1. Go to **Widgets >> Domains**.
2. Click the **Add** button.
3. Complete the form by entering the domain for verification (without using **http\://** or **https\://**).
4. Submit the form.

{% hint style="info" %}
The domain verification process can take up to 24 hours during business hours. Once the domain is successfully verified, it will be assigned the status **Approved** or **Rejected**.&#x20;
{% endhint %}

If the domain is **Approved**, it can be linked to a project:

1. Go to the desired widget.
2. Open the **Domain management** tab.
3. You will see all verified domains in the list and can link any of them to the project.

{% hint style="info" %}
Domain verification is required only for acquiring in widget format. For other acquiring formats, domain verification is not needed.
{% endhint %}

<figure><img src="https://2493659114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVvChLJdAqFu9uz7E-7%2Fuploads%2Fa3LE8ZqptuVUmPZAuGvc%2Fdomain%20management.gif?alt=media&#x26;token=530c2728-b3eb-478a-a2b2-1f5a275769b6" alt=""><figcaption></figcaption></figure>

### <mark style="color:green;">**Webhooks**</mark>**&#x20;(recommended step)**

You need to set up webhooks for **Requests** and **Checkouts**.&#x20;

{% hint style="info" %}
Additional information about <mark style="color:green;">**Requests**</mark> can be found [\[at this link\]](https://docs.inqud.com/crypto-widget/explore/requests)

Additional information about <mark style="color:green;">Request webhooks</mark> can be found [\[at this link\]](https://docs.inqud.com/crypto-widget/integration/web-hooks/request-web-hook)
{% endhint %}

{% hint style="info" %}
Additional information about <mark style="color:green;">**Checkouts**</mark> can be found [\[on this page\]](https://docs.inqud.com/crypto-widget/explore/checkouts)

Additional information about <mark style="color:green;">**Checkout webhooks**</mark> can be found [\[on this page\]](https://docs.inqud.com/crypto-widget/integration/web-hooks/checkout-web-hook)
{% endhint %}

1. Click **ADD**.
2. Enter the webhook URL (mandatory field) in the form that appears.
3. Optionally, provide a **Webhook secret**.
4. Click **Submit** to save the settings.

{% hint style="info" %}
Additionally, we recommend setting up a webhook for <mark style="color:green;">**Payments**</mark>. Detailed instructions can be found [\[at this link\]](https://docs.inqud.com/developer/web-hooks/payment-web-hook).
{% endhint %}

### <mark style="color:green;">Predefined amounts</mark>

**How to set up the Predefined Amount model**

To use the Predefined Amount model, follow these steps:

1. Go to the **Predefined Amounts** tab.
2. Click the **Setup Predefined Amounts** button.
3. In the pop-up window, select the currency that will be set as **Amount In** — the currency from which incoming cryptocurrency payments will be converted.
4. Enter up to three possible amount options in the input field in the selected currency.
5. Toggle **Allow Manual Input** to enable users to manually enter an amount in the chosen currency for deposits.
6. Save your settings.

Once the settings are saved, when using the **Checkout Suggested Amount** type, users will see the predefined options you configured.<br>

<figure><img src="https://2493659114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVvChLJdAqFu9uz7E-7%2Fuploads%2FXAiGfQxgdq4FqrWcgGyg%2Fpredefined%20amount%20settings.gif?alt=media&#x26;token=2583e216-4c6a-438c-9a41-6ee4f89b4a1e" alt=""><figcaption></figcaption></figure>

### <mark style="color:green;">**How to create a Payment Link**</mark>

1. **Go to the Payment links tab**: \
   In your widget's settings, navigate to the **Payment links** tab.
2. **Click on "Setup payment link"**: \
   In this tab, locate and click the **Setup payment link** button to begin the payment link creation process.
3. **Select the model and enter initial amount**:
   * Choose the desired model from the dropdown menu.
   * Enter the initial amount that the user will need to pay (Note: Entering this amount is only relevant for the Fixed Price model).
4. **Select the expiration date**: Choose the date until which the link will remain active.
5. **Create the Link**: Once you’ve filled in the required fields, click to create the payment link.
6. **Copy the Link**: After the link is generated, copy it to share with your user.

<figure><img src="https://2493659114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVvChLJdAqFu9uz7E-7%2Fuploads%2FTzA663BMiUcD9GHn3EGd%2Fpayment%20link%20settings%20gif.gif?alt=media&#x26;token=19cfa975-54d0-446e-8a9d-aabb6f9b77ad" alt=""><figcaption></figcaption></figure>
