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/changepin (136-Замовлення зміни PIN картки)

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/changepin
Maintainer:Not configured
Замовлення зміни PIN картки та її надсилання SMS.

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
panmask
string  | null 
required
Номер маскований:
NNNNNN******NNNN.
<= 19 characters
panid
string  | null 
required
Індекс картки (PANId).
Match pattern:
20
mobphone
string 
required
Номер мобільного телефону клієнта власника картки. Значення без знака "+". Приклад: 380501234567
<= 14 characters
Match pattern:
[0-9]{14}
Example
{
    "mobphone": "380504164080",
    "panid": "0501000000101652250",
    "panmask": "410383######0466"
}

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/changepin' \
--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 '{
    "mobphone": "380504164080",
    "panid": "0501000000101652250",
    "panmask": "410383######0466"
}'

Responses

🟢200Success
application/json
Body
create_date
string 
required
Дата та час відправки до ПЦ запиту на виконання операції читання\зміни статусу у форматі
yyyy-MM-ddTHH:mm:ss.SSSZ
Наприклад, 2012-07-21T16:25:30.39Z.
update_date
string  | null 
optional
Дата та час отримання від ПЦ відповіді на виконання операції зміни статусу у форматі yyyy-MM-ddTHH:mm:ss.SSSZ
Наприклад, 2012-07-21T16:25:30.39Z.
card
object 
required
Дані карти
fiid
string 
required
Ідентифікатор фінансового інституту (FIID), у якому зареєстровано карту
>= 4 characters<= 4 characters
pan
string 
required
Номер картки (Маскований номер)
NNNNNN****** NNNN
<= 20 characters
panid
string 
required
Індекс картки (PANId) У повідомленнях відповіді завжди заповнено.
<= 20 characters
code
integer 
required
Код завершення операції зміни ПІН. Можливі значення:
-0 "OK"
-1 "Запит на зміну PIN не прийнято"
-2 "Дані для генерації відсутні"
-3 "Дублікат запиту на генерацію"
-4 "Перевищений ліміт запитів на годину"
-5 "Перевищено добовий ліміт запитів"
requestid
string 
required
Ідентифікатор запиту зовнішньої системи.
<= 255 characters
message
string 
required
Відповідно до значення в code
-0 "OK"
-1 "Запит на зміну PIN не прийнято"
-2 "Дані для генерації відсутні"
-3 "Дублікат запиту на генерацію"
-4 "Перевищений ліміт запитів на годину"
-5 "Перевищено добовий ліміт запитів"
<= 256 characters
Example
{
    "requestid": "MTczMDIzMDczODE4Mw",
    "code": 0,
    "message": "OK",
    "create_date": "2024-10-29T21:38:58.857+0200",
    "update_date": "2024-10-29T21:38:59.261+0200",
    "card": {
        "panmask": "410383######0466",
        "panId": "0501000000101652250",
        "fiid": "FNS1"
    }
}
Modified at 2025-07-08 13:43:06
Previous
/cards/setpin (137-Запит на встановлення PIN картки)
Next
/cards/gettransactions (122-Запит історії транзакцій)
Built with