API приема заявок
Все заявки присылаются по адресу http://partner.finline.ua/api/apply/.
Передача параметров: POST
Все значения должны быть закодированы для URL (url-encoded).
Заявки
Список параметров и допустимых значений
Обязательные параметры:
| Параметр |
Описание |
| birthDate |
Дата рождения в формате dd.mm.yyyy |
| identCode |
Идентификационный код
для обработки запроса, возможно из полей. Либо дата рождения, либо идентификационный код.
|
| Phone |
Мобильный номер телефона, обязательно. Задается в универсальном формате, например: '+380501234567'.
Код оператора - 3 цифры после +38, должен совпадать с одним из списка
['039','050','063','066','067','068','091','092','093','094','095','096','097','098','099'] |
| firstName |
Имя |
| lastName |
Фамилия |
| employment |
Трудоустройство. Допустимые значения:
no -- не трудоустроен
official -- устроен официально
officialPrivate -- официально в фирме через СПД/ФЛП
private -- СПД/ФЛП
unofficial -- устроен неофициально
maternityLeave -- декретный отпуск
pensioner -- пенсионер
|
| aim |
Цель кредита. Допустимые значения:
usedCar -- покупка Б/У авто
technics -- ремонт/покупка техники, мебели
humanDeposit -- деньги под залог авто
cure -- на лечение
business -- на бизнес
otherCredit -- погашение другого кредита
untilSalary -- деньги до зарплаты
other -- другое
|
| partner |
идентификатор партнера, параметр. Его можно посмотреть на персональной странице по адресу: http://partner.finline.ua/partner/ |
| offerCode |
параметр типа заявки. Допустимые значения:
cashCard -- кредит наличными (по-умолчанию)
cardCredit -- кредитная карта |
| agree |
Согласие клиента на обработку персональных данных. true | false |
| agreeTime |
Дата согласия клиента на обработку персональных данных в формате Y-m-d H:i:s Пример: 2018-01-01 23:21:21. |
| amount |
Сумма денег для заявок на кредит (обязательный в случае денежного кредита) |
Необязательные параметры:
| Параметр |
Описание |
| url |
Ссылка на страницу, с которой была получена заявка. Опционально. |
| middleName |
Отчество. Опционально. |
| city |
Город, опционально. |
| email |
E-mail, опционально |
| amount |
Сумма для заявок на кредиты(Опционально в случае заказа кредитной карты) |
Список ответов:
Список ошибок и ответ API
Возвращаемые поля:
| Параметр |
Описание |
| result |
возвращает результат операции. Если операция прошла успешно вернет значение true. В случае ошибки возвращает false |
| state |
состояние запроса. Возможные значения: OK - запрос принят, Reject- отказано, Sink- сток, в очереди отправки |
| message |
(Появляется в случае state = reject) причина отказа запроса |
| remoteID |
уникальный индификатор присвоенный запросу. |
| error |
(Появляется в случае result = false) Текст ошибки |
Список возможных ошибок и их описание:
При ошибке обработки запроса, сервер возвращает параметр result с значением false и параметром error, в котором храниться текст ошибки
| Текст ошибки |
Описание |
| Empty offerCode |
Пустой параметр кода оффера |
| Empty amount param |
Пустой параметр сумы кредита. |
| No such offer code |
Не правильно указанный код оффера, или такого кода не существует. |
| Empty phone param |
Пустой параметр телефона |
| Empty FirstName param |
Пустой параметр имени |
| Empty LastName param |
Пустой параметр фамилии |
| Wrong amount param format |
Неверно указанный формат запрашиваемых денег на кредит |
| Empty partner param |
Пустое поле партнёра |
| Wrong partner format |
Неверный форма параметра партнёра |
| No such partner |
Такого партнёра не существует |
| Empty employment format |
Пустой параметр трудоустройства |
| Wrong employment format |
Неверный формат трудоустройства |
| Wrong birthDate format |
Неверный формат даты рождения |
Пример кода
<?php
$url = 'http://partner.finline.ua/api/apply/';
$params = [
"employment"=>"no",
"firstName"=>"Вася",
"identCode"=>"3040512736",
"lastName"=>"Пупкин",
"offerCode"=>"cashCard",
"partner"=>"1",
"phone"=>"0500718251",
"birthDate"=>"02.11.1992",
"amount"=>"1000",
"url"=>"http://myland.com.ua/land1/",
"agree"=>"true",
"agreeTime"=>"2018-01-01 23:21:22",
"aim"=> "untilSalary"
];
$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"