Безкоштовна послуга УБКІ для клієнта (оплата партнером)
- Оксана Нечепоренко
Сервіс надання оплачених вашою організацією послуг УБКІ для ваших клієнтів.
Оплата послуги, що надається клієнту, здійснюється партнером відповідно до встановлених тарифів.
Http Method | POST |
|---|---|
Headers | Accept: application/jsonContent-Type: application/json |
Request URL | https://nr.ubki.ua/bonusservice/free |
Request JSON( ** параметри передаються опціонально) { "sessid": "Сесійний ключ (отримуємо із API авторизації)", "reptype" : "Код послуги", "inn": "РНОКПП (ІПН) фіз.особи", "**email": "Електронна пошта фіз.особи для повідомлення СКІ", "**phone": "Мобільний телефон у форматі +380…. (Обов'язковий параметр для підключення послуг SKN/SKN_3)" } |
Опис параметрів запиту
Параметр | Опис | Формат |
|---|---|---|
sessid | Сесійний ключ (отриманий через API авторизації) | [TEXT,250] текстовий формат змінної довжини, до 250 символів |
reptype | Код послуги (ALB - Кредитна історія, BLC - Кредитний рейтинг, SKN - СтатусКонтроль на рік, SKN_3 - СтатусКонтроль на 3 місяці) | [TEXT,10] текстовий формат змінної довжини, до 10 символів |
inn | РНОКПП (ІПН) фіз.особи | [N,10] 10 чисельних символів |
Електронна пошта фіз.особи для повідомлення СКІ | [TEXT,250] текстовий формат змінної довжини, до 250 символів | |
phone | Мобільний телефон у форматі +380… | [TEXT,250] текстовий формат змінної довжини, до 250 символів |
Response JSON:{ "result_code": "Код результату виконання операції", "message": "Текстове повідомлення про статус операції", "details": ["Деталі при отриманні помилки"], "partner": { "sessid": "Сесійний ключ (отриманий через API авторизації)", "userid": "ІД користувача", "bankid": "ІД організації", "bankokpo": "ЄДРПОУ організації", "bankname": "Найменування організації" }, "client": { "inn": "РНОКПП (ІПН) фіз.особи", "email": "Електронна пошта фіз.особи для повідомлення СКІ", "phone": "Мобільний телефон у форматі +380…" }, "service": { "reptype": "Код послуги", "reptyperef": "Найменування послуги", "def_price": "Дефолтна вартість послуги", "sale_price": "Вартість послуги з урахуванням знижки для СКІ" }, "billing": { "reqid": "ID запиту", "price": "Вартість послуги для партнера" } } |
Опис параметрів відповіді
Параметр | Опис | Формат |
|---|---|---|
result_code | Код результату (0 - успіх, інше - помилка) | [N,10] 10 чисельних символів |
message | Текстове повідомлення про статус операції | [TEXT,40] текстовий формат змінної довжини, до 40 символів |
details | Деталі при отриманні помилки | [TEXT,1000] текстовий формат змінної довжини, до 1000 символів |
partner | ||
sessid | Сесійний ключ (отриманий через API авторизації) | [TEXT,250] текстовий формат змінної довжини, до 250 символів |
userid | ІД користувача | [TEXT,40] текстовий формат змінної довжини, до 40 символів |
bankid | ІД організації | [TEXT,40] текстовий формат змінної довжини, до 40 символів |
bankokpo | ЄДРПОУ організації | [TEXT,8] текстовий формат змінної довжини, до 8 символів |
bankname | Найменування організації | [TEXT,250] текстовий формат змінної довжини, до 250 символів |
client | ||
inn | РНОКПП (ІПН) фіз.особи | [N,10] 10 чисельних символів |
Електронна пошта фіз.особи для повідомлення СКІ | [TEXT,250] текстовий формат змінної довжини, до 250 символів | |
phone | Мобільний телефон у форматі +380… | [TEXT,250] текстовий формат змінної довжини, до 250 символів |
service | ||
reptype | Код послуги (ALB - Кредитна історія, BLC - Кредитний рейтинг, SKN - СтатусКонтроль на рік, SKN_3 - СтатусКонтроль на 3 місяці) | [TEXT,10] текстовий формат змінної довжини, до 10 символів |
reptyperef | Найменування послуги (ALB - Кредитна історія, BLC - Кредитний рейтинг, SKN - СтатусКонтроль на рік, SKN_3 - СтатусКонтроль на 3 місяці) | [TEXT,250] текстовий формат змінної довжини, до 250 символів |
def_price | Дефолтна вартість послуги ALB - 90.00 BLC - 70.00 SKN - 900.00 SKN_3 - 250.00 | [N,15,2], числовий формат з плаваючою точкою, 2 цифри після крапки |
sale_price | Вартість послуги з урахуванням знижки | [N,15,2], числовий формат з плаваючою точкою, 2 цифри після крапки |
billing | ||
reqid | ID запиту | [TEXT,250] текстовий формат змінної довжини, до 250 символів |
price | Вартість послуги для партнера ALB - 66.00 BLC - 54.00 SKN - 600.00 SKN_3 - 180.00 | [N,15,2], числовий формат з плаваючою точкою, 2 цифри після крапки |
Довідник нотифікацій та помилок
result_code | message |
|---|---|
0 | Операція успішна. Служба підтримки УБКІ: 0445851196. |
1 | Невірний чи застарілий сесійний ключ. Служба підтримки УБКІ: 0445851196. |
2 | Запит відхилено - діє послуга СтатусКонтроль. Служба підтримки УБКІ: 0445851196. |
3 | Дані суб’єкта для побудови звіту відсутні в базі бюро. Служба підтримки УБКІ: 0445851196. |
4 | Відсутні або невалідні обов’язкові атрибути. Служба підтримки УБКІ: 0445851196. |
5 | Системна помилка. Служба підтримки УБКІ: 0445851196. |
6 | Недостатньо коштів на рахунку. Служба підтримки УБКІ: 0445851196. |
Приклад |
|---|
Request JSON | {
"sessid": "98D1069523B34892A264845F762675TF",
"reptype" : "SKN",
"inn": "3241500301",
"email": "o.limarenko@gmail.com",
"phone": "+380635030101"
} |
Response JSON | {
"result_code": "0",
"message": "Операцію успішно виконано. Служба підтримки УБКІ: 0445851196.",
"partner": {
"sessid": "98D0069895B34892A264845F71167FEF",
"userid": "29120",
"bankid": "1826",
"bankokpo": "01982523",
"bankname": "КВІТЕНЬ"
},
"client": {
"inn": "3241500301",
"email": "o.limarenko@gmail.com",
"phone": "+380635030101"
},
"service": {
"reptype": "SKN",
"reptyperef": "СтатусКонтроль на рік",
"def_price": "900",
"sale_price": "0"
},
"billing": {
"reqid": "req2#000982180057",
"price": 600
}
} |