Ukrcard
  1. Картки та рахунки (UAPI)
Ukrcard
  • Вступ
  • Початок роботи
  • Рецепти
  • Загальні концепції
  • Особистий кабінет торговця
  • Довідка
    • Потоки обробки транзакцій
    • Коди відповідей
    • Тестові дані
  • Наші методи
    • E-Commerce еквайринг
      • /Payment
      • /Preauthorization
      • /CancelPreauthorization
      • /Completion
      • /ConfirmExt
      • /Reverse
      • /Refund
      • /Verify
    • Грошові перекази
      • /р2рTransfer
      • /Confirm
      • /ConfirmExt
      • /Reverse
      • /Refund
      • /Verify
    • Платежі з цифрового гаманця
    • Картки та рахунки (UAPI)
      • /cards/issuacevirtualcard (140-Запит видачі віртуальної картки)
        PUT
      • /cards/{panid}/baseparam/limits (112-Запит/зміна лімітів карти)
        PUT
    • Перекази SEPA
    • Платіжні операції з використанням токенів
      • /Payment
      • /Preauthorization
      • /p2pTransfer
      • /Confirm
      • /ConfirmExt
      • /Panbytoken
    • Apple Pay
      • /PaymentAppleD
      • /PaymentAppleE
    • Google Pay
      • /PaymentGoogleD
      • /PaymentGoogleE
  1. Картки та рахунки (UAPI)

/cards/issuacevirtualcard (140-Запит видачі віртуальної картки)

Developing
Cloud Mock
https://mock.apidog.com/m1/483896-0-default
Cloud Mock
https://mock.apidog.com/m1/483896-0-default
PUT
/uapi-2.0/v1/cards/issuacevirtualcard
Maintainer:Not configured
Запит видачі віртуальної картки

Request

Body Params application/json
virtualcard
object 
required
Дані віртуальної картки.
pan
string  | null 
optional
Номер картки. Якщо тег є присутнім і заповнений, то значення panmask ігноруються.
panmask
string  | null 
optional
Номер маскований:
NNNNNN******NNNN.
Якщо тег pan присутній і заповнений, то значення panmask і присутній і заповнений тег panmask, то значення panmask має відповідати значенню pan.
Якщо тег pan відсутній або не заповнений, виконується контроль:
Котроль Текст помилки
panmask!=null І довжина > 19 Поле має містити до 19 символів
mbr
integer  | null 
optional
Номер учасника картки. Завжди = 0.
Котроль Текст помилки
≠ 0 Поле має бути завжди 0
Якщо не заповнено, то за промовчанням = 0.
>= 0<= 0
panid
string  | null 
required
Індекс картки (PANId).
Якщо тег pan є присутнім і заповнений, то значення panid має відповідати значенню pan.
Якщо тег pan відсутній або не заповнений, виконується контроль:
Котроль Текст помилки
panid=null І
довжина >20 Поле має містити до 20 символів.
<= 20 characters
expdate
string  | null 
optional
Дата закінчення терміну дії віртуальної картки YYMM
>= 4 characters<= 4 characters
accountno
string  | null 
optional
Номер картрахунку.
currencyno
integer 
required
Цифровий код валюти рахунку віртуальної картки. Можливі значення довідника валют ISO.
authholder
object  | null 
optional
Дані ідентифікації власника віртуальної картки та типового договору.
authaction
string  | null 
optional
ія реєстрації видачі картки емітентом.
NEW Новий клієнтський договір із видачею попередньої віртуальної карти.
ADD Видача попередньої віртуальної картки на існуючому клієнтському договорі.
authpanid
string  | null 
optional
Panid існуючої картки, власником якої є одержувач віртуальної картки.
Параметр, що ідентифікує клієнта.
Для автоматичного відкриття договору в ME (BCZCard +) параметр повинен заповнюватися в парі з auth сontractct.
authaccountno
string  | null 
optional
Номер існуючого картрахунку, власником якого є одержувач віртуальної картки.
Параметр, що ідентифікує клієнта.
Для автоматичного відкриття договору в ME (BCZCard+) параметр повинен заповнюватися в парі з authсontractct.
authmobphone
string  | null 
optional
Номер мобільного телефону одержувача віртуальної картки (05.09.2020).
Параметр, що ідентифікує клієнта.
Для автоматичного відкриття договору в ME (BCZCard+) параметр повинен заповнюватися в парі з authсontractct.
<= 14 characters
Match pattern:
[0-9]{14}
authсontractct
string 
required
Ідентифікатор шаблону картки клієнтського договору у системі BCZCard+ (05.09.2020).
Призначений для ідентифікації типового договору відкриття клієнтського договору.
Для автоматичного відкриття договору в МЕ (BCZCard+) повинен заповнюватися в парі з мінімум з одним із параметрів, що ідентифікують клієнта (вище),
тобто. або з authpanid, або authaccountno, або authmobphone.
userdata
string  | null 
optional
Дані користувача.
Example
{
    "virtualcard": {
        "pan": "5596######5618",
        "panmask": "559600######5618",
        "mbr": "0",
        "panid": "1701000000101674150",
        "prodtype": "M6",
        "accountno": "5451000049954",
        "iban": null,
        "currencyno": 980,
        "expdate": "2707"
    },
    "userdata": "1877"
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://mock.apidog.com/m1/483896-0-default/uapi-2.0/v1/cards/issuacevirtualcard' \
--header 'Content-Type: application/json' \
--data-raw '{
    "virtualcard": {
        "pan": "5596######5618",
        "panmask": "559600######5618",
        "mbr": "0",
        "panid": "1701000000101674150",
        "prodtype": "M6",
        "accountno": "5451000049954",
        "iban": null,
        "currencyno": 980,
        "expdate": "2707"
    },
    "userdata": "1877"
}'

