> 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/001k.bot.md).

# 001k.bot

{% 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 %}

{% hint style="warning" %}
To start working with the merchant you need to set up 2FA and complete KYC on their side.\
Disclaimer: when connecting your website to any service, please independently assess the potential risks of cooperation.
{% endhint %}

## Merchant Account Settings

Working with the merchant is done through a Telegram bot - <https://t.me/OO1kBOT>.

The keys required for the module are generated in the "Additional Features - API Access - Create a new API Key" section.

<figure><img src="/files/b6wNJFomL9gfeUwqM50x" alt=""><figcaption></figcaption></figure>

To generate API keys and begin working, you will first need to complete verification on the merchant's side and connect 2FA to your account.

<div><figure><img src="/files/TgYsNcQ11uXvZgLXJB0a" alt=""><figcaption></figcaption></figure> <figure><img src="/files/2qdy97irKdA5XZeHgJfE" alt=""><figcaption></figcaption></figure></div>

After the verification is complete, you will need to provide a name for the keys — this can be any text.

<div><figure><img src="/files/O8Rc0epp7rYmpupFW3hL" alt=""><figcaption></figcaption></figure> <figure><img src="/files/MIVl3q9W7gWQrOWe5yBa" alt=""><figcaption></figcaption></figure></div>

In the next step you will need to explicitly specify the actions that will be available for the key pair being created. For the merchant to accept funds, "Balance" and "Deposit" permissions will be sufficient.

If you also plan to use the payout module from 001k.bot, you can enable "Withdrawal" permissions right away.

<figure><img src="/files/hTzORs8DsoRZPDRv776Q" alt=""><figcaption></figcaption></figure>

And indicate that the keys are **not being created as read-only** by selecting "No" in the following prompt.

<figure><img src="/files/tzn5gcHZl1qWDGueHNT2" alt=""><figcaption></figcaption></figure>

You can then add your server's IP address to the merchant's whitelist or skip this step to allow all IPs.

<figure><img src="/files/VFrdlLLEGnVDEFHiuZC5" alt=""><figcaption></figcaption></figure>

The keys need to be activated immediately after they are created.

<figure><img src="/files/nJMDRlCCOhM26XQAHTPI" alt=""><figcaption></figcaption></figure>

After confirming all the specified options and confirming via 2FA, the API keys will be generated. Please copy these keys.

<figure><img src="/files/sezWA2RqeYmbrKWMIQd4" alt=""><figcaption></figcaption></figure>

## Module Settings

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

Select 001k from the drop-down list in the "**Module**" field, enter a name for the module, and click "**Save**."

<figure><img src="/files/WC32pQ6crsnpqxvTW8lt" alt="" width="525"><figcaption></figcaption></figure>

Fill in the specified authorization fields.

<figure><img src="/files/u0uKZtTOxp0WwDfwjhG5" alt="" width="525"><figcaption></figcaption></figure>

**Domain —** do not fill in this field, leave it empty.

**Access key —** the "Access key" copied earlier from the 001k bot.

**Secret key —** the "Secret" copied earlier from the 001k bot.

## Special Fields

<div><figure><img src="/files/y8HHmtSOYsqD53qG3LOc" alt=""><figcaption></figcaption></figure> <figure><img src="/files/B6VNDtXNC1ZBpBLMBaJg" alt=""><figcaption></figcaption></figure></div>

**Currency Code** (for selecting payment details):

* **Custom Fields (Order)** — use the currency code from the application (select **\[Send] Currency Code**)
* **Custom Fields (Currency)** — use the [additional currency field](https://premium.gitbook.io/main/en/basic-settings/currencies-and-exchange-directions/additional-fields#additional-fields-for-currency) "**Send**"
* **Custom Fields (Direction)** — use the [additional exchange direction field](https://premium.gitbook.io/main/en/basic-settings/currencies-and-exchange-directions/additional-fields#additional-fields-for-exchange-direction)
* **Currency Code** — manual selection of currency

<div><figure><img src="/files/Ioujz3a8Npk3EO3guWrY" alt=""><figcaption></figcaption></figure> <figure><img src="/files/L3p0rAFKrAsVUm7NnUcw" alt=""><figcaption></figcaption></figure></div>

**Network** (for cryptocurrencies):

* **Custom Fields (Currency)** — use the [additional currency field](https://premium.gitbook.io/main/en/basic-settings/currencies-and-exchange-directions/additional-fields#additional-fields-for-currency) "**Send**"
* **Custom Fields (Direction)** — use the [additional exchange direction field](https://premium.gitbook.io/main/en/basic-settings/currencies-and-exchange-directions/additional-fields#additional-fields-for-exchange-direction)
* **Network** — manual selection of network

**Cron file —** [create a task](https://premium.gitbook.io/main/osnovnye-nastroiki/faq/kak-sozdat-zadanie-cron-na-servere) with this link on the server.

## Continuing the Setup

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