Reset PIN counter

POST

https://api.freedompay.kz/v5/card-api/card/reset_counter_pin

This method is designed to reset the incorrect PIN entry attempt counter on a payment card. It is required when a card is temporarily blocked due to exceeding the allowed number of unsuccessful PIN entry attempts.
Upon successful execution of the request, the incorrect entry counter is reset, allowing the cardholder to use the PIN again for transactions.
This method does not change the PIN itself but only removes the temporary block caused by incorrect PIN entries.

Request

Body Params application/json

request_id

string

required

Unique request ID in the partner system (UUID).

card_id

string

required

Identifier of the card in Freedom Processing.

Example

{
  "request_id": "string",
  "card_id": "string"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.freedompay.kz/v5/card-api/card/reset_counter_pin' \
--header 'Content-Type: application/json' \
--data-raw '{
    "request_id": "string",
    "card_id": "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"
}

Set PIN

Close card