Создание заявки на кредит

Обновлено 13 марта 2025

POST

/v1/credit-requests

Запрос создание заявки на оформление кредитного договора.

Должен содержать токен доступа (access_token) пользователя в параметре Authorization заголовка.

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

Запрос

Header Parameters

Authorization
string
required
Access token организации-клиента, полученный через SSO
Example: f8ad3141-b7e8-4924-92de-3de4fd0a464e-1

• application/json

Body

required

Заявка на кредит

account

string

required

Возможные значения: Value must match regular expression ^[0-9]{20}$

Расчетный счет для зачисления денежных средств за заказ

amount

number

required

Возможные значения: >= 0.01

Сумма заказа

consent

object

Информация по согласиям от партнера

consent

string

required

Возможные значения: <= 5 characters

Получено согласие ("Yes"/"No")

consentHash

string

required

Возможные значения: <= 256 characters

SHA-256 хеш поля consentText

consentText

string

required

Текст согласия

firstname

string

required

Возможные значения: <= 36 characters

Имя представителя

lastname

string

required

Возможные значения: <= 36 characters

Фамилия представителя

middlename

string

required

Возможные значения: <= 36 characters

Отчество представителя

position

string

required

Возможные значения: <= 36 characters

Должность представителя

startDate

date

required

Дата подписания согласия

creditAmount

number

Возможные значения: >= 0.01

Запрошенная сумма кредита

creditProductCode

string

Код продукта для кредитного предложения, в рамках которого для клиента оформляется заявка

creditTerm

int32

Возможные значения: >= 1

Срок кредита (в месяцах)

deliveryAmount

number

Возможные значения: >= 0.01

Сумма доставки

externalId

uuid

required

Идентификатор запроса, присвоенный партнером

limitAmountMarketplace

number

Возможные значения: >= 0.01

Сумма кредита от маркетплейса

marketplaceData

object

Данные от партнера об оборотах клиента

commissions

object[]

Possible values: <= 6

Информация по комиссиям

Array [

logistic

number

required

Возможные значения: >= 0.01

Комиссия за доставку и логистику

period

string

required

Возможные значения: <= 36 characters

Месяц реализации (мм.гггг)

stock

number

required

Возможные значения: >= 0.01

Начисления за услуги склада (хранение и операции сборки-разборки, приемки и тд)

transaction

number

required

Возможные значения: >= 0.01

Транзакционная комиссия

]

sellings

object[]

Possible values: <= 6

Информация по реализации товара

Array [

amount

number

required

Возможные значения: >= 0.01

Количество реализованного товара за период (реально выкупленный)

fov

number

required

Возможные значения: >= 0.01

FOV (Выкупаемость)

gmv

number

required

Возможные значения: >= 0.01

Совокупная стоимость товаров, проданных на торговой площадке за определенный период времени без учета возвратов, обмена и скидок

period

string

required

Возможные значения: <= 36 characters

Месяц реализации (мм.гггг)

productDescription

string

required

Возможные значения: <= 800 characters

Описание продукта

revenue

number

required

Возможные значения: >= 0.01

Выручка в руб.за период

]

stock

object

Информация по товарным остаткам

amount

number

required

Возможные значения: >= 0.01

Количество остатка

assortiment

integer

required

Возможные значения: <= 32 characters, >= 1

Количество уникальных товаров (ассортимент)

averagePrice

number

required

Возможные значения: >= 0.01

Средняя цена товара

date

date

required

Дата, на момент которой имеется остаток

duration

int32

required

Сколько дней в среднем товар лежит на складе (передается целое число, округленное математически)

productDescription

string

required

Возможные значения: <= 800 characters

Описание продукта

registrationDate

date

required

Дата регистрации партнера на площадке

warehousingModel

string

required

Возможные значения: <= 64 characters

Модель работы с площадкой

negativeOrderUrl

string

Возможные значения: <= 1000 characters

Ссылка на заказ при отказе в выдаче кредита

orderId

string

required

Возможные значения: <= 50 characters

Идентификатор заказа клиента (номер)

orderInfo

object[]

Информация о составе заказа

Array [

numOfPosition

int64

Возможные значения: >= 1

Количество позиций/товаров

position

string

Возможные значения: <= 100 characters

Позиция/Наименование товара

price

number

Возможные значения: >= 0.01

Стоимость позиции

totalPrice

number

Возможные значения: >= 0.01

Итоговая стоимость

]

orderUrl

string

required

Возможные значения: <= 1000 characters

Ссылка на заказ

payeeInfo

object

Реквизиты получателя

payeeBankBic

string

Возможные значения: Value must match regular expression ^[0-9]{9}$

БИК получателя

payeeCorrAcc

string

Возможные значения: Value must match regular expression ^[0-9]{20}$

Кор счет получателя

payeeInn

string

Возможные значения: Value must match regular expression ^([0-9]{5}|[0-9]{10}|[0-9]{12}|0)$

ИНН получателя

payeeKpp

string

Возможные значения: Value must match regular expression ^([0-9]{9}|0)$

КПП получателя

