> For the complete documentation index, see [llms.txt](https://premium.gitbook.io/main/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://premium.gitbook.io/main/en/basic-settings/merchants-and-auto-payments/merchants/utopia.md).

# Utopia

{% hint style="info" %}
If you need to update a module on the server, please refer to the [instructions](https://premium.gitbook.io/main/en/en/basic-settings/faq/updating-script-files-on-the-server/how-to-update-files-on-the-server#merchant-and-auto-payout-modules).
{% endhint %}

## Merchant-Side Settings

{% hint style="warning" %}
For initial setup of the service on your server, you can get assistance from the merchant's technical support:

* Utopia Messenger: UNKNOWN1<br>
* Telegram: [@utp1984](https://t.me/utp1984)
* Email: <1984@u.is>
  {% endhint %}

Download the [Utopia application](https://u.is/en/download.html) for your operating system and install it. Go through the registration process and create a new wallet.

## Module Settings

In the admin panel, create a new merchant in the "**Merchants**" section by selecting "**Add Merchant**."

Choose Utopia from the dropdown menu in the "**Module**" field, enter a name for the module, and click "**Save**."

<figure><img src="/files/zrhNn9inKbraj8go4bVR" alt="" width="418"><figcaption></figcaption></figure>

Fill in the required authorization fields.

<figure><img src="/files/EperSjbKaQPBKXKl1bIM" alt="" width="452"><figcaption></figcaption></figure>

**Domain** — URL for connection (IP address of your server + port assigned to the application during initial setup)

**Token** — public key (your wallet address obtained during registration with the service)

{% hint style="info" %}
To ensure proper processing of the details, the currency code in "Give" must be selected as USD, UUSD, or CRP (Crypton token).

<img src="/files/TsXquc74FMJSZYZlusf7" alt="" data-size="original">
{% endhint %}

## Utopia Voucher Module

To accept Utopia vouchers as payment, set up a separate module.

### Module Settings

In the admin panel, create a new merchant in the "**Merchants**" section by selecting "**Add Merchant**."

Choose Utopia Voucher from the dropdown menu in the "**Module**" field, enter a name for the module, and click "**Save**."

<figure><img src="/files/q734pU0cRUkNkXiz5nh2" alt="" width="471"><figcaption></figcaption></figure>

Fill in the required authorization fields.

<figure><img src="/files/EperSjbKaQPBKXKl1bIM" alt="" width="452"><figcaption></figcaption></figure>

**Domain** — URL for connection (IP address of your server + port assigned to the application during initial setup)

**Token** — public key (your wallet address obtained during registration with the service)

{% hint style="warning" %}
To properly accept vouchers, the currency code in "**Give**" must be set to UUSD (US Dollar) or CRP (native Utopia token).

<img src="/files/OSOSPIif43lFb9EVN7om" alt="" data-size="original">

In the exchange form, there is no need to add a field for "**From Account**" for the currency "**Give**" — in the created request, the client will see a button labeled "**Proceed to Payment**." When clicked, this will open a page with a field for entering the voucher code. After entering the correct code, the client will be redirected back to the request page.
{% endhint %}

## Continuing the Setup

Next, proceed with the merchant setup by following the [general setup instructions](https://premium.gitbook.io/main/en/en/basic-settings/merchants-and-auto-payments/merchants/general-merchant-settings).