diff --git a/backend/services/identity-service/.env.example b/backend/services/identity-service/.env.example
index 9291d32c..7707d3cc 100644
--- a/backend/services/identity-service/.env.example
+++ b/backend/services/identity-service/.env.example
@@ -79,6 +79,29 @@ ALIYUN_SMS_ENDPOINT="dysmsapi.aliyuncs.com"
 # true: 真实发送短信
 SMS_ENABLED="false"
 
+# =============================================================================
+# KYC Service - Aliyun 实人认证 (阿里云金融级实人认证)
+# =============================================================================
+# 产品文档: https://help.aliyun.com/product/60032.html
+# 控制台: https://yundun.console.aliyun.com/?p=cloudauth
+#
+# 支持三层认证:
+#   - 层级1: 实名认证 (二要素验证: 姓名+身份证号)
+#   - 层级2: 实人认证 (人脸活体检测)
+#   - 层级3: KYC (证件照OCR识别验证)
+
+# 是否启用阿里云 KYC 服务 (开发环境建议设为 false)
+# false: 模拟模式，只验证身份证格式和校验码
+# true: 真实调用阿里云实人认证 API
+ALIYUN_KYC_ENABLED="false"
+
+# 阿里云实人认证 API 端点 (默认无需修改)
+ALIYUN_KYC_ENDPOINT="cloudauth.aliyuncs.com"
+
+# 阿里云实人认证场景 ID (人脸活体检测需要)
+# 在阿里云实人认证控制台创建场景后获取
+ALIYUN_KYC_SCENE_ID=""
+
 # =============================================================================
 # Wallet Encryption
 # =============================================================================