/cards/setpin (137-Запит на встановлення PIN картки)

Developing

Cloud Mock

https://mock.apidog.com/m1/483896-0-default

PUT

/uapi-2.0/v1/cards/setpin

Maintainer:Not configured

Запит на встановлення PIN картки

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

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

string | null

optional

PIN. Якщо немає, то генерується автоматично.
Якщо вказано, то попередньо зашифроване ЗС значення pin.

<= 4000 characters

Example

{
    "card": {
        "mbr": "0",
        "panid": "1701000000101712943",
        "panmask": "559600######8902",
        "pin":***
    }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://mock.apidog.com/m1/483896-0-default/uapi-2.0/v1/cards/setpin' \
--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",
        "pin":***
    }
}'

Responses

🟢200Success

application/json

Body

code

string

required

Код завершення операції встановлення ПІН. Можливі значення:
-0 OK Запит на генерацію PIN прийнято та виконано
-1 Запит на генерацію PIN не прийнято. Технічна помилка, що виникла на етапі реєстрації запиту на генерацію
-2 Дані для генерації відсутні. Запит на генерацію PIN не прийнято.Запит на створення має некоректні дані.
-3 Публікат запиту на генерацію. Запит на генерацію PIN не прийнято.У черзі на генерацію вже є запит із переданою командою та PAN_ом
-4 Перевищено ліміт запитів на годину. Запит на генерацію PIN не прийнято.
-5 Перевищено добовий ліміт запитів Запит на генерацію PIN НЕ прийнято

message

string

required

Повідомлення PinGen.

<= 4000 characters

pinblock

string

required

Зашифровані на публічному ключі зовнішньої системи та закодовані в Base64 номер та PIN.
Приклад даних після розкодування та розшифрування:
SetPin{"pan":"1234123412341234","pin":"1111"}

<= 4000 characters

Example

{
    "code": "0",
    "message": "GOOD",
    "pinblock":***
}

Modified at 2025-07-08 12:22:22

/cards/getcarddataecom (138-Запит даних картки для eCommerce)

/cards/changepin (136-Замовлення зміни PIN картки)