# Utopia

{% hint style="danger" %} <mark style="color:red;">Before setting up auto payouts, please read the</mark> [<mark style="color:blue;">risk warning</mark>](https://premium.gitbook.io/main/en/basic-settings/merchants-and-auto-payments/auto-payments/risk-warning)<mark style="color:blue;">!</mark>
{% endhint %}

{% hint style="info" %}
If you need to update the module on your 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="info" %}
For initial setup of the service on your server, you can get assistance from merchant support:

* Utopia Messenger: UNKNOWN1\
  ![](https://github.com/armydrawer/premium-translate/blob/main/en/.gitbook/assets/image%20\(248\)_eng.png)
* 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.

<figure><img src="https://3137668309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwgP5ZE7DnnlT9DQMSCQz%2Fuploads%2Fgit-blob-297631e71e87c378211cd46555eadb21d599d738%2Fimage%20(1995)_eng.png?alt=media" alt="" width="375"><figcaption><p>Creating an Account</p></figcaption></figure>

<figure><img src="https://3137668309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwgP5ZE7DnnlT9DQMSCQz%2Fuploads%2Fgit-blob-5b90244ce9ae937dc45c891ad9f7a30766c6a4fa%2Fimage%20(1996)_eng.png?alt=media" alt=""><figcaption><p>Fill in the required fields</p></figcaption></figure>

<figure><img src="https://3137668309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwgP5ZE7DnnlT9DQMSCQz%2Fuploads%2Fgit-blob-535739e79ce4cc5044d51e40ff418851808a674d%2Fimage%20(1998)_eng.png?alt=media" alt=""><figcaption><p>Specify the path to the folder where the private key will be stored and create a password for your wallet</p></figcaption></figure>

<figure><img src="https://3137668309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwgP5ZE7DnnlT9DQMSCQz%2Fuploads%2Fgit-blob-1c19cedf7b20e58afa94bef75ed4063092bfcb21%2Fimage%20(1999)_eng.png?alt=media" alt=""><figcaption><p>Generating the Private Key</p></figcaption></figure>

<figure><img src="https://3137668309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwgP5ZE7DnnlT9DQMSCQz%2Fuploads%2Fgit-blob-533e996f28ce19714b3d78605d72aeb71d2062eb%2Fimage%20(2000)_eng.png?alt=media" alt=""><figcaption><p>The public key is your wallet address</p></figcaption></figure>

<figure><img src="https://3137668309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwgP5ZE7DnnlT9DQMSCQz%2Fuploads%2Fgit-blob-b462821894b22ebb7e2573d7480fa0e4861cab28%2Fimage%20(2003)_eng.png?alt=media" alt=""><figcaption><p>Main Page of the Application</p></figcaption></figure>

<figure><img src="https://3137668309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwgP5ZE7DnnlT9DQMSCQz%2Fuploads%2Fgit-blob-533e996f28ce19714b3d78605d72aeb71d2062eb%2Fimage%20(2001)_eng.png?alt=media" alt="" width="326"><figcaption><p>Available Currencies</p></figcaption></figure>

## Module Settings <a href="#nastroiki-modulya" id="nastroiki-modulya"></a>

In the admin panel, create a new merchant in the "**Auto Payouts**" -> "**Add Auto Payout**" section.

Select Utopia from the dropdown list in the "**Module**" field, provide 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-d541a3f7877696c339af0e9600bc1cd9866bbec0%2Fimage%20(1992)_eng.png?alt=media" alt="" width="390"><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-ef7f908940ece24aca1d7a2f88bb91ee427562d7%2Fimage%20(1993)_eng.png?alt=media" alt="" width="428"><figcaption></figcaption></figure>

**API Key** — the key copied from the merchant's personal account

**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 correct issuance of details, the currency code in "**Receiving**" should 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-8289f7289ea28b8f4ffbde21ca23272c69363662%2Fimage%20(2002)_eng.png?alt=media" alt="" data-size="original">
{% endhint %}

## Utopia Voucher Module

To issue Utopia vouchers, set up a separate module.

### Module Settings <a href="#nastroiki-modulya-1" id="nastroiki-modulya-1"></a>

In the admin panel, create a new merchant in the "**Auto Payouts**" -> "**Add Auto Payout**" section.

Select Utopia Voucher from the dropdown list in the "**Module**" field, provide a name for the module, and click "**Save**".

<figure><img src="https://github.com/armydrawer/premium-translate/blob/main/en/.gitbook/assets/image%20(193)_eng.png" alt="" width="453"><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-ef7f908940ece24aca1d7a2f88bb91ee427562d7%2Fimage%20(1993)_eng.png?alt=media" alt="" width="428"><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)

<figure><img src="https://github.com/armydrawer/premium-translate/blob/main/en/.gitbook/assets/image%20(193)_eng.png" alt="" width="453"><figcaption></figcaption></figure>

### Special Fields

<figure><img src="https://github.com/armydrawer/premium-translate/blob/main/en/.gitbook/assets/image%20(194)_eng.png" alt="" width="362"><figcaption></figcaption></figure>

**User Email** — choose the type of field that the client will fill out in the exchange form — the voucher will be sent to the specified email upon auto payout request.

{% hint style="info" %}
By default, the "**User Email**" option is selected — a mandatory field that the client fills out when creating a request.

<img src="https://github.com/armydrawer/premium-translate/blob/main/en/.gitbook/assets/image%20(196)_eng.png" alt="" data-size="original">

If you want the client to specify a different email for receiving the coupon, rename the "**To Account**" field in the currency settings to "**Email for Voucher**" or "**Email to Send Voucher**".

<img src="https://github.com/armydrawer/premium-translate/blob/main/en/.gitbook/assets/image%20(197)_eng.png" alt="" data-size="original">
{% endhint %}

## Continuing the Setup

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