Сообщение будет приходить на ранее указанный адрес обратного вызова (поле "cbUrl" при отправке заявки в шаге 4).
Имя поля | Кратность | Тип | Описание | |
---|---|---|---|---|
applicationId | 1 | String | Идентификатор заявки. toProducts[].applicationId из POST /api/v1/deal/send_applications (Шаг 4. Отправка заявки в сервисы с указанием продуктов) | |
displayStatus | 1 | String | Статус заявки, для отображения пользователю, указанный в настройках статусной модели владельцем поставщика продуктов(банком). | |
applicationStatus | 1 | String | Настройка статусной модели определена в Статусы подключаемого сервиса: dealApplicationStatuses. Набор возможных статусов, отражающий жизненный цикл заявки, и получаемых внешней системой формирования заявок определен ниже. | |
message | 0-1 | String | ||
userActions[] | 0-N | Object[] | Настройка возможный действий при различных статусах на стороне банка определен в Пользовательские действия: userActions. | |
userActions[].actionType | 1 | Enum( CLIENT_EXTERNAL_SIGN AGENT_GET_EXTERNAL_SIGN_URL CLIENT_INTERNAL_SIGN AGENT_GET_INTERNAL_SIGN_URL CLIENT_SIGN_OFFER CORRECT_REQUEST GO_TO_SERVICE ) | Тип действия | |
userActions[].label | 1 | String | Название действия | |
userActions[].description | 1 | String | Описание действия | |
userActions[]{CLIENT_EXTERNAL_SIGN}.signUrl | 1 | URL | URL на страницу с подписанием заявки | |
userActions[]{AGENT_GET_EXTERNAL_SIGN_URL}.signUrl | 1 | URL | URL на страницу с подписанием заявки | |
userActions[]{CORRECT_REQUEST}.url | 1 | URL | URL на страницу с возможностью редактирования заявки | |
userActions[]{CLIENT_INTERNAL_SIGN}.documentsToSignUrl | 1 | URL | URL получения списка документов на подписание | |
userActions[]{AGENT_GET_INTERNAL_SIGN_URL}.documentsToSignUrl | 1 | URL | URL получения списка документов на подписание | |
userActions[]{GO_TO_SERVICE}.url | 1 | URL | URL на страницу с дальнейшими дополнительными действиями пользователя. |
Для повышения уровня безопасности коммуникации, и минимизации согласования авторизационных данных, данное сообщение планируется передавать в виде подписанного JWT, чтобы принимающая сторона смогла проверять достоверность полученных данных без необходимости какой-либо дополнительной аутентификации при обратном вызове. |
|
На текущий момент в прототипе не реализован проброс API для подписания документов, чтобы заявка могла считаться подписанной. Необходимые данные для получения и подписания документов предполагается указывать в виде соответствующих URI внутри каждого элемента userActions. Так же возможна реализация ресурса, для получения текущего состояния заявки, чтобы внешняя система могла в любой момент получить актуальное состояние заявки, и возможные действия по ней. |
Не все требования к полям сервисы декларируют в своих продуктах, некоторые проверки они выполняют у себя самостоятельно, поэтому возможны статусы отклонения заявки.
Пример отклонения заявки
|
Значение | Описание |
---|---|
SENT_TO_SERVICE | Отправлена в сервис |
CLOSED_BY_SYSTEM | Закрыта системой. Терминальный статус |
REJECTED_BY_SERVICE | Отклонена сервисом (банком). Терминальный статус |
PRODUCT_ISSUED | Выпущен продукт. Терминальный статус |