> 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/ivanpay.md).

# Ivanpay

{% hint style="info" %}
If you need to update the 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 Account Settings

{% hint style="warning" %}
To discuss terms and connection, please contact a [service representative](https://t.me/IvanPay_pro).

**Disclaimer**: When connecting your website to any service, please assess the potential risks of collaboration on your own.
{% endhint %}

Register on the [IvanPay](https://ivanpay.com/) service.

In your merchant account, copy the information from the "**Your API Address**" field, as well as the API key provided to you by the service representative.

## Module Settings

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

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

<figure><img src="/files/nXUPmkoIboSStmVgYuMZ" alt="" width="417"><figcaption></figcaption></figure>

Fill in the required authorization fields.

**Domain** — the merchant's domain, previously copied from the merchant account in the "**Your API Address**" field.

**API Key** — the **API Key** provided to you by your Ivanpay manager.

## Special Fields

<figure><img src="/files/LkLaosNzUHVg0XUGdrne" alt="" width="199"><figcaption></figcaption></figure>

**Payment Method** — select the appropriate method for receiving funds.

{% hint style="warning" %}
Please note the unique feature of the Ivanpay service — a card from the bank you selected in the module settings will be issued **if possible**. However, if cards from the chosen bank are unavailable, a card from another bank that is currently available on the service will be issued (the method remains unchanged and stays as CARD or SBP).
{% endhint %}

{% hint style="warning" %}
When receiving funds using the Ivanpay merchant, it is **necessary** to add an additional field to the exchange form for the client to fill out when creating a request.

To do this, create and add an [additional field](https://premium.gitbook.io/main/en/basic-settings/valyuty-i-napravleniya/dobavlenie-novoi-valyuty#vkladka-dop.-polya) to the relevant currencies for receiving funds through Ivanpay. Be sure to specify in the "**Unique ID**" field — **`give_cardholder`** (use lowercase) and make the field mandatory.

After this, the field will appear in the exchange form and will be required for clients to fill out when creating a request.

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

## Continuing the Setup

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