1.Віртуальні карти#
Віртуальна (digital first) картка - це цифрова картка, яка існує у смартфоні (в застосунку) та призначена для безпечних онлайн-покупок, безконтактних оплат (Apple/Google Pay) та переказів. Така карта має ті ж самі реквізити (номер, CVV, термін дії), що й фізична (наприклад пластикова) картка. Віртуальна картка може бути потім додатково випущена у фізичній формі по окремій процедурі видання.Видання віртуальних (digital first) карток можливо наступними сценаріями, залежно від можливостей карткового бек-офісу (див. КБО у розділі Визначення) та мобільних застосунків.1.
КБО (КБО2, КБО3) генерує параметри карти (PANID, PAN, exp date, тип продукту) та готує пакет Refresh по виданню карток з ознакою Віртуальна. Пакет обробляється приблизно за 30 хвилин, після чого картки будуть доступні на ПЦ та в UAPI.
2.
КБО (КБО1) генерує параметри карти (PAN, exp date) та викликає метод UAPI\issuevirtualcard , у відповідь отримує PANID для подальшого використання в UAPI та інших системах Укркарт. Картка буде доступна на ПЦ та в UAPI через 5-10 хвилин
3.
Для онлайн активації карток використовується сценарій попереднього замовлення на сервіс-деск необхідної кількості карток у обраному префіксі. Сервіс-деск протягом робочого дня здійснює пакетний випуск карток, які будуть доступні на ПЦ та в UAPI в статусі 0 - “Не активна” та за необхідності надає фінансовій установі перелік таких карток для подальшої обробки в її системах та видачі клієнтам з подальшою активацією. Також існує режим, коли UAPI самостійно працює з цим переліком , та самостійно обирає наступну вільну картку з обраного префіксу та повідомляє відповідний системі фінансової установи (КБО, мобільний застосунок тощо) параметри виданої картки (PANID, PAN, exp date) для реєстрації видачі та обробки.1.
Приклад виклику UAPI в режимі самостійного вибору наступної вільної картки:
Після того як віртуальної картка стала доступною, необхідно провести наступні дії для повноцінного використання картки клієнтом:1.
Підключення фінансового номера телефону (якщо це не було виконано в Сценаріях 1 та 2). Для цього треба викликати UAPI /service/changeservice
2.
Виконати активацію картки. Для цього змінити статус викликом UAPI /cards/{PanID}/baseparam/status на 1 -” Відкрита”
3.
Підключити картку до сервісу аутентифікації 3DS. Для цього викликати UAPI /cards/order3dsecure
4.
В залежності від потреб мобільного застосунку ввімкнути\вимкнути необхідний режим SMS\PUSH. Для цього викликати UAPI /accounts/switchsms
Приклади викликів UAPI наведені в розділі Картки та рахунки (UAPI)Modified at 2026-03-13 15:55:58