Передача предложений Яндексу

Метод для возврата предложений, доступных клиенту. Вызывает партнер по результату скоринга.

Метод реализован на стороне Яндекса, токен доступа будет выдан единоразово на этапе подключения.

Формат запроса

POST /send-offers
Пример запроса
{
  "request_id": "123e4567-e89b-12d3-a456-426614174000",
  "partner_id": 0,
  "decision": "has_approve",
  "reason": "example",
  "offers": [
    {
      "offer_id": "example",
      "decision": "pre_approved",
      "loan_type": "pdl",
      "counterparty_id": "123e4567-e89b-12d3-a456-426614174000",
      "promo": "example",
      "amount": {
        "value": 0.5,
        "refund": 0.5
      },
      "term": {
        "value": 0.5,
        "type": "day"
      },
      "rate": {
        "from": null,
        "to": null,
        "grace_period": null,
        "total_credit_cost": {
          "from": {},
          "to": null
        }
      },
      "total_credit_cost": {
        "from": 20,
        "to": 40
      },
      "payment": {
        "from": {
          "value": 0.5,
          "type": "day"
        },
        "to": null
      },
      "additional_info": {
        "loan_extension_condition": "example",
        "late_payment_penalty": "example",
        "early_repayment": "example",
        "additional_services": [
          {}
        ],
        "requirements": {
          "citizenship_rf": true,
          "income": 0.5,
          "last_work_experience": null,
          "total_work_experience": null,
          "age": {},
          "required_documents": [
            null
          ],
          "choosable_documents": [
            null
          ]
        }
      },
      "links": {
        "link": "example",
        "deep": "example",
        "created_at": "2025-01-01T00:00:00Z",
        "expires_at": "2025-01-01T00:00:00Z"
      },
      "props": {}
    }
  ]
}

Параметр

Описание

Тип

Обязательно

Комментарий

decision

Решение по запросу.

string

Да

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

  • has_approve – одобрено;
  • rejected – отказано.

partner_id

Идентификатор партнера.

integer

Да

request_id

Идентификатор запроса.

string

Да

UUID. Пример: 123e4567-e89b-12d3-a456-426614174000.

offers

Массив предложений.

Offer

Нет

reason

Причина отказа.

string

Нет

Offer

Параметр

Описание

Тип

Обязательно

Комментарий

amount

Объект с суммой займа.

object

Да

refund — сумма к возврату; value — сумма займа.

counterparty_id

Идентификатор контрагента, предоставляющего предложение.

string

Да

UUID. Пример: 123e4567-e89b-12d3-a456-426614174000.

decision

Тип предложения.

string

Да

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

  • pre_approved;
  • full_approved.

links

Ссылки на предложение.

Links

Да

Обязательно отправлять link или deep.

loan_type

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

string

Да

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

  • pdl;
  • il.

offer_id

Идентификатор предложения, должен быть уникальным в рамках запроса.

string

Да

payment

Объект с информацией по платежам.

object

Да

to — максимальные платежи, Payment; from — минимальные платежи, Payment

rate

Объект с информацией по процентам.

Rate

Да

term

Срок займа.

Term

Да

total_credit_cost

ПСК (Полная стоимость кредита) в % годовых.

object

Да

Указывается как диапазон [min, max], например [20.000, 40.000].

additional_info

Объект с дополнительной информацией.

AdditionalInfo

Нет

promo

Промо‑текст.

string

Нет

props

Опциональный объект для поддержания совместимости API.

object

Нет

Payment

Параметр

Описание

Тип

Обязательно

Комментарий

type

Тип периодичности

string

Да

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

  • day — день;
  • month — месяц;
  • week — неделя;
  • year — год;
  • two_weeks — две недели;
  • once — единоразово в рамках срока займа.

value

Сумма в рублях.

number

Да

Параметр

Описание

Тип

Обязательно

Комментарий

created_at

Дата и время генерации URL.

string

Да

