# Что нового?

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

## 1. Отказались от передачи значений в GET параметрах <a href="#id-1.1.-otkazalis-ot-peredachi-znachenii-v-get-parametrakh" id="id-1.1.-otkazalis-ot-peredachi-znachenii-v-get-parametrakh"></a>

Ранее все параметры по созданию заявки указывались в GET параметрах, что не очень удобно и не всегда безопасно, особенно когда говорим про передачу token. В новой версии API в GET параметрах передаются только естественные для этого вещи - параметры фильтрации для списков, а токен апи перекочевал в заголовок Authorization.

Для примера, ранее запрос на создание заявки на ввод по методу wallet на сумму 100 рублей выглядел следующим образом:

```
curl --request GET \
  --url 'https://admin.vanilapay.com/api/v1/deposit?token=****&amount=100&method=wallet&order_id=test1'
```

Теперь этот же запрос будет выглядеть следующим образом:

```
curl --request POST \
  --url https://admin.vanilapay.com/api/v2/deposit \
  --header 'Authorization: Bearer ****' \
  --header 'Content-Type: application/json' \
  --data '{
  "order_id": "test1",
  "method": "wallet",
  "amount": "100.00"
}'
```

## 2. Переименовали часть параметров <a href="#id-1.2.-pereimenovali-chast-parametrov" id="id-1.2.-pereimenovali-chast-parametrov"></a>

Изначально все расширенные данные по операции передавались в массиве extended\_data, который именно так и назывался. В итоге для того чтобы передать юзер агент, приходилось сооружать такой вот параметр extended\_data\[user\_agent].

На текущий момент вместо массива используется просто приставка ext\_, т.е. для передачи user\_agent нужно использовать параметр ext\_user\_agent.&#x20;

Детально по названиям параметров [тут](/firekassa-api-v2/transactions/deposit/create.md) и [тут](/firekassa-api-v2/transactions/withdrawal.md)&#x20;

На выводе использовался параметр number, теперь вместо него параметр account, что больше соответствует логике.

## 3. Добавили подпись запросов

Детальнее в разделе безопасности

## 4. Добавили счета

Детальнее в разделе о счетах

## 5. Добавили возможность указать индивидуальный урл для уведомления по транзакции

Ранее уведомления по всем транзакциям шли через урл для уведомлений, указанный в карточке сайта. В некоторых случаях это оказалось не очень удобно, поскольку некоторые интеграции были реализованы так, что не могли принимать уведомления на одну и ту же ссылку.

Поэтому была реализована возможность указать ссылку для уведомления по каждой транзакции индивидуально, посредством параметра notification\_url. Это опциональный параметр, потому если вам это не требуется, то можете и не указывать его. Но если вам по какой-то причине это нужно, то делается это следующим образом:

```
curl --request POST \
  --url https://admin.vanilapay.com/api/v2/deposit \
  --header 'Authorization: Bearer ****' \
  --header 'Signature: 1234567890' \
  --header 'Content-Type: application/json' \
  --data '{
  "order_id": "test1",
  "method": "wallet",
  "amount": "100.00",
  "site_account": "tinkoff",
  "notification_url": "https://ваш-домен.ком/ваша/ссылка"
}'
```

## 6. Добавлен белый список айпи для API запросов

Детальнее в разделе о безопасности.

Ранее такой список айпи использовался только для заявок на вывод, но теперь есть аналогичный список для API v2, который распространяется абсолютно на все запросы API v2.

Отредактировать белый список айпи можно в карточке сайта

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

## 7. Добавили возможность отменить заявку на ввод и вывод

Детальнее в соответствующих разделах

## 8. Добавили возможность отметить заявку на ввод как оплаченную

Детальнее в соответствующем разделе

## 9. Добавили возможность указать язык для коммуникации

Если по какой-то причине вас не устраивает русский язык в ответах ( например вы неправильно работаете с юникодом в ответах от апи ), то можете использовать английский язык. Для этого в запросе надо указать заголовок Accept-Language со значением en\_US. Пример того как это будет выглядеть:

```
curl --request POST \
  --url https://admin.vanilapay.com/api/v2/deposit \
  --header 'Authorization: Bearer ****' \
  --header 'Accept-Language: en_US' 
...  
```


---

# 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://fkassa.gitbook.io/firekassa-api-v2/overview/release-notes.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.