Set PIN

POST

https://api.freedompay.kg/v5/card-api/card/set_pin

Request

Body Params application/json

card_id

string

required

Identifier of the card in Freedom Processing.

string

optional

Encrypted PIN code. The AES 256 algorithm is used for encryption. If this parameter is not provided, the PIN code will be generated by Freedom Processing.

Example

{
    "card_id": "string",
    "pin": "string"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.freedompay.kg/v5/card-api/card/set_pin' \
--header 'Content-Type: application/json' \
--data-raw '{
    "card_id": "string",
    "pin": "string"
}'

Responses

🟢200Success

application/json

Body

status

string

required

Status of the request. Possible values:

ok: Request completed successfully.

error: Request completed with an error.

request_status

string

required

Execution status of the request. Refer to the documentation.

string

required

Date and time of the request (format: RFC 3339, YYYY-MM-DDThh:mm:ss+hh:mm).

Example

{
    "status": "string",
    "request_status": "string",
    "dt": "string"
}

Modified at 2025-02-03 10:08:06

Unblock

Reset PIN counter