BILLmanager 5 Documentation

Integration with a website with reCAPTCHA

ISPSystem

If you have set up reCAPCTHA, you cannot order services via API BILLmanager. Accessing the billing system via API will give the error that reCAPTHA validation failed.  To integrate BILLmanager with a website with reCAPTCHA, add a script into the website header (inside the <head> tag) and use the same keys as for the billing system configuration. 

To get the reCAPTCHA keys for your domain, please go to the service web-page.

How to add reCAPTCHA to your website


  1. Add the following script into the <head> tags on every page with the BILLmanager sign-up form:  

    The reCAPTHCA script
    <!-- Google reCAPTCHA-->
    <script async src='https://www.google.com/recaptcha/api.js'></script>
  2. Add the reCAPTCHA field on the BILLmanager sign-up form on the website: 

    The reCAPTHCA field
    <div class='auth-captcha'><div class='g-recaptcha' data-sitekey='reCAPTCHA_site_key'></div>

    reCAPTCHA_site_key is your public key for connecting to reCAPTHCA API.

Website registration script algorithm 


  1. Get the sign-up form from BILLmanager.
  2. Get the recaptcha_field and recapthca_type parameters from the form model. 
  3. If the recaptcha_field parameter is present get the string generated by reCAPTCHA.

    The recaptcha_field parameter is not present if reCAPTCHA is disabled in BILLmanager.

  4. Check the parameters in the forms are valid. 
  5. Write the string you have received on Step 3 into the g-recapthca-response parameter. 
  6. Send the sign-up form model with the g-recaptcha-response.

The same algorithm is used for the login form. On the last step, you need to send a user login and password with the g-recaptcha-response parameter.

For more information about API-requests to BILLmanager for working with a website please refer to the article Integration with website

Thank you for your feedback!
Was the article useful?
Tell us why not:

it does not match the title

it was hard to understand

I didn't find the answer

recommendations from the article did not help

other

Tell us what you didn't like in the article: