> 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="https://3137668309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwgP5ZE7DnnlT9DQMSCQz%2Fuploads%2Fgit-blob-137ca8b8baca58aee9504b8493ed3ea0da2273e8%2Fimage%20(1989)_eng.png?alt=media" alt="" width="418"><figcaption></figcaption></figure>

Fill in the required authorization fields.

<figure><img src="https://3137668309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwgP5ZE7DnnlT9DQMSCQz%2Fuploads%2Fgit-blob-a6b6c04d30a91c4e67af5b4f265f92b8a1fbdabb%2Fimage%20(1990)_eng.png?alt=media" 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="https://3137668309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwgP5ZE7DnnlT9DQMSCQz%2Fuploads%2Fgit-blob-a294032e9d461ad1aef0ca725bea63d9813efe6d%2Fimage%20(199).png?alt=media" 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="https://3137668309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwgP5ZE7DnnlT9DQMSCQz%2Fuploads%2Fgit-blob-0bc8123157d60154f6ea3284caa9c67199528c99%2Fimage%20(200).png?alt=media" alt="" width="471"><figcaption></figcaption></figure>

Fill in the required authorization fields.

<figure><img src="https://3137668309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwgP5ZE7DnnlT9DQMSCQz%2Fuploads%2Fgit-blob-a6b6c04d30a91c4e67af5b4f265f92b8a1fbdabb%2Fimage%20(1990)_eng.png?alt=media" 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="https://3137668309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwgP5ZE7DnnlT9DQMSCQz%2Fuploads%2Fgit-blob-cbef571405536612fc8fd86618be213f5dcc0f9c%2Fimage%20(201).png?alt=media" 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).
