---
title: "Generate Time Based Secret"
method: POST
path: "/pws/pws_generate_time_based_secret/"
tags: ["Card V2"]
---

# Generate Time Based Secret

`POST /pws/pws_generate_time_based_secret/`

This web service generates time based secret

## Request body

- GenerateTimeBasedSecretModel — This api is used to get card status
  - `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
  - `timeStep` integer — Default: 60 - Window during which TOTP is valid in seconds
  - `cardSecretLength` integer — Default: 8 - Length of card secret 1-8
  - `algorithm` string — <p>Default: HmacSHA512 - Hashing algorithm used for TOTP generation :</p> <ul> <li class="docBullet">HmacSHA1</li> <li class="docBullet">HmacSHA256</li> <li class="docBullet">HmacSHA512</li> </ul>

## Response `200`

Successful Response

- GenerateTimeBasedSecretResponseModel
  - `header` Header
    - `error_desc` string, required — Error Description
    - `error_id` integer, required — Error Id
  - `body` GenerateTimeBasedSecretResponseBody
    - `secret` string — generated TOTP

## 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/versions/a675891b0365/schema)