Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

Сервіс, що дозволяє оплатити послуги УБКІ за своїх клієнтів, надаючи їм доступ до важливої інформації без жодних додаткових витрат з їхнього боку.

Списання вартості послуги здійснюється з рахунку партнера відповідно до встановленого тарифу

Http Method

POST

Headers

Accept: application/json

Content-Type: application/json

Request URL

https://nr.ubki.ua/bonusservice/free

Request JSON

  body:

{

"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 чисельних символів

email

Електронна пошта фіз.особи

[TEXT,250] текстовий формат змінної довжини, до 250 символів

phone

Мобільний телефон у форматі +380…

[TEXT,250] текстовий формат змінної довжини, до 250 символів

Response JSON:

 body:

{

"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 чисельних символів

email

Електронна пошта фіз.особи

[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
    }
}

  • No labels