CAPTCHA Validation

You can configure CAPTCHA validation using either the Checkout Form or the dedicated API.

• Checkout Form—The service provides a CAPTCHA image to the user and, when solved, automatically sends the user's business tax identification number to the tax authority.
• API—The service provides a Base64-encoded CAPTCHA image for you to present to the user. When solved by the user, the solution is returned to the service and used to facilitate validation of the business tax identification number with the tax authority.

📘

Note

These options may not be suitable for some integrations, especially when you do not want to present a CAPTCHA to users. If this applies to your use case, visit the Support section of Vertex Community or contact Customer Support.

The service returns true or false as the validation result, where true indicates a successful validation.

The validation service is facilitated by an external validation service. If the external validation service fails, the service returns a warning message, for example:

[{"type": "b2b-error", "message": "...any other error..."}], ["egr.by service is not available"]

When the external validation service cannot validate the tax number, the system returns buyer_tax_number_valid as null.