Versions Compared

Old Version 4

changes.mady.by.user Оксана Нечепоренко

Saved on

compared with

New Version 5

changes.mady.by.user Оксана Нечепоренко

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Http Method

POST

Request URL

https://secure.ubki.ua/b2_api_xml/ubki/xml

Request JSON

Expand
title body:

{

"doc": {

"ubki": {

"req_envelope": {

"req_xml": {

"request": {

"i": {

"ident": {

"okpo": "РНОКПП (ІПН)"

},

"additionaldata": {

"pan": "Кодований ідентифікатор карти (Шифрується публічним ключем VISA, що надається за запитом)"

},

"reqlng": "Мова критеріїв пошуку (Код із дов.23)"

},

"version": "1.0",

"reqtype": "Код шаблону (Код із дов.49): Звіт 'Transaction Underwriting Score' - 07",

"reqsubtype": "Код підшаблону (1 - отримання скорингу та атрибутів; 2 - отримання атрибутів; або не заповнюється у разі отримання тільки скорингу)",

"reqreason": "Мета подання запиту (Код із дов.24)"

},

"descr": "Об’єкт запиту"

},

"descr": "Конверт запиту"

},

"sessid": "Сесійний ключ отримуємо із API авторизації)"

}

}

}

...

Приклад отримання скорингу та атрибутів (reqsubtype="1")

Response XML

Code Block
<?xml version="1.0" encoding="UTF-8"?>
<ubkidata>
   <tech>
      <trace>
         <step name="build report" stm="2022-01-09 18:52:43.675" ftm="2022-01-09 18:52:43.752" />
      </trace>
      <reqinfo reqid="req2#000002007718" />
   </tech>
   <comp id="7" descr="Скоринг карти VISA">
      <scorevisa pan="pan" score="0.1" recordeddate="202201" cardtype="CREDIT" countrycode="804" modelversion="2.0" />
   </comp>
   <comp id="61" descr="Атрибути VISA">
      <visaCardholderSpendProfile>
         <spendSummary spendVolume="18139.5" numberOfTransactions="80255" timePeriod="3M" />
         <spendSummary spendVolume="56321.85" numberOfTransactions="10182" timePeriod="12M" />
         <cardEngagement monthOnBook="15" activeMonths="3" lastTransactionDate="2021-09-10" />
         <spendType categoryType="CNP" spendVolume="2821.85" timePeriod="12M" />
         <spendType categoryType="ATM" spendVolume="3919.8" timePeriod="12M" />
         <spendType categoryType="CASH_OR_XBORDER" spendVolume="5605.65" timePeriod="12M" />
         <authorizationDeclines categoryType="TOTAL" numberOfDeclines="473" timePeriod="3M" />
         <authorizationDeclines categoryType="INSUFFICIENT_FUNDS" numberOfDeclines="1" timePeriod="3M" />
         <categorySpend categoryType="FOOD_AND_GROCERY" spendVolume="1079.93" numberOfTransactions="10170" timePeriod="12M" />
         <categorySpend categoryType="FUEL" spendVolume="247.96" numberOfTransactions="21791" timePeriod="12M" />
         <categorySpend categoryType="HEALTH_CARE" spendVolume="1266.0" numberOfTransactions="13854" timePeriod="12M" />
         <categorySpend categoryType="TRAVEL" spendVolume="34218.75" numberOfTransactions="58888" timePeriod="12M" />
         <categorySpend categoryType="TELECOM_UTILITIES_INSURANCE" spendVolume="25508.0" numberOfTransactions="25701" timePeriod="12M" />
         <categorySpend categoryType="RESTAURANTS_QSR" spendVolume="704.7" numberOfTransactions="11615" timePeriod="12M" />
      </visaCardholderSpendProfile>
   </comp>
</ubkidata>

Приклад отримання атрибутів (reqsubtype="2")

Response XML

Code Block
<?xml version="1.0" encoding="UTF-8"?>
<ubkidata>
   <tech>
      <trace>
         <step name="build report" stm="2022-01-09 18:52:07.765" ftm="2022-01-09 18:52:07.836" />
      </trace>
      <reqinfo reqid="req2#000002007713" />
   </tech>
   <comp id="61" descr="Атрибути VISA">
      <visaCardholderSpendProfile>
         <spendSummary spendVolume="18139.5" numberOfTransactions="80255" timePeriod="3M" />
         <spendSummary spendVolume="56321.85" numberOfTransactions="10182" timePeriod="12M" />
         <cardEngagement monthOnBook="15" activeMonths="3" lastTransactionDate="2021-09-10" />
         <spendType categoryType="CNP" spendVolume="2821.85" timePeriod="12M" />
         <spendType categoryType="ATM" spendVolume="3919.8" timePeriod="12M" />
         <spendType categoryType="CASH_OR_XBORDER" spendVolume="5605.65" timePeriod="12M" />
         <authorizationDeclines categoryType="TOTAL" numberOfDeclines="473" timePeriod="3M" />
         <authorizationDeclines categoryType="INSUFFICIENT_FUNDS" numberOfDeclines="1" timePeriod="3M" />
         <categorySpend categoryType="FOOD_AND_GROCERY" spendVolume="1079.93" numberOfTransactions="10170" timePeriod="12M" />
         <categorySpend categoryType="FUEL" spendVolume="247.96" numberOfTransactions="21791" timePeriod="12M" />
         <categorySpend categoryType="HEALTH_CARE" spendVolume="1266.0" numberOfTransactions="13854" timePeriod="12M" />
         <categorySpend categoryType="TRAVEL" spendVolume="34218.75" numberOfTransactions="58888" timePeriod="12M" />
         <categorySpend categoryType="TELECOM_UTILITIES_INSURANCE" spendVolume="25508.0" numberOfTransactions="25701" timePeriod="12M" />
         <categorySpend categoryType="RESTAURANTS_QSR" spendVolume="704.7" numberOfTransactions="11615" timePeriod="12M" />
      </visaCardholderSpendProfile>
   </comp>
</ubkidata>

Приклад отримання скорингу (reqsubtype="")

Response XML

Code Block
<?xml version="1.0" encoding="UTF-8"?>
<ubkidata>
   <tech>
      <trace>
         <step name="build report" stm="2022-01-09 18:51:18.003" ftm="2022-01-09 18:51:18.08" />
      </trace>
      <reqinfo reqid="req2#000002007707" />
   </tech>
   <comp id="7" descr="Скоринг карти VISA">
      <scorevisa pan="pan" score="0.1" recordeddate="202201" cardtype="CREDIT" countrycode="804" modelversion="2.0" />
   </comp>
</ubkidata>

...