Установить выкупные суммы по страховым контрактам

/invest/axiom/providers-api/v1/contracts/surrender/create/

POST

https://secured-openapi.tbank.ru/invest/axiom/providers-api/v1/contracts/surrender/create/

Установить выкупные суммы по страховым контрактам в системе Provider-API.

Авторизация

Security

Bearer API Token

MTLS-сертификат

RPS

Ограничение — 20 запросов в секунду

Scopes

Метод для взаимодействия с партнерами → Передача данных по партнерам

Запрос

Header parameters

X-Request-Id

String<uuid>

Уникальный идентификатор для трассировки запроса. Не влияет на логику исполнения запроса.

Request body schema application/json

Required

contractId

String (Contractid)

Requirements: non-empty and <= 128 characters

Уникальный идентификатор контракта в ИС партнера.

Required

productType

String

Requirements: [investment, universal]

Тип продукта.

Required

surrender

Array of objects () (Surrender)

Requirements: >= 1 items, <= 1000 items

Выкупная сумма.

Required

calcPeriodFrom

String (Calcperiodfrom)<date>

Период с.

Required

calcPeriodTo

String (Calcperiodto)<date>

Период по.

Required

currency

String

Requirements: [RUB, USD, EUR, CNY, HKD, GBP, CHF, CAD, DKK]

Валюта.

Required

surrenderPercent

Number (Surrenderpercent)

Процент выкупной суммы.

Required

surrenderValue

Number (Surrendervalue)

Значение выкупной суммы.

Required

updateDate

String (Updatedate)<date-time>

Дата обновления данных на стороне партнера.

Ответ

201

OK

400

Некорректный запрос

401

Ошибка аутентификации

403

Ошибка авторизации

422

Ошибка при обработке данных

429

Слишком много запросов

500

Ошибка сервера

Это полезный материал?

Обратиться в поддержку

Пример запроса

Payload

cURL

Go

Java

NodeJs

PHP

Python

Content type

application/json

{

"contractId":

"string",

"productType":

"investment",

"surrender": [

{ ... }

"calcPeriodFrom":

"2025-11-04",

"calcPeriodTo":

"2025-11-04",

"currency":

"RUB",

"surrenderPercent":

0,

"surrenderValue":

0

}

],

"updateDate":

"2025-11-04T09:12:09.348Z"

}

Пример ответа

201

400

401

403

422

429

500

Content type

application/json

{

"createdAt":

"1996-12-20T13:30:35Z",

"updatedAt":

"2024-08-19T16:48:01Z",

"updateDate":

"2012-11-06T22:36:31Z",

"providerName":

"st",

"productType":

"investment",

"contractId":

"str",

"surrender": [ ... ]

{ ... },

"contractId":

"string",

"id":

9698,

"createdAt":

"2015-03-27T23:29:36Z",

"updatedAt":

"1999-03-26T11:29:28Z",

"providerName":

"string",

"currency":

"GBP",

"calcPeriodFrom":

"2024-05-30",

"calcPeriodTo":

"2022-02-20",

"surrenderPercent":

6086,

"surrenderValue":

6852

},

{ ... },

"contractId":

"string",

"id":

1242,

"createdAt":

"2024-03-30T04:32:15Z",

"updatedAt":

"2009-02-03T10:03:34Z",

"providerName":

"string",

"currency":

"CNY",

"calcPeriodFrom":

"2024-08-24",

"calcPeriodTo":

"2020-12-21",

"surrenderPercent":

609,

"surrenderValue":

5279

},

{ ... },

"contractId":

"stri",

"id":

8240,

"createdAt":

"2007-12-17T03:19:24Z",

"updatedAt":

"2010-04-20T03:31:03Z",

"providerName":

"strin",

"currency":

"CNY",

"calcPeriodFrom":

"2020-11-20",

"calcPeriodTo":

"2020-02-01",

"surrenderPercent":

5320,

"surrenderValue":

7239

},

{ ... },

"contractId":

"st",

"id":

6400,

"createdAt":

"1997-07-06T01:16:03Z",

"updatedAt":

"2013-07-27T13:49:51Z",

"providerName":

"string",

"currency":

"EUR",

"calcPeriodFrom":

"2020-11-23",

"calcPeriodTo":

"2024-04-07",

"surrenderPercent":

3758,

"surrenderValue":

6037

},

{ ... },

"contractId":

"string",

"id":

1107,

"createdAt":

"2009-09-20T21:41:46Z",

"updatedAt":

"2001-09-10T12:49:29Z",

"providerName":

"string",

"currency":

"GBP",

"calcPeriodFrom":

"2021-05-09",

"calcPeriodTo":

"2020-12-26",

"surrenderPercent":

7710,

"surrenderValue":

5554

},

{ ... },

"contractId":

"string",

"id":

830,

"createdAt":

"2014-04-16T19:37:49Z",

"updatedAt":

"2020-09-20T00:51:03Z",

"providerName":

"string",

"currency":

"GBP",

"calcPeriodFrom":

"2025-01-12",

"calcPeriodTo":

"2023-09-12",

"surrenderPercent":

7824,

"surrenderValue":

541

},

{ ... },

"contractId":

"string",

"id":

3339,

"createdAt":

"2014-05-17T06:37:16Z",

"updatedAt":

"2007-02-06T08:45:52Z",

"providerName":

"string",

"currency":

"RUB",

"calcPeriodFrom":

"2024-09-11",

"calcPeriodTo":

"2022-02-09",

"surrenderPercent":

8101,

"surrenderValue":

8336

},

{ ... },

"contractId":

"string",

"id":

8555,

"createdAt":

"2012-02-10T08:55:17Z",

"updatedAt":

"2015-02-03T14:00:13Z",

"providerName":

"string",

"currency":

"USD",

"calcPeriodFrom":

"2021-01-02",

"calcPeriodTo":

"2024-11-18",

"surrenderPercent":

9549,

"surrenderValue":

1336

},

{ ... },

"contractId":

"st",

"id":

5971,

"createdAt":

"2006-05-25T04:33:42Z",

"updatedAt":

"1996-07-29T11:57:42Z",

"providerName":

"stri",

"currency":

"CAD",

"calcPeriodFrom":

"2023-04-08",

"calcPeriodTo":

"2022-12-06",

"surrenderPercent":

5513,

"surrenderValue":

8975

},

{ ... }

"contractId":

"st",

"id":

5282,

"createdAt":

"2007-12-02T06:04:20Z",

"updatedAt":

"2004-04-01T09:29:28Z",

"providerName":

"string",

"currency":

"CAD",

"calcPeriodFrom":

"2020-03-13",

"calcPeriodTo":

"2022-08-26",

"surrenderPercent":

8927,

"surrenderValue":

5028

}

]

}