Validate PIN (API)
This document will go over how to validate PIN codes using our RESTFul api.
After calling the initiate method via our API and receiving pending_pin state in response, you are supposed to have user presented with a form where they can enter a numeric PIN code (5-6 digits). This is a POST request.
Example request
Parameters
Invalid PIN code response
Here is an example of an invalid PIN code response, this is your response if the user enters a random or incorrect PIN code, HTTP Status Code 417:
Please note: The PIN code is valid for a maximum of 10 attempts. After which the PIN will permanently expire and the process will have to be restarted.
Expired PIN code response
Here is an example of an expired PIN code's response, HTTP Status Code 440:
Successful response
If the user's PIN code is submitted successfully the following response can be expected, HTTP Status Code 200:
Last updated