Skip to main content

Verify PIN

POST /pin/verify

Verify a user's PIN, notice the iterator of the pin will increment also.

Endpoint URL

Authentication and options

LimitationNo limitation


"pin_base64": "Encrypted PIN"
"timestamp": 1234,

How to generate TIP Pin

fmt.Sprintf("%s%032d", "TIP:VERIFY:", timestamp)

timestamp is UnixNano in int64

Example request

curl -i -X POST -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" --data PAYLOAD

The API returns an empty json on success.

Error 20119 Debugging

  • If you forget your PIN, there is no way to retrieve it. It is recommended to try 5 times a day and write down the tried code on paper.
  • It might be due to the misuse of iterator, which should be incremental. Generally, it is recommended to use the current system Nano time, or you can set a number by yourself, and increment it with each call.
  • The encrypted PIN is wrong, such as wrong format, wrong time, etc. It may be a problem of the SDK itself. It is recommended to contact the SDK developer for help.

Pay attention to the extra field in the returned error message. The error count will only increase if the PIN is incorrect, and the wrong iterator or wrong encrypted PIN will not cause the PIN to be locked.