CAPTCHA Validation
Some tax authorities require CATCHA validation before business tax number validation.
You can configure CAPTCHA validation using either the Checkout Form or the dedicated API.
- Checkout Form—The service displays a CAPTCHA image to the user and, when solved, automatically sends the user's information 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 tax number validation with the tax authority.
Note:Some integrations may not suit these options, especially when you don't 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 service provider. 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 service cannot validate the number, the system returns buyer_tax_number_valid as null.