payeeName

string

Возможные значения: <= 350 characters

Наименование получателя

purpose

string

required

Возможные значения: <= 210 characters

Назначение платежа

vatAmount

number

Возможные значения: >= 0.01

Сумма НДС

Ответы

• 201
• 202
• 400
• 401
• 403
• 415
• 500
• 503

Создан

• application/json

• Схема
• Пример из схемы

Schema

account

string

required

Возможные значения: Value must match regular expression ^[0-9]{20}$

Расчетный счет для зачисления денежных средств за заказ

amount

number

required

Возможные значения: >= 0.01

Сумма заказа

bankComment

string

Банковский комментарий к статусу документа

bankStatus

string

Статус документа

consent

object

Информация по согласиям от партнера

consent

string

required

Возможные значения: <= 5 characters

Получено согласие ("Yes"/"No")

consentHash

string

required

Возможные значения: <= 256 characters

SHA-256 хеш поля consentText

consentText

string

required

Текст согласия

firstname

string

required

Возможные значения: <= 36 characters

Имя представителя

lastname

string

required

Возможные значения: <= 36 characters

Фамилия представителя

middlename

string

required

Возможные значения: <= 36 characters

Отчество представителя

position

string

required

Возможные значения: <= 36 characters

Должность представителя

startDate

date

required

Дата подписания согласия

creditAmount

number

Возможные значения: >= 0.01

Запрошенная сумма кредита

creditProductCode

string

Код продукта для кредитного предложения, в рамках которого для клиента оформляется заявка

creditTerm

int32

Возможные значения: >= 1

Срок кредита (в месяцах)

deliveryAmount

number

Возможные значения: >= 0.01

Сумма доставки

externalId

uuid

required

Идентификатор запроса, присвоенный партнером

limitAmountMarketplace

number

Возможные значения: >= 0.01

Сумма кредита от маркетплейса

marketplaceData

object

Данные от партнера об оборотах клиента

commissions

object[]

Possible values: <= 6

Информация по комиссиям

Array [

logistic

number

required

Возможные значения: >= 0.01

Комиссия за доставку и логистику

period

string

required

Возможные значения: <= 36 characters

Месяц реализации (мм.гггг)

stock

number

required

Возможные значения: >= 0.01

Начисления за услуги склада (хранение и операции сборки-разборки, приемки и тд)

transaction

number

required

Возможные значения: >= 0.01

Транзакционная комиссия

]

sellings

object[]

Possible values: <= 6

Информация по реализации товара

Array [

amount

number

required

Возможные значения: >= 0.01

Количество реализованного товара за период (реально выкупленный)

fov

number

required

Возможные значения: >= 0.01

FOV (Выкупаемость)

gmv

number

required

Возможные значения: >= 0.01

Совокупная стоимость товаров, проданных на торговой площадке за определенный период времени без учета возвратов, обмена и скидок

period

string

required

Возможные значения: <= 36 characters

Месяц реализации (мм.гггг)

productDescription

string

required

Возможные значения: <= 800 characters

Описание продукта

revenue

number

required

Возможные значения: >= 0.01

Выручка в руб.за период

]

stock

object

Информация по товарным остаткам

amount

number

required

Возможные значения: >= 0.01

Количество остатка

assortiment

integer

required

Возможные значения: <= 32 characters, >= 1

Количество уникальных товаров (ассортимент)

averagePrice

number

required

Возможные значения: >= 0.01

Средняя цена товара

date

date

required

Дата, на момент которой имеется остаток

duration

int32

required

Сколько дней в среднем товар лежит на складе (передается целое число, округленное математически)

productDescription

string

required

Возможные значения: <= 800 characters

Описание продукта

registrationDate

date

required

Дата регистрации партнера на площадке

warehousingModel

string

required

Возможные значения: <= 64 characters

Модель работы с площадкой

negativeOrderUrl

string

Возможные значения: <= 1000 characters

Ссылка на заказ при отказе в выдаче кредита

orderId

string

required

Возможные значения: <= 50 characters

Идентификатор заказа клиента (номер)

orderInfo

object[]

Информация о составе заказа

Array [

numOfPosition

int64

Возможные значения: >= 1

Количество позиций/товаров

position

string

Возможные значения: <= 100 characters

Позиция/Наименование товара

price

number

Возможные значения: >= 0.01

Стоимость позиции

totalPrice

number

Возможные значения: >= 0.01

Итоговая стоимость

]

orderUrl

string

required

Возможные значения: <= 1000 characters

Ссылка на заказ

payeeInfo

object

Реквизиты получателя

payeeBankBic

string

Возможные значения: Value must match regular expression ^[0-9]{9}$

БИК получателя

payeeCorrAcc

string

Возможные значения: Value must match regular expression ^[0-9]{20}$

Кор счет получателя

payeeInn

string

Возможные значения: Value must match regular expression ^([0-9]{5}|[0-9]{10}|[0-9]{12}|0)$

ИНН получателя

payeeKpp

string

Возможные значения: Value must match regular expression ^([0-9]{9}|0)$

КПП получателя

