---
title: "Get pin V2"
method: POST
path: "/sc/v2/sc_get_pin/"
tags: ["Card PaySecure WS V2"]
---

# Get pin V2

`POST /sc/v2/sc_get_pin/`

<ul>
<li class="docBullet">This web service allows to get the PIN for a card/token.</li>
<li class="docBullet">Pass the public token and the API will retrieve back the AES encrypted pin.</li>
<li class="docBullet">Also pass the AES encrypted CVV2 for security purposes.</li>
</ul>

## Headers

- `Session-Id` string, required
- `x-api-key` string

## Request body

- PSGetPinModel — This web service allows to get pin for a card/token. Pass public token and api will retrieve back AES encrypted pin.
  - `client_id` integer, required — Unique identifier for the client which Paymentology will provide at outset
  - `token` integer, required — Public token for the card
  - `cvv2` string — AES Encrypted cvv2 of the card
  - `iv` string — 16 bits initialization vector (IV) used while encryption Required only when CVV2 is passed.

## Response `200`

Successful Response

- PaySecureGetPinResponse — This model contains the response details of get pin api
  - `header` PaySecureGetPinHeader
    - `error_id` integer — error id
    - `error_desc` string — error message
  - `body` PaySecureGetPinBody
    - `secret` string — Encrypted pin back
    - `iv` string — 16 bits initialization vector (IV)

## 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)