Finline — онлайн-сервис подбора кредитных карт и кредитов
[] Войти Filnline Вебмастерам Банкам 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 Неверный идентификационный код Пример кода "+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" Filnline Вебмастерам Банкам Магазинам FAQ Заявка на кредит API Cоглашение