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 -- кредитная карта |
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",
"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);
}
|