Captcha Document

Introduction

Turant Voice Captcha is yet another form of captcha, where we use sound to validate. Sound samples are taken and processed giving the desired output/validation required.

To get the hostname, you can see the section Merchant Details.

Integration

To integrate the voice captcha, you have to add the scripts.

You have to add a div with its id as voiceButtonContainer.The Turant Voice Captcha button automatically appends there. If you want to change the style of the button, then you need to change the css for voiceButton, or you can pass your own button id.

integer

Unique identifier of the merchant

string

Name of the merchant

string

Name of the service want to be used. It can have two values : fixed_digit or free_speech

string

Random alphanumeric value

NOTE: You can change the button text, by passing the desired value as the first parameter of createButton function. You can change the second parameter voiceButton also can change the fourth parameter voiceButtonContainer, just mention the same id name.


                                            <div id="voiceButtonContainer"></div>
                                        

<script type="text/javascript" src="https://turantsaas.co.in/assets/voice/voiceCaptcha.js" defer></script>
                                        

<script>
                                                document.addEventListener('DOMContentLoaded', (event) => {

                                                  const voiceCaptcha = new modules.voiceCaptcha();
                                                  const options = {
                                                      merchant_id: {id},
                                                      merchant_name: {name},
                                                      service_name:{service_name},
                                                      unique_session_id : {session_id},
                                                  };

                                                  voiceCaptcha.createButton('Login with Turant', 'voiceButton', options, "voiceButtonContainer");
                                              });
                                              </script>

                                        

Register Voice Sample

For registration, at first we have to fill the unique Id, for this unique Id the voice samples will be taken.

We will take 2 rounds of voice samples for processing.

We have to record our first audio sample by speaking the captcha displayed and after that second audio sample in the same manner.

After both the samples are taken, it will check both the captchas are correctly spoken or not.

If the captchas are correctly spoken and has correct voice recognition, it will be the case of successful registration. If the captchas are not same, or by two different speakers, or due to any other reason, it will fail the registration process. You have to try again the whole process one more time.

{{ App\Models\Document::CAPTCHA_REG_SUCCESS_RESPONSE }}
{{ App\Models\Document::CAPTCHA_REG_FAILURE_RESPONSE }}

Verify Voice Sample

For verification, at first we have to fill the unique Id, for this key the voice samples will be taken.

Here, we will only take one round of voice sample for processing.

We have to record our first audio sample by speaking the captcha displayed.

After the samples are taken, it will check whether the captcha is correctly spoken or not.

If the captcha are correctly spoken it will be the case of successful verification. In case of failure, you have to try again for verification.

{{ App\Models\Document::CAPTCHA_VER_SUCCESS_RESPONSE }}
{{ App\Models\Document::CAPTCHA_VER_FAILURE_RESPONSE }}

Merchant Details

To find the details of the merchant, you can go back to the dashboard and go to the "Credentials" section.

There you can see Merchant details with the secret key and the hostname.You can copy the secret key by clicking the clipboard icon.

Secret Key Generation

To generate the new secret key, you have to go back to the dashboard, there you can go to "Secret Key" section and can generate a new key by clicking the "Generate Key" button. You can copy the key by clicking the clipboard icon.

NOTE: After generating a new key, the old key will no longer be a valid key.

@include('_partials.footer')