---
# System prepended metadata

title: Отправить запрос на регистрацию виртуальной карты с УПРИД ЕСИА
tags: [arithmetic-integration]

---

---
tags: arithmetic-integration
title: Отправить запрос на регистрацию виртуальной карты с УПРИД ЕСИА
---
# Отправить запрос на регистрацию виртуальной карты с упрощенной идентификацией (УПРИД) через ЕСИА

Запрос на упрощенную идентификацию через сервис ЕСИА с последующим оформлением виртуальной карты "Арифметика". При успешном выполнении возвращает URL на стороне ЦФТ для проведения аутентификации и идентификатор операции, который может быть использован для получения результата.

## 1. Запрос выполнения операции

### Request --->

#### URL:
Стандартный, [см. шаблон обращения](/NIkubqRkR5STebBQd8690g?book#URL)

#### Headers:
* **apikey**: ==[apikey](/NIkubqRkR5STebBQd8690g?both#URL)==
* **Content-type**: application/json; charset=utf-8
* **Mq-Jrb-Exchange**: PersonalAccountTopic
* **Mq-Jrb-Routing-key**: regVirtualCard.==phone==
* **Mq-Jrb-Operation**: StartIdentificationESIA
* **Mq-Jrb-Object**: ==phone==

:::info
:::spoiler Описание полей
==phone==: номер телефона клиента, 10 цифр, без "+7" или "8"
:::

#### Body:
```json
{
    "personal_account": "XXXXXXXXX"
    "city_id": "xxxxx-xxxxxx-xxx-xxxxxxxx"
    "phone": "9999999999"
    "birthdate": "yyyy-MM-dd",
    "passport_series": "1234"
    "passport_number": "123456"
    "card_product": "virtual_arifmetika"
    "contract_num": "999999999"
    "referrerUrl": "https://..."
}
```

:::info
:::spoiler Описание полей
- **personal_account**: принадлежность личного кабинета(lk_arifmetika, lk_give_money),
- **city_id**: идентификатор населённого пункта, строка формата UUID; рекомендуемый возвращается операцией [Проверка существования клиента](/KyJWe1vgR3u726e-rZc7PQ), список всех населённых пунктов можно получить через операцию [Получение списка регионов](/Rssiwh6CSr6QXB4JekBuuA))
- **phone**: номер телефона клиента, 10 цифр, без "+7" или "8";
- **birthdate**: дата рождения в формате ```yyyy-MM-dd```;
- **passport_series**: серия паспорта;
- **passport_number**: номер паспорта;
- **card_product**: идентификатор карточного продукта, на текущий момент может принимать значение только "virtual_arifmetika";
- **contract_num**: ==Не обязательно== номер договора;
- **referrerUrl**: ==Не обязательно== URL, куда будет перенаправлен клиент после аутентификации в ЕСИА, в случае отсутствия будет перенаправлен на дефолтный URL, сохраненный на стороне ЦФТ;
:::

:::success
:::spoiler Пример
```json
{
	"personal_account": "lk_arifmetika"
	"city_id": "3940ec80-8804-11e5-80e5-9cb654991fb4"
	"phone": "9131234567"
	"birthdate": "1985-12-01"
	"passport_series": "1234"
	"passport_number": "123456"
	"card_product": "virtual_arifmetika"
}
```
:::


---
### Response <---

Стандартный, [см. шаблон обращения](/NIkubqRkR5STebBQd8690g?view#Response-lt—)

---

## 2. Получение результата

### Request --->
Стандартный, [см. шаблон обращения](/NIkubqRkR5STebBQd8690g?view#URL1)

### Response <---

#### Headers:

* **Content-type**: application/json; charset=utf-8
* **Mq-Jrb-Id**: ==[id](/NIkubqRkR5STebBQd8690g?view#Headers3)==
* **Mq-Jrb-Id-Result**: ==[id-result](/NIkubqRkR5STebBQd8690g?view#Headers3)==

#### Body:
```json
{
    "success": true/false,
    "operationId": "5a7d3e66-bbae-4134-8726-7ec7a6906060",
    "url": "https://domain.cft.ru/user/esia/login?dataUUID=XXX",
    "messageText": "..."
}
```
:::info
:::spoiler Описание полей
==operationId==: идентификатор операции на стороне сервиса ЦФТ (может быть использован для получения результата)
==url==: URL на стороне ЦФТ для проведения аутентификации в ЕСИА, должен быть возвращен в браузер клиента в виде:
```
HTTP/1.1 303 See Other
Content-Type: text/html
Location: https://domain.cft.ru/user/esia/login?dataUUID=XXX
```
:::

:::success
:::spoiler Пример тела ответа, если запрос успешно отправлен
```json
{
    "success": true,
    "operationId": "xxxxx-xxxxxx-xxx-xxxxxxxx",
    "url": "https://domain.cft.ru/user/esia/login?dataUUID=XXX",
    "messageText": ""
}
```
:::


:::danger
:::spoiler Примеры [ошибочных результатов](/NIkubqRkR5STebBQd8690g#Формат-ошибочных-результатов)
##### 1. <описание>
```json
{ 
    "description": "...",
    "error": "..."
}
```
:::

---