Finline

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 protected]",
                       "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"

О finline

Вебмастерам

ПОМОЩЬ

Лицензии рекламодателей

Вход