date-time. Формат: yyyy-mm-ddTHH:mm:ssZ. Пример: 2025-01-01T00:00:00Z.

deep

Диплинк в мобильное приложение.

string

Да

expires_at

Дата и время окончания действия URL.

string

Да

date-time. Формат: yyyy-mm-ddTHH:mm:ssZ. Пример: 2025-01-01T00:00:00Z.

link

Простая ссылка

string

Да

Rate

Параметр

Описание

Тип

Обязательно

Комментарий

to

Процентная ставка до.

Term

Да

from

Процентная ставка от.

Term

Да

grace_period

Беспроцентный период.

Term

Да

total_credit_cost

Полная стоимость кредита. Указывается в % годовых.

object

Да

Устаревший объект. from — от, TotalCreditCost; to — до, TotalCreditCost

Total credit cost

Устаревший объект. Новый вынесен на уровень выше.

Параметр

Описание

Тип

Обязательно

Комментарий

type

Тип периодичности

string

Да

Возможные значения: year — год.

value

Минимальная ПСК в % годовых.

number

Да

Три знака после запятой.

Term

Параметр

Описание

Тип

Обязательно

Комментарий

type

Тип периодичности.

string

Да

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

  • day — день;
  • month — месяц;
  • week — неделя;
  • year — год.

value

Срок / Сумма в рублях / Процентная ставка.

number

Да

AdditionalInfo

Параметр

Описание

Тип

Обязательно

Комментарий

additional_services

Дополнительные услуги.

Service

Нет

early_repayment

Условия досрочного погашения займа.

string

Нет

late_payment_penalty

Штрафы за просрочку платежа.

string

Нет

loan_extension_condition

Условия продления займа.

string

Нет

requirements

Требования к заемщику.

Requirements

Нет

Service

Параметр

Описание

Тип

Обязательно

Комментарий

description

Описание услуги.

string

Нет

name

Название услуги.

string

Нет

type

Тип стоимости услуги.

string

Нет

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

  • fixed;
  • relative.

value

Стоимость услуги.

number

Нет

Requirements

Параметр

Описание

Тип

Обязательно

Комментарий

age

Требуемый возраст.

AgeRange

Нет

Возрастной интервал.

choosable_documents

string[]

Нет

citizenship_rf

Требование гражданства РФ.

boolean

Нет

income

Ежемесячный доход.

number

Нет

last_work_experience

Опыт на текущем месте работы.

Term

Нет

required_documents

string

Нет

total_work_experience

Суммарный опыт работы.

Term

Нет

AgeRange

Параметр

Описание

Тип

Обязательно

Комментарий

from

Минимальный возраст.

number

Нет

to

Максимальный возраст.

number

Нет

Успешный ответ

200 OK
Формат ответа
{
  "request_id": "123e4567-e89b-12d3-a456-426614174000"
}

Параметр

Описание

Тип

Обязательно

Комментарий

request_id

Идентификатор запроса.

string

Да

UUID. Пример: 123e4567-e89b-12d3-a456-426614174000.

Стандартные коды ответов

Остались вопросы?

Внимание

Специалисты отдела клиентского сервиса могут вас проконсультировать только по кампаниям того логина, с которого вы обращаетесь. Логин можно увидеть, если открыть ya.ru на соседней вкладке браузера. Специалист получит доступ к вашим данным только при обработке обращения.

Сканируйте QR-код или нажмите на него для перехода по ссылке.

При выборе Telegram, WhatsApp учитывайте, что Яндекс не контролирует, как сторонние мессенджеры хранят ваши данные и переписку на своей стороне, и не несет за это ответственность.

Написать в Viber

Для обращений из Республики Беларусь

Написать в чат

Позвонить

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

Регионы России: 8 800 700-47-45 (звонок из России бесплатный)

Москва: +7 495 139-91-93

Беларусь: +375 17 336-31-36

Узбекистан: +998 71 205-58-05

Казахстан: +7 727 344-31-31

Для доступа к кампаниям специалисту потребуется PIN-код