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/status (111-Запит/зміна статусу картки)
        PUT
      • /cards/getcarddataecom (138-Запит даних картки для eCommerce)
        PUT
      • /cards/setpin (137-Запит на встановлення PIN картки)
        PUT
      • /cards/changepin (136-Замовлення зміни PIN картки)
        PUT
      • /cards/gettransactions (122-Запит історії транзакцій)
        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/getcarddataecom (138-Запит даних картки для eCommerce)

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/getcarddataecom
Maintainer:Not configured
Запит даних картки для eCommerce (відображення повних даних картки: pan, expdate, cvv2cvc2.)

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
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
Example
{
    "card": {
        "mbr": "0",
        "panid": "1701000000101712943",
        "panmask": "559600######8902"
    }
}

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/getcarddataecom' \
--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 '{
    "card": {
        "mbr": "0",
        "panid": "1701000000101712943",
        "panmask": "559600######8902"
    }
}'

Responses

🟢200Success
application/json
Body
code
string 
required
од завершення операції створення CVV2.
code = '0' - Запит даних картки для eCommerce успішно виконано
code != '0' - Запит даних картки для eCommerce НЕ виконаний.
message
string 
required
Повідомлення PinGen
<= 4000 characters
ecomblock
string 
required
Зашифрований PAN, ExpDate та CVV2
Тег є і заповнений якщо соde = 0.
Рядок у кодуванні Base64.
Розшифровується приватним ключем UAPI-клієнта.
Після розшифровки повинен бути отриманий рядок даних у форматі JSON.
<= 4000 characters
Example
{
    "code": "0",
    "message": "GOOD",
    "ecomblock": "MJoADCaW5pYxpLnUS2004/JS8myAIhSVhSTYICqPbxLKuEdZ4m0T7uq6xnpkIE4JL3cipUrHW5+Gg+HDg4FEuTvTq5Kx2NZ3IHSvXF+MSWCJrzoMP05pJ0AlPvfVdWNAHOSyaYyphI3yZ028hOdCI0WPeyVByMA3LtfhLyOw/bfXr8rFuC/lV/Ggbtmrb5Akit7mVcL5gZy+DSbs50tyxz0ePmN/KpdE59entpZk+16+o77ButeWgjWNSLZ+RFUNmFvOde1755Pff/V+cx1LN9mIkmKd1so+haW52ydMXPyGV6kINdEvR9FpLtcxF81IptSrhpDwfwpIoSchh4ChoQ=="
}
Modified at 2025-07-08 09:53:57
Previous
/cards/{panid}/baseparam/status (111-Запит/зміна статусу картки)
Next
/cards/setpin (137-Запит на встановлення PIN картки)
Built with