# Работа со счетом

{% hint style="danger" %}
**Внимание!**

Данное API вы используете на свой страх и риск, мы не несем ответственности за сохранность данных созданных вами счетов через представленное API, но приложим все усилия для их сохранности и безопасности. Вы не должны использовать методы API представленные на этой странице, если их использование нарушает законодательство Российской Федерации, Европейского союза и США.
{% endhint %}

## Получить список счетов

<mark style="color:blue;">`GET`</mark> `https://watbot.ru/api/v1/getContactAccounts`

Этот метод позволяет получить список счетов указанного контакта.

(Отправка в запросе данных контакта должна быть ОТКЛЮЧЕНА)

**Query Parameters**

| Name        | Type    | Description  |
| ----------- | ------- | ------------ |
| contact\_id | integer | ID контакта. |

{% tabs %}
{% tab title="200 Запрос успешно обработан. Результат в виде дерева, включая текущий контакт." %}

```
{
  "data": [
    {
      "id": 1,
      "currency": "USD",
      "amount": 17500,
      "amount_note": "175 USD",
      "created_at": "2019-11-29T13:33:35+00:00",
      "updated_at": "2019-11-30T07:08:57+00:00"
    }
  ]
}
```

{% endtab %}
{% endtabs %}

## Создать счет

<mark style="color:green;">`POST`</mark> `https://watbot.ru/api/v1/addContactAccount`

Этот метод позволяет создать счет для указанного контакта.

(Отправка в запросе данных контакта должна быть ОТКЛЮЧЕНА)

**Query Parameters**

| Name          | Type    | Description                                    |
| ------------- | ------- | ---------------------------------------------- |
| contact\_id\* | integer | <p>ID контакта.<br></p>                        |
| currency\*    | string  | Трехзначный код валюты в ISO 4217. Пример: USD |

{% tabs %}
{% tab title="201 Счет успешно создан" %}

```
{
  "data": {
    "id": 6,
    "currency": "USD",
    "amount": 0,
    "amount_note": "0 USD",
    "created_at": "2019-11-30T14:56:24+00:00",
    "updated_at": "2019-11-30T14:56:24+00:00"
  }
}
```

{% endtab %}

{% tab title="422 Аккаунт уже существует" %}

```
{
  "errors": {
    "currency": [
      "Account with the currency already exists"
    ]
  }
}
```

{% endtab %}

{% tab title="422 Неподдерживаемый формат" %}

```
{
  "message": "The given data was invalid.",
  "errors": {
    "currency": [
      "The currency format is invalid.",
      "The selected currency is invalid."
    ]
  }
}
```

{% endtab %}
{% endtabs %}

## Удалить счет

<mark style="color:green;">`POST`</mark> `https://watbot.ru/api/v1/deleteContactAccount`

Этот метод позволяет удалить счет контакта.

(Отправка в запросе данных контакта должна быть ОТКЛЮЧЕНА)

**Request Body**

| Name        | Type    | Description |
| ----------- | ------- | ----------- |
| contact\_id | integer | ID счета.   |

{% tabs %}
{% tab title="204 Счет успешно удален" %}

{% endtab %}

{% tab title="422 Счет не может быть удален, так как имеет положительный баланс ." %}

```
{
  "errors": {
    "account_id": [
      "You can not delete the account with a balance of 175 RUB"
    ]
  }
}
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
Счет может быть удален только если имеет нулевой баланс.
{% endhint %}

## Зачислить сумму на счет

<mark style="color:green;">`POST`</mark> `https://watbot.ru/api/v1/addFundsToContactAccount`

Этот метод позволяет зачислить средства на счет контакта.&#x20;

(Отправка в запросе данных контакта должна быть ОТКЛЮЧЕНА)

**Request Body**

| Name          | Type    | Description                                                       |
| ------------- | ------- | ----------------------------------------------------------------- |
| account\_id\* | integer | ID счета                                                          |
| amount\*      | integer | Сумма в минимальной денежной единице. Например для $10 - это 1000 |
| description\* | string  | Описание транзакции                                               |

{% tabs %}
{% tab title="200 Счет успешно пополнен" %}

```
{
  "data": {
    "id": 1,
    "currency": "USD",
    "amount": 117500,
    "amount_note": "1175 USD",
    "created_at": "2019-11-29T13:33:35+00:00",
    "updated_at": "2019-11-30T07:08:57+00:00"
  }
}
```

{% endtab %}
{% endtabs %}

## Списать сумму со счета

<mark style="color:green;">`POST`</mark> `https://watbot.ru/api/v1/withdrawFundsFromContactAccount`

Этот метод позволяет списать средства со счета контакта.&#x20;

(Отправка в запросе данных контакта должна быть ОТКЛЮЧЕНА)

**Request Body**

| Name          | Type    | Description                                                       |
| ------------- | ------- | ----------------------------------------------------------------- |
| account\_id\* | integer | ID счета                                                          |
| amount\*      | integer | Сумма в минимальной денежной единице. Например для $10 - это 1000 |
| description\* | String  | Описание транзакции                                               |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.watbot.ru/rabota-s-api/kontakty/bills.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.