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 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 POST 'https://api.freedompay.kz/v5/card-api/card/reset_counter_pin' \
--header'Content-Type: application/json' \
--data-raw''
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.
dt
string
required
Date and time of the request (format: RFC 3339, YYYY-MM-DDThh:mm:ss+hh:mm).
