Подключение сервиса (API)

Реферальная ссылка

Реферальная ссылка – это ссылка, содержащая специальный код, который позволяет идентифицировать, что посетитель зашел на сайт по приглашению партнера.
Реферал – это пользователь, зашедший на сайт МФО по вашей реферальной ссылке и отправивший заявку на микрокредит.
Чтобы получить реферальную ссылку, необходимо обязательно стать Агентом МФО.
Размещение реферальных ссылок можно осуществлять на любых страницах в интернете, просматриваемых пользователями, которые являются вашими потенциальными рефералами:
  • Размещение реферальных ссылок в соцсетях: на личной странице и в тематических сообществах;
  • Размещение реферальных ссылок на форумах, общих и тематических, в сообщениях и/или в личной подписи;
  • Размещение реферальных ссылок в статусах программ для мгновенного обмена сообщениями (skype, WhatsApp, Mail.ru агент и т.п.);
  • Публикация тематических статей, содержащих реферальные ссылки на собственном сайте/блоге.

Пример реферальной ссылки: https://www.mfo.kz/?ref=0001, где 0001 - персональный код Агента.
Время жизни cookie: 30 дней - время, на которое пользователь будет привязан к Агенту после перехода по реферальной ссылке.

SOAP - протокол

Описание

Файл описания методов веб-сервиса: http://agent.mfo.kz/services/soap.html?wsdl
Все параметры должны передаваться в кодировке UTF-8.

Получение списка городов

Для получения списка городов используется метод GetCitysList. $client = new SoapClient('http://agent.mfo.kz/services/soap.html?wsdl');
$ret = $client->GetCitysList(array('agent_code'=>'0001', 'agent_psw'=>'123'));

Описание параметров, передаваемых Серверу:

Параметр Значение
agent_code Код Агента. Обязательный параметр.
agent_psw Пароль Агента или MD5-хеш пароля в нижнем регистре. Обязательный параметр.

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

Параметр Значение
result Результат выполнениня функции (метода).
true(1) - успешно выполнен.
false(0) - во время выполнения метода возникла ошибка.
citys_list Список городов, где клиент может оформить микрокредит.
city_id - код города.
city_name - наименование города (рус).
error Код ошибки.

Код ошибки (error) может принимать следующие значения:

Значение Описание
1 Ошибка в передаваемых параметрах.
2 Неверный код агента или пароль.
3 Невозможно получить данные с сервера МФО.

Отправка заявки на отработку в МФО

Для отправки заявки на сервер МФО используется метод SaveOrder. $client = new SoapClient('http://agent.mfo.kz/services/soap.html?wsdl');
$ret = $client->SaveOrder(array('agent_code'=>"0001", "agent_psw"=>"123", "money"=>"51000", "month"=>"3", "fio"=>"Фамилия Имя Отчество", "phone"=>"7777777777", "iin"=>"801010101010", "city_id"=>"1"));

Описание параметров, передаваемых Серверу:

Параметр Значение
agent_code Код Агента.
agent_psw Пароль Агента или MD5-хеш пароля в нижнем регистре.
money Запрашивая сумма микрокредита. Число от 50000 до 7000000.
month Срок микрокредита (месяцев). Число от 3 до 36.
fio Фамилия Имя Отчество заемщика (через пробел). Только кирилица.
phone Контактный телефон. Число. 10 знаков. (номер телефона без 8 или +7).
iin ИИН заемщика. 12 знаков.
city_id Код города. Можно получить методом GetCitysList.
utm UTM - метка. Текстовое поле длинной 12 символов. Можно передавать любой текст для дальнейшего анализа. Необязательное поле!
type_of_order Тип заявки: 0 - денежный микрокредит; 1 - внешнее рефинансирование; 2 - микрокредит под залог авто. Необязательное поле! По умолчанию значение: 0
Внимание! Все параметры обязательные и правильность заполнения информации заемщиком влияет на предварительное одобрение заявки на микрокредит.

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

Параметр Значение
result Результат выполнениня функции (метода).
true(1) - успешно выполнен.
false(0) - во время выполнения метода возникла ошибка.
error Код ошибки.
order_id Код заказа в системе МФО (только при result=true)

Код ошибки (error) может принимать следующие значения:

Значение Описание
1 Ошибка в передаваемых параметрах.
2 Неверная сумма микрокредита.
3 Неверно указано количество месяцев.
4 Возраст заемщика менее 21 года.
5 Неверный код агента или пароль.
6 Неверно указан город для оформления микрокредита.
7 Невозможно сохранить заявку на сервере МФО.
8 Предварительный отказ (на основе данных скоринга МФО).
9 ИИН некорректен.
10 Повторный ИИН или телефон (в системе уже есть заявка с таким ИИН или контактным телефоном).

Отправка заявки на обратный звонок в МФО

Для отправки заявки "обратный звонок" на сервер МФО необходимо вызвать метод SaveMobileCallBack. $client = new SoapClient('http://agent.mfo.kz/services/soap.html?wsdl');
$ret = $client->SaveMobileCallBack(array('agent_code'=>"0001", "agent_psw"=>"123", "phone"=>"7777777777"));

Описание параметров, передаваемых Серверу:

Параметр Значение
agent_code Код Агента.
agent_psw Пароль Агента или MD5-хеш пароля в нижнем регистре.
phone Контактный телефон. Число. 10 знаков. (номер телефона без 8 или +7).
fio Фамилия Имя Отчество заемщика (через пробел). Только кирилица. Необязательное поле!
utm UTM - метка. Текстовое поле длинной 12 символов. Можно передавать любой текст для дальнейшего анализа. Необязательное поле!
type_of_order Тип заявки: 0 - денежный микрокредит; 1 - внешнее рефинансирование; 2 - микрокредит под залог авто. Необязательное поле! По умолчанию значение: 0

HTTP - протокол

Описание

URL сервиса: http://agent.mfo.kz/services/http.html
Все параметры должны передаваться в кодировке UTF-8.
Весь запрос необходимо закодировать с помощью функции urlencode (для метода GET).
Все ответы в json формате.

Получение списка городов

Для получения списка городов необходимо вызвать методом GET или POST адрес сервиса. http://agent.mfo.kz/services/http.html?agent_code=0001&agent_psw=123&function=GetCitysList

Отправка заявки на отработку в МФО

Для отправки заявки на сервер МФО необходимо вызвать методом GET или POST адрес сервиса. http://agent.mfo.kz/services/http.html?agent_code=0001&agent_psw=123&function=SaveOrder&money=50000&month=12&fio=ФамилияМоя&phone=7777777777&iin=801010101010&city_id=1

Отправка заявки на обратный звонок в МФО

Для отправки заявки "обратный звонок" на сервер МФО необходимо вызвать методом GET или POST адрес сервиса. http://agent.mfo.kz/services/http.html?agent_code=0001&agent_psw=123&function=SaveMobileCallBack&phone=7777777777