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/issuacephysicalcard (141-Запит видачі фізичної картки)
        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/issuacephysicalcard (141-Запит видачі фізичної картки)

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/issuacephysicalcard
Maintainer:Not configured
Запит видачі фізичної картки

Request

Header Params
x-uws-systemid
string 
optional
Example:
TESTSS
x-uws-requestid
string 
optional
Example:
0512231523
x-uws-date
string 
optional
Example:
2020-03-25T00:00:00.000+0200
x-uws-PSID
string 
optional
Example:
B101
x-uws-FIID
string 
optional
Example:
F101
Accept
string 
optional
Example:
application/xml
Body Params application/json
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
Дані користувача.
card
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.
Example
{
    "authholder": {
        "authmobphone": "37379979991",
        "authсontractct": "AAA"
    },
    "card": {
        "currencyno": 980,
        "panid": "1701000000101713040",
        "panmask": "559600######4354",
        "prodtype": "M5"
    },
    "userdata": "1882"
}

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/issuacephysicalcard' \
--header 'x-uws-systemid: TESTSS' \
--header 'x-uws-requestid: 0512231523' \
--header 'x-uws-date: 2020-03-25T00:00:00.000+0200' \
--header 'x-uws-PSID: B101' \
--header 'x-uws-FIID: F101' \
--header 'Accept: application/xml' \
--header 'Content-Type: application/json' \
--data-raw '{
    "authholder": {
        "authmobphone": "37379979991",
        "authсontractct": "AAA"
    },
    "card": {
        "currencyno": 980,
        "panid": "1701000000101713040",
        "panmask": "559600######4354",
        "prodtype": "M5"
    },
    "userdata": "1882"
}'

Responses

🟢200Success
application/json
Body
card
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
Дані користувача.
Тег є присутнім, якщо був вказаний і заповнений у запиті issuacephysicalcardReq.
Example
{
    "card": {
        "pan": null,
        "panmask": "559600######4354",
        "mbr": "0",
        "panid": "1701000000101713040",
        "prodtype": "M5",
        "accountno": "5451404249901",
        "iban": null,
        "currencyno": 980,
        "expdate": "2711"
    },
    "userdata": "1882"
}
Modified at 2025-07-01 09:33:29
Previous
/cards/issuacevirtualcard (140-Запит видачі віртуальної картки)
Next
/cards/{panid}/baseparam/limits (112-Запит/зміна лімітів карти)
Built with