Responses

🟢200Success
application/json
Body
virtualcard
object 
required
Дані віртуальної картки.
pan
string  | null 
optional
Номер картки. Якщо тег є присутнім і заповнений, то значення panmask ігноруються.
panmask
string  | null 
optional
Номер маскований:
NNNNNN******NNNN.
Якщо тег pan присутній і заповнений, то значення panmask і присутній і заповнений тег panmask, то значення panmask має відповідати значенню pan.
Якщо тег pan відсутній або не заповнений, виконується контроль:
Котроль Текст помилки
panmask!=null І довжина > 19 Поле має містити до 19 символів
mbr
integer  | null 
optional
Номер учасника картки. Завжди = 0.
Котроль Текст помилки
≠ 0 Поле має бути завжди 0
Якщо не заповнено, то за промовчанням = 0.
>= 0<= 0
panid
string  | null 
optional
Індекс картки (PANId).
Якщо тег pan є присутнім і заповнений, то значення panid має відповідати значенню pan.
Якщо тег pan відсутній або не заповнений, виконується контроль:
Котроль Текст помилки
panid=null І
довжина >20 Поле має містити до 20 символів.
<= 20 characters
expdate
string 
required
Дата закінчення терміну дії віртуальної картки YYMM
>= 4 characters<= 4 characters
accountno
string  | null 
required
Номер картрахунку.
currencyno
integer 
required
Цифровий код валюти рахунку віртуальної картки. Можливі значення довідника валют ISO.
iban
string  | null 
optional
iban картсчета
userdata
string  | null 
optional
Дані користувача.
Example
{
    "virtualcard": {
        "pan": "5596######5618",
        "panmask": "559600######5618",
        "mbr": "0",
        "panid": "1701000000101674150",
        "prodtype": "M6",
        "accountno": "5451000049954",
        "iban": null,
        "currencyno": 980,
        "expdate": "2407"
    },
    "userdata": "1877"
}
Modified at 2025-06-30 13:34:22
Previous
/Verify
Next
/cards/{panid}/baseparam/limits (112-Запит/зміна лімітів карти)
Built with