> For the complete documentation index, see [llms.txt](https://rules.flipside.net.ua/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rules.flipside.net.ua/guide/bank.md).

# Банк на сервері

## Загальний список бот-команд пов'язаних з банком

{% hint style="info" %}
Всі команди в даному списку є слеш-командами, тобто їх треба прописувати через /
{% endhint %}

<table><thead><tr><th width="170">Команда</th><th width="292">Функціонал</th><th width="131">Доступність<select><option value="yBv0LhjzJa2T" label="Всі" color="blue"></option><option value="GBejjgHmyenw" label="СБФ" color="blue"></option><option value="KqblpYCqxDYa" label="Суд" color="blue"></option><option value="1K1PNJom5cPu" label="СБФ &#x26; Суд" color="blue"></option><option value="zIZAZGV34oIr" label="Президент" color="blue"></option><option value="r74eqR7wOugc" label="Банк" color="blue"></option></select></th><th data-type="checkbox">Доступність в ПП</th></tr></thead><tbody><tr><td>рахунки</td><td>Перегляд рахунків користувача</td><td><span data-option="yBv0LhjzJa2T">Всі</span></td><td>true</td></tr><tr><td>створити_карту</td><td>Створення приватного рахунку користувачка</td><td><span data-option="yBv0LhjzJa2T">Всі</span></td><td>false</td></tr><tr><td>поділитись</td><td>Поділитись доступом до вашого рахунку з іншим гравцем</td><td><span data-option="yBv0LhjzJa2T">Всі</span></td><td>false</td></tr><tr><td>забрати_доступ</td><td>Позбавити стороннього гравця доступу до вашого рахунку</td><td><span data-option="yBv0LhjzJa2T">Всі</span></td><td>false</td></tr><tr><td>переказ</td><td>Зробити переказ ДР (Діамантової Руди) іншому гравцю</td><td><span data-option="yBv0LhjzJa2T">Всі</span></td><td>false</td></tr><tr><td>штраф</td><td>Виписати гравцю штраф</td><td><span data-option="1K1PNJom5cPu">СБФ &#x26; Суд</span></td><td>false</td></tr><tr><td>юр_рахунок</td><td>Створити для гравця юридичний рахунок</td><td><span data-option="zIZAZGV34oIr">Президент</span></td><td>false</td></tr><tr><td>add_money</td><td>Покласти на рахунок користувача ДР</td><td><span data-option="r74eqR7wOugc">Банк</span></td><td>false</td></tr><tr><td>remove_money</td><td>Зняти з рахунка користувача ДР</td><td><span data-option="r74eqR7wOugc">Банк</span></td><td>false</td></tr><tr><td>налаштування</td><td>Видалення карток, підключення API сповіщень</td><td><span data-option="yBv0LhjzJa2T">Всі</span></td><td>false</td></tr></tbody></table>

## Комісії банку

1. Комісія на зняття ДР з рахунку - 10% або мінімум 1 ДР (джерело зняття комісії(з рахунку в банку/з отриманих ДР) обирає клієнт). Комісія на зняття ДР з рахунків не поширюється на рахунки підприємців, які згадані у зареєстрованих ліцензіях на бізнес і що займаються благодійністю і були згадані у наказі Президентом або Головою банку як такі, що звільняються від комісії у зв'язку зі згаданими підставами.
2. Комісія на зняття з ДР з рахунків особи, яка оформила кредит і є у процесі його сплати або отримання - 20% або мінімум 3 ДР (джерело зняття комісії(з рахунку в банку/з отриманих ДР) обирає клієнт).

## Як покласти кошти на рахунок?

{% hint style="info" %}

### Для банкірів:

Створено дві відповідні команди, при написанні яких потрібно указати номер рахунку і суму

![](https://885903010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlmnCYfRPChlzs40DJIDl%2Fuploads%2FijqKJMd7qzVz2g8McayV%2Fimage.png?alt=media\&token=62081b4b-8f23-4866-9823-148add448a73)![](https://885903010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlmnCYfRPChlzs40DJIDl%2Fuploads%2FZQchAHPnYhO8nG028hG4%2Fimage.png?alt=media\&token=770089c8-1bd6-4cdd-8abb-d3717b5fadbc)
{% endhint %}

Для того щоб покласти ДР на свій рахунок в банку є 2 способи

{% stepper %}
{% step %}

### Через банкіра одразу

Якщо на сервері онлайн знаходиться банкір, то ви можете попросити його зайти в банк, і на другому поверсі через нього покласти ДР собі на рахунок

<figure><img src="https://885903010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlmnCYfRPChlzs40DJIDl%2Fuploads%2FK7USGLs5Unwd5FkpjUdk%2Fimage.png?alt=media&amp;token=2afa9b9b-f856-46a2-bc75-2fb4cd7df486" alt=""><figcaption><p>Фото місця де можна покласти кошти через банкіра</p></figcaption></figure>
{% endstep %}

{% step %}

### Через "Банкомат"

Якщо на сервері нема банкіра, то на першому поверсі ви можете залишити у вільному "Банкоматі"(бочні) свої ДР, і написати банкіру в приватні повідомлення Діскорд номер "Банкомата"(він зображений на бочці), суму ДР і номер рахунку на який ви хочете покласти кошти

<figure><img src="https://885903010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlmnCYfRPChlzs40DJIDl%2Fuploads%2F9dID4a46ArKDIdjDlzaL%2Fimage.png?alt=media&amp;token=4d35e733-5ef3-49a7-8b18-b943f8a96601" alt=""><figcaption><p>Скріншот зроблено в тестовому світі для будівель, на самому сервері бочки пронумеровані</p></figcaption></figure>
{% endstep %}
{% endstepper %}

## Штрафи

### Інформація по оплаті

В спеціальному каналі для вас може бути призначено штраф за якесь порушення.\
Для оплати в повідомленні є кнопка "Сплатити штраф", після натискання якої з'явиться приватне повідомлення з вибором вашої картки, після вибору якої штраф буде сплачено.\
Після оплати потрібно повідомити про це Службу Безпеки Фліпсайд

{% hint style="warning" %}
Не рекомендується намагатись більше декількох раз оплатити один і той самий штраф, бо бот може за ці рази теж списувати ДР

!!! Цю проблему буде віришено найближчим часом
{% endhint %}

### Інформація для СБФ і Суду

#### Як виписати штраф:

{% stepper %}
{% step %}

### Під час написання команди, потрібно обрати корситувача якому призначено штраф

<div align="left"><figure><img src="https://885903010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlmnCYfRPChlzs40DJIDl%2Fuploads%2FBuChi0gj23pXhu8NV3Xt%2Fimage.png?alt=media&amp;token=6a0ec5c8-ea7d-42f0-b287-d848d2ecc2ff" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Після написання команди відкривається вікно, в якому потрібно заповнити декілька пунктів

1. Суму штрафу
2. Номер картки на яку мають прийти кошти після оплати штрафу
3. Причина, за якою було виписано штраф. Держ службовцям рекомендується в цьому полі також вписувати номер штрафу.

<div align="left"><figure><img src="https://885903010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlmnCYfRPChlzs40DJIDl%2Fuploads%2FJCk43eZV9dcg7c2I6oux%2Fimage.png?alt=media&amp;token=c362b3cd-8e13-4c04-8a13-68a9eb8fae39" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

## Створення рахунків

Після написання відповідної команди відкриється вікно, де потрібно вказати назву рахунку

{% hint style="info" %}
Змінити назву рахунку на даний момент неможливо
{% endhint %}

<div align="left"><figure><img src="https://885903010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlmnCYfRPChlzs40DJIDl%2Fuploads%2FfsYkqQTfsNojaAULZfwc%2Fimage.png?alt=media&amp;token=9cc936bd-019a-482c-bd57-f2aa3838250a" alt=""><figcaption></figcaption></figure></div>

Після написання назви рахунку, у вас буде створено рахунок, з випадково згенерованим номером з 5 чисел

## Як поділитись рахунком?

Щоб поділитись рахунком, потрібно під час прописання команди обрати користувача, і написати номер вашої картки з якою ви хочете поділитись, після чого той з ким ви поділились рахунком отримає доступ до нього, а у вас в списку рахунків біля нього буде показано окрему іконку

<div align="left"><figure><img src="https://885903010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlmnCYfRPChlzs40DJIDl%2Fuploads%2F0yXsK3G1aY6ixJ15JI1f%2Fimage.png?alt=media&amp;token=5d40c0d2-393c-462a-b714-4c4fc234a184" alt=""><figcaption><p>Написання команди</p></figcaption></figure></div>

Щоб забрати доступ, потрібно написати відповідну команду і там обрати рахунок

<div align="left"><figure><img src="https://885903010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlmnCYfRPChlzs40DJIDl%2Fuploads%2FV4MQsL76gVLqIf1bXAV2%2Fimage.png?alt=media&amp;token=dcb7132e-d39b-4fe2-a182-c09f61b74f71" alt=""><figcaption></figcaption></figure></div>

## Як переказати кошти?

{% stepper %}
{% step %}

### Написання команди

Потрібно написати відповідну команду, де указати номер отримувача

<div align="left"><figure><img src="https://885903010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlmnCYfRPChlzs40DJIDl%2Fuploads%2Fa4QcFgJuj0OhwWwRyN8h%2Fimage.png?alt=media&amp;token=63cef7f8-ee60-474e-a695-7f4f9f3ef7d9" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Вибір картки

В наступному повідомленні треба обрати картку з якої робити переказ

<div align="left"><figure><img src="https://885903010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlmnCYfRPChlzs40DJIDl%2Fuploads%2Flwoth6UclwZTzY7wIbXJ%2Fimage.png?alt=media&amp;token=542bca72-8de3-42bf-a5ec-9206b53f20aa" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Сума і коментар

Потрібно указати суму переказу, а також написати коментар(не обов'язковий пункт)

<div align="left"><figure><img src="https://885903010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlmnCYfRPChlzs40DJIDl%2Fuploads%2FVJLzyxFHgjNzjmUeEwWh%2Fimage.png?alt=media&amp;token=d331dc53-394e-4d79-83e4-30e856596d6e" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

## Створення юридичного рахунку

Для створення юридичного рахунку потрібно звернутись до президента, після чого він має написати спеціальну команду

{% stepper %}
{% step %}

### Написання команди

<div align="left"><figure><img src="https://885903010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlmnCYfRPChlzs40DJIDl%2Fuploads%2FwrFqXM7y4i176aqsnGhB%2Fimage.png?alt=media&amp;token=f06cdb22-c4f6-45fd-8e15-11a873cab3b7" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Вибір назви

В вікні яке відкриється потрібно указати назву юридичного рахунку

<div align="left"><figure><img src="https://885903010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlmnCYfRPChlzs40DJIDl%2Fuploads%2FanICCBqzVanYiSHsuwIf%2Fimage.png?alt=media&amp;token=e897f6e3-d6ba-49c7-9639-05efe7b520c2" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

## Налаштування

Після написання відповідної команди, з'являється повідомлення з трьома кнопками

<div align="left"><figure><img src="https://885903010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlmnCYfRPChlzs40DJIDl%2Fuploads%2FIXBTevgpYIycc9u7TXiG%2Fimage.png?alt=media&amp;token=9b0ef9c3-5fa7-4da1-b2d4-46a6661f9e10" alt=""><figcaption></figcaption></figure></div>

### Видалення картки

Після натискання кнопки, з'являється меню вибору, де потрібно обрати картку яку ви хочете видалити

{% hint style="danger" %}
Не забудьте зняти з картки яку хочете видалити всі ДР, бо після видалення це вже буде зробити неможливо
{% endhint %}

<div align="left"><figure><img src="https://885903010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlmnCYfRPChlzs40DJIDl%2Fuploads%2FQvEVhPy6tomfcQWaYHc8%2Fimage.png?alt=media&amp;token=5014564b-c3b5-4fb7-86b7-35c8b784a00d" alt=""><figcaption></figcaption></figure> <figure><img src="https://885903010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlmnCYfRPChlzs40DJIDl%2Fuploads%2Ffmza1UDDBUoZ7BFnkh2n%2Fimg-2025-08-02-15-28-48.png?alt=media&amp;token=55898768-7476-47b1-9fd4-9118371a8eb9" alt=""><figcaption></figcaption></figure></div>

### API сповіщення

Після натискання кнопки, з'являється меню вибору, де потрібно обрати ваш юридичний рахунок, до якого ви хочете підключити API сповіщення

<div align="left"><figure><img src="https://885903010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlmnCYfRPChlzs40DJIDl%2Fuploads%2FjbnHrrfWDAbr1T6kTaNQ%2Fimage.png?alt=media&amp;token=83fab6e2-5ed6-4605-9abb-f5cac5e9d63d" alt=""><figcaption></figcaption></figure></div>

Після вибору рахунку, з'явиться вікно, в якому потрібно вказати посилання на вебхук, на який будуть приходити API сповіщення (вони є повідомленнями у JSON форматі)

<div align="left"><figure><img src="https://885903010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlmnCYfRPChlzs40DJIDl%2Fuploads%2FVk7dW34QR5l8UxqosycP%2Fimage.png?alt=media&amp;token=d16fbd80-7924-4404-8d5a-696e010615f6" alt=""><figcaption></figcaption></figure></div>

Після вписання посилання на вебхук, потрібно натиснути кнопку "Надіслати", і тоді ваш вебхук буде приєднано до рахунку

{% hint style="info" %}
Для видалення вебхуку, потрібно натиснути "Видалити API сповіщення"
{% endhint %}

Після успішного приєднання вебхуку, при переказах буде надсилатись повідомлення у JSON форматі

{% code title="Контент повідомлення (він відправляється у вигляді блока коду)" %}

```json
{
  "type": "transfer_received",
  "from_account_number": "00000",
  "from_user_id": 000000000000000000,
  "to_account_number": "00000",
  "to_user_id": 000000000000000000,
  "amount": 2,
  "comment": "Parcel delivery"
}
```

{% endcode %}

### Приклад використання API сповіщень

Такі сповіщення про перекази були створені для того, щоб користувачі могли робити автоматизації платежів, проте в цьому прикладі буде показано код бота, який пише подяку за переказ

{% code title="приклад бота" %}

````python
import disnake
from disnake.ext import commands
import json
import config

# ID каналу, в якому бот буде реагувати на повідомлення
CHANNEL_ID = 0000000000000000000 # Замініть на реальний ID каналу

intents = disnake.Intents.default()
intents.messages = True
intents.message_content = True

bot = commands.Bot(command_prefix="!", intents=intents)

@bot.event
async def on_ready():
    print(f"✅ Logged in as {bot.user}")

@bot.event
async def on_message(message: disnake.Message):
    # Дозволяємо лише канал і повідомлення з вебхука
    if message.channel.id != CHANNEL_ID:
        return
    if message.webhook_id is None and message.author.bot:
        return

    # Перевіряємо чи є блок коду з json
    if message.content.startswith("```json") and message.content.endswith("```"):
        try:
            # Видаляємо перший та останній рядки
            lines = message.content.strip().splitlines()
            # ['```json', '{', '  "type": "...', '}', '```']
            json_lines = lines[1:-1]
            json_str = "\n".join(json_lines)

            data = json.loads(json_str)

            if data.get("type") == "transfer_received":
                user_id = data.get("to_user_id")
                amount = data.get("amount")
                comment = data.get("comment", "")

                mention = f"<@{user_id}>"
                response = (
                    f"💸 Дякуємо {mention} за переказ у розмірі {amount} ДР!\n"
                    f"💬 Коментар: {comment}"
                )

                await message.channel.send(response)

        except Exception as e:
            await message.channel.send(f"❌ Не вдалося обробити JSON: {e}")

bot.run("YOUR_BOT_TOKEN")
````

{% endcode %}

Зверніть увагу, що повіломлення від вебхуку в сам діскорд надсилається в такому вигляді:

````
```json
{
  "type": "transfer_received",
  "from_account_number": "00000",
  "from_user_id": 000000000000000000,
  "to_account_number": "00000",
  "to_user_id": 000000000000000000,
  "amount": 5,
  "comment": "comment"
}
```
````

Результат роботи бота:

<div align="left"><figure><img src="https://885903010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlmnCYfRPChlzs40DJIDl%2Fuploads%2FcvjzI8ke1qPL8boDCK44%2Fimage.png?alt=media&amp;token=406185c7-c6f6-4c48-bde1-4f0b644de0ca" alt=""><figcaption></figcaption></figure></div>
