Ukrcard
  1. UAPI
Ukrcard
  • Default module
    • Вступ
    • Початок роботи
    • Вебхуки та оновлення статусу
    • Загальні концепції
    • Особистий кабінет торговця
    • Payments API методи
      • Рецепти
      • Довідка
        • Потоки обробки транзакцій
        • Коди відповідей
        • Тестові дані
        • Налаштування та використання сервісу callback
      • E-Commerce еквайринг
        • /Payment
        • /Preauthorization
        • /CancelPreauthorization
        • /Completion
        • /ConfirmExt
        • /Reverse
        • /Refund
        • /Verify
      • Грошові перекази
        • /р2рTransfer
        • /Confirm
        • /ConfirmExt
        • /Reverse
        • /Refund
        • /Verify
      • Платежі з цифрового гаманця
      • Платіжні операції з використанням токенів
        • /Payment
        • /Preauthorization
        • /p2pTransfer
        • /Confirm
        • /ConfirmExt
        • /Panbytoken
      • Apple Pay
        • /PaymentAppleD
        • /PaymentAppleE
        • /p2pTransferAppleD
        • /p2pTransferAppleE
      • Google Pay
        • /PaymentGoogleD
        • /PaymentGoogleE
        • /p2pTransferGoogleD
        • /p2pTransferGoogleE
    • Schemas
      • E-Commerce еквайринг
        • Payment Request
  • UAPI
    • Визначення
    • Рецепти
    • UAPI: Картки та рахунки
      • /cards/issuacevirtualcard (140-Запит видачі віртуальної картки)
      • /cards/issuacephysicalcard (141-Запит видачі фізичної картки)
      • /cards/{panid}/baseparam/status (111-Запит/зміна статусу картки)
      • /cards/getcarddataecom (138-Запит даних картки для eCommerce)
      • /cards/setpin (137-Запит на встановлення PIN картки)
      • /cards/changepin (136-Замовлення зміни PIN картки)
      • /cards/gettransactions (122-Запит історії транзакцій)
      • /cards/registryvirtualcard (Запит реєстрації віртуальної карти)
      • /service/changeservice (Підключення фінансового номера телефону)
      • /cards/order3dsecure (Зміна параметра 3DS аутентифікації )
      • /cards/getcarddataecom (Запит CVV2)
      • /accounts/switchsms (187-Перемикання каналу доставки повідомлень PUSH\SMS)
      • /accounts/changephone (Зміна фінансового номера телефону )
      • /cards/{panid}/baseparam/limits (112-Запит/зміна лімітів карти)
    • Schemas
      • UAPI: Картки та рахунки
        • PUT /accounts/switchsms
        • PUT /cards/getcarddataecom
        • pan+mbr
        • panid+panmask+mbr
        • pan+panid+panmask+mbr
  1. UAPI

Рецепти

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 в режимі самостійного вибору наступної вільної картки:
{
    "virtualcard": {
        "prodtype": "MD",
        "currencyno": "980" 
    }
}
Після того як віртуальної картка стала доступною, необхідно провести наступні дії для повноцінного використання картки клієнтом:
\
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
Previous
Визначення
Next
/cards/issuacevirtualcard (140-Запит видачі віртуальної картки)
Built with