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

{% 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  | Описание транзакции                                               |