payeeName

string

Возможные значения: <= 350 characters

Наименование получателя

purpose

string

required

Возможные значения: <= 210 characters

Назначение платежа

vatAmount

number

Возможные значения: >= 0.01

Сумма НДС

{
  "account": "40802810600000200000",
  "amount": 1.01,
  "bankComment": "string",
  "bankStatus": "string",
  "consent": {
    "consent": "Yes",
    "consentHash": "string",
    "consentText": "string",
    "firstname": "Дмитрий",
    "lastname": "Петров",
    "middlename": "Сергеевич",
    "position": "Директор",
    "startDate": "2018-12-31"
  },
  "creditAmount": 1.01,
  "creditProductCode": "MB-F-ip-150",
  "creditTerm": 48,
  "deliveryAmount": 1.01,
  "externalId": "22a6dd81-103a-4d3a-8e9b-0ba4b527f5f6",
  "limitAmountMarketplace": 1.01,
  "marketplaceData": {
    "commissions": [
      {
        "logistic": 1.01,
        "period": "11.2021",
        "stock": 1.01,
        "transaction": 1.01
      }
    ],
    "sellings": [
      {
        "amount": 1.01,
        "fov": 1.01,
        "gmv": 1.01,
        "period": "11.2021",
        "productDescription": "Описание продукта",
        "revenue": 1.01
      }
    ],
    "stock": {
      "amount": 1.01,
      "assortiment": 48,
      "averagePrice": 1.01,
      "date": "2018-12-31",
      "duration": 48,
      "productDescription": "Описание продукта",
      "registrationDate": "2018-12-31",
      "warehousingModel": "fbs"
    }
  },
  "negativeOrderUrl": "https://www.partner.ru/negative_basket",
  "orderId": "2128506",
  "orderInfo": [
    {
      "numOfPosition": 1,
      "position": "string",
      "price": 1.01,
      "totalPrice": 1.01
    }
  ],
  "orderUrl": "https://example.ru/order?uid=2128506",
  "payeeInfo": {
    "payeeBankBic": "044525225",
    "payeeCorrAcc": "30101810400000000225",
    "payeeInn": "7707083893",
    "payeeKpp": "222201001",
    "payeeName": "Общество с ограниченной ответственностью Клиент"
  },
  "purpose": "Оплата заказа №2128506 от 23.12.2019. НДС 20% - 1,01 рублей",
  "vatAmount": 1.01
}

Операция не завершена полностью

• application/json

• Схема
• Пример из схемы

Schema

referenceId

string

Уникальный идентификатор ошибки (UUID)

message

string

Сообщение

checks

object[]

Список проверок, приведших к ошибке

Array [

level

string

Уровень результата

message

string

Сообщение

fields

string[]

Названия полей (при наличии связи с моделью)

]

{
  "referenceId": "string",
  "message": "string",
  "checks": [
    {
      "level": "ERROR",
      "message": "string",
      "fields": [
        "string"
      ]
    }
  ]
}

Ошибка в запросе

• application/json

• Схема
• Пример из схемы

Schema

referenceId

string

Уникальный идентификатор ошибки (UUID)

message

string

Сообщение

checks

object[]

Список проверок, приведших к ошибке

Array [

level

string

Уровень результата

message

string

Сообщение

fields

string[]

Названия полей (при наличии связи с моделью)

]

{
  "referenceId": "string",
  "message": "string",
  "checks": [
    {
      "level": "ERROR",
      "message": "string",
      "fields": [
        "string"
      ]
    }
  ]
}

Не авторизован

• application/json

• Схема
• Пример из схемы

Schema

cause

string

Причина или основание сообщения

referenceId

string

Уникальный идентификатор (UUID)

message

string

Сообщение

{
  "cause": "string",
  "referenceId": "string",
  "message": "string"
}

Запрещено

• application/json

• Схема
• Пример из схемы

Schema

cause

string

Причина или основание сообщения

referenceId

string

Уникальный идентификатор (UUID)

message

string

Сообщение

{
  "cause": "string",
  "referenceId": "string",
  "message": "string"
}

В соответствии с текущими настройками сервиса с clientId=%s необходимо использовать запрос в формате JWS Compact Serialization

• application/json

• Схема
• Пример из схемы

Schema

cause

string

Причина или основание сообщения

referenceId

string

Уникальный идентификатор (UUID)

message

string

Сообщение

{
  "cause": "string",
  "referenceId": "string",
  "message": "string"
}

Внутренняя ошибка сервера

• application/json

• Схема
• Пример из схемы

Schema

cause

string

Причина или основание сообщения

referenceId

string

Уникальный идентификатор (UUID)

message

string

Сообщение

{
  "cause": "string",
  "referenceId": "string",
  "message": "string"
}

Сервис временно недоступен

• application/json

• Схема
• Пример из схемы

Schema

cause

string

Причина или основание сообщения

referenceId

string

Уникальный идентификатор (UUID)

message

string

Сообщение

{
  "cause": "string",
  "referenceId": "string",
  "message": "string"
}

Loading...

Loading...