---
title: "Unblock pin"
method: POST
path: "/pws/v2/pws_pin_unblock/"
tags: ["Pin-V2"]
---

# Unblock pin

`POST /pws/v2/pws_pin_unblock/`

This web service provides the ability to unblock a PIN for a token(card). PIN is blocked after 3 failed attempts

## Request body

- PinUnblockModel — This web service allows to unblock pin for a token(card). If tries pin web service is requested more then three times with invalid pin number, then the card is blocked.
  - `api_call_unique_identifier` string, required — Unique number that must be passed at each API request. Identifier to make each API request unique
  - `client_id` integer, required — Unique identifier for the client which Paymentology will provide at outset
  - `token` integer, required — Public token for the card
  - `user_id` string — User Id of the Customer who triggered the API request.
  - `remarks` string — Remarks for API request

## Response `200`

Successful Response

- PinUnblockResponse — This model contains response when we call get pin api
  - `header` PinUnblockHeader
    - `error_id` integer — error id
    - `error_desc` string — error message
  - `body` PinUnblockBody
    - `message` string — message

## Other responses

- `404` — Webservices does not exist
- `500` — Internal Server error

---

[API](https://skmtc.net/paymentology/apis/payapi-docs.md) · [All operations](https://skmtc.net/paymentology/apis/payapi-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paymentology/payapi-docs/revisions/a675891b0365/schema)