Войти

Вебмастерам  Банкам  FAQ
 

API приема заявок affise мульти заявка

Заявки на кредитные карты присылаются по адресу https://partner.finline.ua/api/apply/affise/card/

Заявки на кредит наличными присылаются по адресу https://partner.finline.ua/api/apply/affise/credit/

Передача параметров: POST Все значения должны быть закодированы для URL (url-encoded).

Заявки

Список параметров и допустимых значений


Обязательные параметры:


Параметр      Описание
phone      Мобильный номер телефона, обязательно.
Задается в универсальном формате, например: '+380501234567'.
Код оператора - 3 цифры после +38, должен совпадать с одним из списка
['039','050','063','066','067','068','091','092','093','094','095','096','097','098','099']
firstName      Имя
lastName      Фамилия
birthDate      Дата рождения в формате dd.mm.yyyy
amount      Сумма денег для заявок на кредит
employment      Трудоустройство. Допустимые значения:
  • no -- не трудоустроен
  • official -- устроен официально
  • officialPrivate -- официально в фирме через СПД/ФЛП
  • private -- СПД/ФЛП
  • unofficial -- устроен неофициально
  • maternityLeave -- декретный отпуск
  • pensioner -- пенсионер
  • aim      Цель кредита. Допустимые значения:
  • usedCar -- покупка Б/У авто
  • technics -- ремонт/покупка техники, мебели
  • humanDeposit -- деньги под залог авто
  • cure -- на лечение
  • business -- на бизнес
  • otherCredit -- погашение другого кредита
  • untilSalary -- деньги до зарплаты
  • other -- другое
  • agree      Согласие клиента на обработку персональных данных. true | false
    agreeTime      Дата согласия клиента на обработку персональных данных в формате Y-m-d H:i:s Пример: 2018-01-01 23:21:21
    affiseID      идентификатор из системы affise
    url      Ссылка на страницу, с которой была получена заявка.
    city      Город

    Необязательные параметры:


    Параметр      Описание
    identCode      Идентификационный код (дает больше шанс для обработки заявки)
    middleName      Отчество. Опционально.
    email      E-mail, опционально

    Список ответов:

    Список ошибок и ответ API

    Возвращаемые поля:


    Параметр      Описание
    result      возвращает результат операции. Если операция прошла успешно вернет значение true. В случае ошибки возвращает false
    state      состояние запроса. Возможные значения: OK - запрос принят, Reject- отказано, Sink- сток, в очереди отправки
    message      (Появляется в случае state = reject) причина отказа запроса
    leadID      идентификатор заявки в системе финлайн
    error      (Появляется в случае result = false) Текст ошибки
    verification      Он содержит значение ID смс-подтверждения (Только АльфаБанк)

    Список возможных ошибок и их описание:

    При ошибке обработки запроса, сервер возвращает параметр result с значением false и параметром error, в котором храниться текст ошибки


    Текст ошибки      Описание
    Empty phone param      Пустой параметр Телефона
    Empty FirstName param      Пустой параметр Имени
    Empty LastName param      Пустой параметр Фамилии
    Empty city param      Пустой параметр Город
    Empty amount param      Пустой параметр запрашиваемых денег на кредит
    Wrong amount param format      Неверно указанный формат запрашиваемых денег на кредит
    Empty aim param      Пустой параметр цели кредита
    Wrong aim param format      Неверный формат цели кредита
    Empty employment param      Пустой параметр трудоустройства
    Wrong employment param format      Неверный формат трудоустройства
    Agree client accept not true      Нет согласия Клиента на обработку данных
    Empty affiseID param      Пустое идентификатор affise
    Wrong affiseID param format      Неверный формат параметра идентификатор affise
    Wrong agreeTime param format      Неаерный формат параметра даты согласия на обработку данных
    Empty birthDate param      Пустое дата рождения
    Wrong birthDate param format      Неверный формат параметра дата рождения
    Wrong identCode param format      Неверный идентификационный код

          

    Пример кода



    <?php $url = 'https://partner.finline.ua/api/apply/affise/card/'; $params = [ "phone"=>"+300930000000", "identCode"=>"1234567890", "employment"=>"no", "firstName"=>"Тест", "lastName"=>"Пупкин", "agree"=>"true", "url"=>"http://mysite.com.ua/land1/l", "agreeTime"=>"2018-01-01 23:21:21", "email"=>"email@domain.com", "affiseID"=>"2", "birthDate"=>"28.06.1992", "amount"=>"300", "aim"=> "technics" ]; $curl = curl_init(); $params = http_build_query($params); if ($curl) { curl_setopt($curl, CURLOPT_URL, $url); curl_setopt($curl, CURLOPT_POST, 1); curl_setopt($curl, CURLOPT_POSTFIELDS, $params); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: application/x-www-form-urlencoded')); $out = curl_exec($curl); curl_close($curl); }

    СМС верификация для альфа-банка


    Для смс-верификации Альфы:

    Если лид отправляется в Альфа-банк, нужно передать параметр “verification" = "|6”.

    В ответ от сервера приходит параметр, который также называется "verification”. Он содержит значение ID смс-подтверждения. А пользователю в это время приходит смс-сообщение.


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

    
            $params = [
                "offerCode" => "cardCredit",
                "firstName" => "Вася",
                "lastName" => "Пупкин",
                "phone" => "0631231231",
                "age"=>"33000",
                "birthDate" => "02.11.1939",
                "city" => "Kiyv",
                "employment" => "officialMore6",
                "identCode" => "3040512736",
                "amount" => 20000,
                "verification" => "|6"
            ];
            

    После этого наш сервер ожидает от вас POST-запрос на адрес http://partner.finline.ua/api/verify/


    Параметры запроса:


    • ’id' = $smsId, // ИД смс-подтверждения из прошлого абзаца
    • 'code' = $code // код, который пришел в смс пользователю.

    Пример ответа :
    
            {
                "result": "true",
                "state": "ok",
                "remoteID": 4331806,
                "verification": 1111
            }
    
    Пример запроса на смс валидацию:
    
            $params = [
                “id” = 1111,
                “code” = 24242,
            ];
    
    

    Ответ о верификации:


    Возвращает ответ о принятии смс сообщения и статус смс от альфа банка.


    "result": "ok",

    "sms_status": "serverError"


    Параметры:

    • "result" - статус принятия сообщения сервером финлайн
    • "sms_status" - статус ответ смс от альфа-банка.
    В случае внутренней ошибки на сервере финлайн параметр result вернет error "result": "error"