CAPTCHA 2.0 supports deployments outside the Chinese mainland. This guide covers how to integrate CAPTCHA 2.0 into a web client and its backend server for the Singapore region—the only overseas region currently supported.
The client-side region parameter and the server-side endpoint must point to the same region. A mismatch causes all verification requests to fail.
How it works
The integration has three parts:
Client-side: Load CAPTCHA 2.0 on your web page with
regionset tosgpandlanguageset to your target locale.Server-side: Call the CAPTCHA verification API from your backend using the Singapore endpoint (
captcha.ap-southeast-1.aliyuncs.com).Monitor: View real-time verification statistics on the Overview page in the console.
Prerequisites
Before you begin, ensure that you have:
Created a verification scenario with Client Type set to Web
Step 1: Integrate CAPTCHA 2.0 into your web client
Follow the web and HTML5 client integration guide (V3 architecture) to add the CAPTCHA 2.0 initialization code to your business page.
When initializing CAPTCHA 2.0 for overseas access, set the following parameters:
| Parameter | Required | Default | Value for overseas access | Description |
|---|---|---|---|---|
region | Yes | cn | sgp | The deployment region. Set to sgp to route traffic through Singapore. If omitted, requests route to the Chinese mainland. Other regions outside the Chinese mainland will be supported soon. |
language | No | cn | Your target language code | The display language. Defaults to Simplified Chinese (cn). CAPTCHA 2.0 supports 17 languages. See Configure custom text and multi-language settings. |
For a full parameter reference, see Parameter description.
Step 2: Integrate CAPTCHA 2.0 into your backend server
Follow the server-side integration guide to call the CAPTCHA verification API from your backend.
Set the following parameter when configuring your server-side integration:
| Parameter | Required | Value | Description |
|---|---|---|---|
endpoint | Yes | captcha.ap-southeast-1.aliyuncs.com | The Singapore region endpoint. Must match the region value (sgp) set in Step 1. Using a different endpoint causes all verification requests to return an error. |
Step 3: View verification statistics
After integration is complete, open the Overview page in the CAPTCHA 2.0 console to view verification statistics. The page shows real-time protection statistics so you can monitor the effectiveness of your integration.
What's next
Configure custom text and multi-language settings — customize the CAPTCHA UI for your users' language
Server-side integration — full API reference for backend verification