Proxy Mail QA 维护一份注册表单常见字段的目录:每个字段在九种语言中的名称,以及它的值从哪里来。对于证件号和税号,目录列出了每个国家/地区的格式,并且只在假值绝不可能属于真人时才提供假值。
- 智能体:使用MCP server上的
list_form_sections 和 get_form_section。
- 测试:使用 npm 包中的
qa.listFormSections() 和 qa.getFormSection()、Python 辅助库中的 list_form_sections() 和 get_form_section(),或REST API上的 GET /v1/form-sections。
get_form_section 给出某个分区在一个国家的格式,只在某个值绝不可能属于真实的人时才给出该值,并给出 accept 和 reject 变体供你在字段中尝试。传入 address 后,该测试账号的值保持不变。
- 假值绝不会与真人重合。它要么是公开的测试值,要么是签发机构从不签发的格式。Proxy Mail QA 绝不会在正在使用的号段里生成校验位正确的随机号码:那可能是某个人的号码。
- 我们绝不接收证件号来做校验。要检查一个值是否符合格式,使用 npm 包中的
followsFormat 或 Python 辅助库中的 follows_format。两者都在你的机器上运行。
- 符合格式不等于有效。只有签发机构知道某个号码是否发给过别人,所以这里的值能通过格式检查,但查不到登记记录。
- 不提供证件图片。身份核验服务商会发布自己的样例文件。
| 等级 |
你会得到什么 |
| A |
公开的测试值,来自签发机构或服务商的文档。每个账号得到的都相同,所以拒绝重复使用证件号的网站会拒绝第二个账号。 |
| B |
一种从不签发的格式,每个测试账号一个。严格按签发机构规则检查的表单可能会拒绝它。 |
| 仅规则 |
只有格式规则:提供模式和应被拒绝的变体,不提供值,因为任何格式正确的号码都可能属于某个人。 |
| 不提供 |
不提供:生成这种号码属于违法行为。 |
| 分区 |
Id |
值 |
| 名 |
name.given |
测试账号自己的。角色的名。get_name_variants 里有一些难处理的名字可以试试。 |
| 姓 |
name.family |
测试账号自己的。角色的姓。西班牙语和葡萄牙语表单常常要求填两个姓。 |
| 全名 |
name.full |
测试账号自己的。名和姓,中间加空格。中文、日文和韩文表单把姓放在前面。 |
| 姓名读音(furigana) |
name.furigana |
测试账号自己的。日文姓名的读法:国家设为日本的账号使用角色的读音,并按字段要求的假名和宽度填写(フリガナ、ふりがな、半角カナ)。其他名字没有读音,这个字段由你来填。 |
| 单名 |
name.single |
表单的选项之一。有些人只有一个名字。get_name_variants 用来判断是否应接受空的姓。 |
| 用户名 |
username |
测试账号自己的。角色的用户名:小写字母、数字和下划线,6 到 20 个字符。 |
| 邮箱地址 |
email |
测试账号自己的。就是测试地址本身,所以邮件会送到 Proxy Mail QA。 |
| 密码 |
password |
测试账号自己的。账号保存的密码,按字段自己的规则生成。get_password_variants 里有一些应该被拒绝的密码。 |
| 出生日期 |
birth_date |
测试账号自己的。角色的出生日期,处于项目要求的年龄段内,按字段显示的方式书写,字段要求时也包括日本年号日期(平成2年1月22日)或伊斯兰历日期。 |
| 性别 |
gender |
表单的选项之一。最好设为选填,提供两个以上的选项和“不愿透露”。自定义字段会选择表单的某个选项。 |
| 电话号码 |
phone |
为字段编造的。专门留给虚构作品的号码,仅限英国、澳大利亚、美国和加拿大(Ofcom 的影视剧号码、ACMA 的列表、555-01xx);其他国家/地区使用现成的“电话号码”中团队为该国准备的测试号码,或者由你来填,因为短信可能会发给真人。 |
| 邮寄地址 |
address |
为字段编造的。开启填写未知字段时,提供一组相互匹配且符合该国格式的城市、地区和邮编,以及一条编造的街道。日文和中文表单会按它们自己的顺序和文字填写。 |
| 国家或地区 |
country |
测试账号自己的。角色的国家,也就是请求 create_address 时指定的国家。 |
| 国籍 |
nationality |
测试账号自己的。角色的国家,与“国家”相同。 |
| 家长的邮箱地址 |
guardian.email |
由你来填。由你来填:用 create_address 再创建一个测试地址并填到这里,这样发给家长的邮件也会送到 Proxy Mail QA。 |
| 分区 |
Id |
值 |
| 接受条款 |
consent.terms |
表单的选项之一。测试会勾选的复选框。自定义字段可以每次都勾选它。 |
| 营销邮件 |
consent.marketing |
表单的选项之一。除非项目另有设置,否则保持页面原样。营销模式会记录注册时的状态。 |
| 你是怎么知道我们的? |
referral_source |
表单的选项之一。表单自身的某个选项,由自定义字段或猜测选出。 |
| 语言 |
language |
表单的选项之一。表单自身的某个选项。 |
| 分区 |
Id |
值 |
| 公司名称 |
business.company |
测试账号自己的。角色编造的公司(Miller Labs)。可以在“项目设置”中关闭。 |
| 公司网站 |
business.website |
为字段编造的。example.com 下的地址,该域名专门留作示例,绝不属于真实公司。 |
| 职位或角色 |
business.role |
表单的选项之一。表单自身的某个选项,或自定义字段的值。 |
| 团队或公司规模 |
business.team_size |
表单的选项之一。表单自身的某个选项,或自定义字段的值。 |
| 业务类型 |
business.type |
表单的选项之一。字段的某个选项,同一个账号每次都相同。 |
| 银行账号 |
bank.account |
由你来填。由你来填:编造的账号可能属于某个人。如果使用支付或身份服务商的测试模式,KYC 沙盒模式会提供该服务商自己的测试值。 |
| 增值税号 |
business.vat |
按国家/地区,见下文。各国家/地区的格式规则。增值税核验(VIES、HMRC)会拒绝所有假值,所以在测试中请 mock 它们。 |
| 企业税号 |
business.tax |
按国家/地区,见下文。各国家/地区的企业税号。 |
| 公司注册号 |
business.company_number |
由你来填。由你来填:公司登记信息是公开的,所以编造的号码可能属于真实公司。 |
| 分区 |
Id |
值 |
| 身份证号 |
id.national |
按国家列出,见下文。一个国家的主要个人号码。当账号所在国家有安全值时,对应的预设自定义字段会填入该值。 |
| 个人税号 |
id.tax |
按国家/地区,见下文。个人税号与身份证号不同时使用。 |
| 护照号码 |
id.passport |
按国家列出,见下文。没有任何机构预留一段护照号码,因此在真实国家下编造的号码可能属于某人。默认使用 Utopia(UTO)护照,这是 ICAO 的虚构国家,并附带机读行;对于真实国家,如有公开的样本或从未签发的格式则使用它,否则只给出格式规则,或暂无格式。 |
| 证件有效期 |
id.document_expiry |
由你来填。由你来填:几年后的任意日期即可。Utopia 护照的机读行自带有效期。 |
| 驾照号码 |
id.driving_licence |
由你来填。由你来填:格式因州和国家而异,很多是根据持有人的姓名和出生日期生成的。 |
| 国家/地区 |
格式 |
类型 |
等级 |
示例值 |
说明 |
| GB |
增值税登记号,加权 mod-97 校验 |
GB NNN NNNN NN |
仅格式规则 |
无 |
只有格式规则:编造的号码可能属于真实的个体经营者。HMRC 的增值税核验会拒绝所有假值,所以在测试中请 mock 它。 |
| EU |
欧盟增值税号 |
CC and 2 to 13 letters or digits |
仅格式规则 |
无 |
两个字母的前缀之后,每个国家有自己的格式。VIES 会拒绝所有假值,所以在测试中请 mock 这项核验,不要真的调用它。 |
| 国家/地区 |
格式 |
类型 |
等级 |
示例值 |
说明 |
| US |
雇主识别号(EIN) |
NN-NNNNNNN |
从不签发的格式 |
07-6337215(每个账号一个) |
IRS 不分配前缀 07、08 和 09,所以这些号码不可能属于真实雇主。检查前缀列表的表单会拒绝它们。 |
| BR |
CNPJ,基于字母和数字计算两位 mod-11 校验位 |
XX.XXX.XXX/XXXX-NN |
公开的测试值 |
12.ABC.345/01DE-35 |
Receita Federal 官方给出的新版字母数字混合 CNPJ 示例,所有账号共用。只接受数字的表单会拒绝它,在 2026 年 7 月的变更生效前了解这一点很有用。 |
| AU |
澳大利亚商业号码(ABN),加权 mod-89 校验 |
NN NNN NNN NNN |
仅格式规则 |
无 |
只有格式规则。ABN 属于企业且是公开的,但编造的号码仍可能属于真实的个体经营者。 |
| 国家/地区 |
格式 |
类型 |
等级 |
示例值 |
说明 |
| GB |
国民保险号 |
AA NN NN NN A |
从不签发的格式 |
GB 64 72 70 C(每个账号一个) |
HMRC 从不签发前缀 GB、NK 和 ZZ,所以这些号码不可能属于任何人。检查前缀列表的表单会拒绝它们。 |
| US |
社会安全号 |
NNN-NN-NNNN |
从不签发的格式 |
666-10-8219(每个账号一个) |
社会保障局从不分配区号 666,所以这些号码不可能属于任何人。检查区号的表单会拒绝它们。绝不使用 078-05-1120:它曾印在钱包插卡上,后来已作废。 |
| CN |
居民身份证号码,ISO 7064 MOD 11-2 校验码 |
NNNNNN YYYYMMDD NNN C |
公开的测试值 |
11010519491231002X |
标准自己的示例,或使用不存在的地区代码(99…)、角色的出生日期和正确校验码的号码。检查地区代码的表单会拒绝第二种。 |
| IN |
Aadhaar 号码,Verhoeff 校验位 |
NNNN NNNN NNNN |
公开的测试值 |
9999 4105 7058 |
UIDAI 的预发布环境测试号码,或以 0 或 1 开头(从不签发)且 Verhoeff 校验位正确的号码。拒绝以 0 或 1 开头的表单会拒绝第二种。Aadhaar 法禁止展示真实号码。 |
| JP |
My Number(個人番号),mod-11 校验位 |
NNNN NNNN NNNN |
仅格式规则 |
无 |
只有格式规则和应被拒绝的变体。My Number 法禁止收集或保存他人的号码,而任何格式正确的号码都可能属于某个人。 |
| KR |
居民登记号(주민등록번호) |
900101-1****** |
不提供 |
无 |
不提供:韩国《居民登记法》规定,分发生成虚假号码的程序属于违法行为。掩码样例 900101-1****** 展示了格式。 |
| PK |
CNIC 号码 |
NNNNN-NNNNNNN-N |
公开的测试值 |
00000-0000000-0 |
只提供格式和全零占位符。NADRA 没有公开校验位,也没有样本,所以任何其他格式正确的号码都可能属于某个人。 |
| BR |
CPF,两位 mod-11 校验位 |
NNN.NNN.NNN-NN |
公开的测试值 |
123.456.789-09 |
只提供公开的测试值,所有账号共用:CPF 没有未分配的号段,所以编造的号码可能属于真人。 |
| 国家/地区 |
格式 |
类型 |
等级 |
示例值 |
说明 |
| IN |
PAN |
AAAAANNNNA |
仅格式规则 |
无 |
只有格式规则:最后一个字母的校验方式不公开,所以任何格式正确的 PAN 都可能属于某个人。需要 PAN 的测试可以使用 KYC 沙盒值(Setu、Cashfree)。 |
不指定国家时,get_form_section 会给出 Utopia 的护照(UTO)。Utopia 是 ICAO 在自己示例中使用的虚构国家,所以没有任何真实护照使用这个号码。它附带有效期,以及照片页底部的两行机读码(MRZ),校验位正确,使用测试账号自己的姓名和出生日期(传入 address)。其他国家/地区的值如果是护照,也会附带机读行。
| 国家/地区 |
格式 |
类型 |
等级 |
示例值 |
说明 |
| UTO |
Utopia(UTO)护照,ICAO 的虚构国家 |
ANNNNNNNN |
从不签发的格式 |
U85226852(每个账号一个),或样本 L898902C3(ICAO 9303 的护照样本,持有人为 ERIKSSON ANNA MARIA) |
默认值。Utopia 是 ICAO 在自己示例中使用的国家,所以没有任何真实护照使用这个号码,而且其机读行能通过校验。大多数国籍和签发国列表不提供 Utopia:如果表单需要真实国家,请使用荷兰(公开样本),或美国、德国(从不签发的格式)。 |
| NL |
Paspoortnummer |
AAXXXXXXN |
公开的测试值 |
SPECI2024 |
RVIG 2024 年护照手册中的样本,所有账号共用:拒绝重复使用号码的网站会拒绝第二个账号。号码中从不出现字母 O,所以 0 和 O 不会混淆。 |
| DE |
Reisepassnummer |
XXXXXXXXX |
从不签发的格式 |
A0TP3V9TJ(每个账号一个),或样本 T22000129(德国身份证样本,持有人为 Erika Mustermann,在欧盟内可作为旅行证件) |
德国证件号只使用数字和辅音字母,自 2021 年 11 月起不再使用 0,所以以元音字母和 0 开头的号码从未签发过。检查字符的表单会拒绝它。身份证样本由所有账号共用。 |
| US |
护照号码 |
ANNNNNNNN or NNNNNNNNN |
从不签发的格式 |
072535120(每个账号一个) |
以 0 开头的九位数字:没有在用的护照是这种号码,因为美国海关与边境保护局只接受 400000000 及以上的纯数字号码。航空公司和边境检查会拒绝它,遵循其规则的表单也会拒绝。 |
| SE |
Pass- eller id-kortsnummer |
NNNNNNNN |
公开的测试值 |
59000002 |
瑞典身份证样本,在欧盟内可作为旅行证件,所有账号共用。 |
| GB |
护照号码 |
NNNNNNNNN |
仅格式规则 |
无 |
只有格式规则:编造的号码可能是某个人的护照号。需要值时请使用 Utopia(默认)或公开样本。 |
| CA |
护照号码 |
AANNNNNN |
仅格式规则 |
无 |
只有格式规则:编造的号码可能是某个人的护照号。需要值时请使用 Utopia(默认)或公开样本。这条规则来自二手资料:请用你自己的资料核对。 |
| AU |
护照号码 |
A(A)NNNNNNN |
仅格式规则 |
无 |
只有格式规则:编造的号码可能是某个人的护照号。需要值时请使用 Utopia(默认)或公开样本。 |
| IN |
护照号码 |
ANNNNNNN |
仅格式规则 |
无 |
只有格式规则:编造的号码可能是某个人的护照号。需要值时请使用 Utopia(默认)或公开样本。这条规则来自二手资料:请用你自己的资料核对。 |
| PK |
护照号码 |
AANNNNNNN |
仅格式规则 |
无 |
只有格式规则:编造的号码可能是某个人的护照号。需要值时请使用 Utopia(默认)或公开样本。这条规则来自二手资料:请用你自己的资料核对。 |
| CN |
护照号码 |
AXNNNNNNN |
仅格式规则 |
无 |
只有格式规则:编造的号码可能是某个人的护照号。需要值时请使用 Utopia(默认)或公开样本。 |
| JP |
护照号码(旅券番号) |
AANNNNNNN |
仅格式规则 |
无 |
只有格式规则:编造的号码可能是某个人的护照号。需要值时请使用 Utopia(默认)或公开样本。 |
| FR |
Numéro de passeport |
NNAANNNNN |
仅格式规则 |
无 |
只有格式规则:编造的号码可能是某个人的护照号。需要值时请使用 Utopia(默认)或公开样本。 |
| BR |
Número do passaporte |
AANNNNNN |
仅格式规则 |
无 |
只有格式规则:编造的号码可能是某个人的护照号。需要值时请使用 Utopia(默认)或公开样本。 |
证件号和税号字段默认为空,直到项目负责人在“项目设置 → 自定义字段 → 添加现成字段”中添加对应的现成字段(或 save_custom_field)。之后 form_values 会按账号所在国家,为每个字段填入 A 级或 B 级的值,或一本 Utopia 护照号,其余字段留空。
如果被测应用通过 KYC 服务商核验身份,该服务商的沙盒需要它自己的测试值。可以把 kyc_sandbox 和 kyc_outcome(pass、fail 或 review)传给 get_form_section、list_form_sections 或 form_values,或使用 npm 包中的 kycSandbox 和 kycOutcome。使用 form_values 时,新地址会采用该服务商的姓名和出生日期;如果有现成的证件号或税号字段,证件号和企业编号字段会填入该服务商的值。
这些是服务商的值,引自它们的文档,每周检查一次,确认各页面仍然列出这些值。只在该服务商的测试模式中使用:在测试模式之外,PAN 之类的号码可能属于真实的人。
Connect 身份核验,测试模式。仅限测试模式。地址令牌填在地址第一行,并配上真实的城市、州和邮编。测试证件图片优先于测试证件号。打开 Stripe 的页面
| 字段 |
值 |
适用于 |
沙盒的返回结果 |
| 出生日期 |
1901-01-01 |
通过 |
出生日期匹配成功 |
| 出生日期 |
1900-01-01 |
审核 |
触发 OFAC 警报 |
| 证件号(SSN 或身份证号) |
000000000 |
通过 |
证件号匹配成功 |
| SSN 后 4 位,US |
0000 |
通过 |
SSN 后 4 位核验成功 |
| 证件号(SSN 或身份证号) |
111111111 |
失败 |
证件号匹配失败(身份不符) |
| 证件号(SSN 或身份证号) |
111111113 |
失败 |
证件号匹配失败(证件号已失效) |
| 地址第 1 行 |
address_full_match |
通过 |
地址匹配成功(配合真实的城市、州和邮编) |
| 地址第 1 行 |
address_no_match |
失败 |
地址匹配失败(配合真实的城市、州和邮编) |
| 企业税号 |
000000000 |
通过 |
企业编号匹配成功 |
| 企业税号 |
111111111 |
失败 |
匹配失败(身份不符) |
| 企业税号 |
111111112 |
失败 |
匹配失败(税号未签发) |
| 企业税号 |
222221005 |
审核 |
等待登记机构回复 |
Identity Verification,沙盒。仅限沙盒。测试用户 Leslie Knope 能通过数据源和证件检查;改动任意一项信息(如出生日期)即可得到失败的检查。打开 Plaid 的页面
| 字段 |
值 |
适用于 |
沙盒的返回结果 |
| 名 |
Leslie |
通过 |
数据源和证件检查成功 |
| 姓 |
Knope |
通过 |
数据源和证件检查成功 |
| 出生日期 |
1975-01-18 |
通过 |
数据源和证件检查成功 |
| 手机号 |
+1 234-567-8909 |
通过 |
数据源和证件检查成功 |
| 手机验证码 |
11111 |
通过 |
测试手机号可用的验证码 |
| 地址 |
123 Main St., Pawnee, Indiana 46001 |
通过 |
数据源和证件检查成功 |
| SSN,US |
123-45-6789 |
通过 |
数据源和证件检查成功 |
身份核验,沙盒 API。仅限沙盒。申请人的姓决定结果:Consider 返回 consider,其他姓返回 clear。也可以用名来请求某个指定的子结果。打开 Onfido (Entrust) 的页面
| 字段 |
值 |
适用于 |
沙盒的返回结果 |
| 申请人姓 |
Consider |
审核 |
所有报告都返回 consider |
测试集成。Veriff 不公布特殊测试值:测试集成中的会话不会给出决定,每个会话的决定由你在 Veriff 的 Station 中自己设置。请使用账号自己的信息。打开 Veriff 的页面
沙盒。仅限沙盒。所有沙盒证件都基于同一个固定身份:出生日期 1990-06-15,以及下面的证件号;如果发送其他预期信息,检查会报告不匹配。姓名以你发送的为准。任何格式正确的一次性验证码都可用。打开 Didit 的页面
| 字段 |
值 |
适用于 |
沙盒的返回结果 |
| 出生日期 |
1990-06-15 |
通过 |
与所有沙盒证件匹配 |
| 护照号(巴西),BR |
YC531181 |
通过 |
与巴西示例 ePassport 匹配(Gustavo Matsumoto) |
| 护照号(阿根廷),AR |
AAF794880 |
通过 |
与阿根廷示例护照匹配(Maria Victoria Villareal) |
| 身份证号(西班牙),ES |
CAA000000 |
通过 |
与西班牙示例身份证匹配 |
| 驾照号(波兰),PL |
SP005/89/5 |
通过 |
与波兰示例驾照匹配 |
| 电话号码 |
+15005550009 |
失败 |
拒绝:HIGH_RISK_PHONE_NUMBER |
| 邮箱 |
sandbox+breach@didit.test |
失败 |
拒绝:BREACHED_EMAIL_DETECTED |
| 邮箱 |
sandbox+aml_hit@didit.test |
失败 |
拒绝:命中 AML |
| 邮箱 |
sandbox+aml_review@didit.test |
审核 |
审核中:可能的 AML 匹配 |
| 注册号 |
SANDBOX-KYB-MISMATCH |
失败 |
拒绝:企业信息不符 |
| 注册号 |
SANDBOX-KYB-REVIEW |
审核 |
审核中 |
| IBAN(德国) |
DE43123456789012345678 |
通过 |
账户检查匹配 |
Secure ID,测试环境。仅限测试环境,不在 Cashfree 列表中的数据都会失败。所有一次性验证码都是 111000。打开 Cashfree 的页面
| 字段 |
值 |
适用于 |
沙盒的返回结果 |
| PAN(个人),IN |
ABCPV1234D |
通过 |
有效 PAN |
| PAN(个人),IN |
DEFPV0126D |
失败 |
无效 PAN |
| PAN(企业),IN |
ABCCD8000T |
通过 |
有效 PAN |
| PAN(企业),IN |
LMNCD8010T |
失败 |
无效 PAN |
| Aadhaar 号,IN |
655675523712 |
通过 |
有效 Aadhaar |
| Aadhaar 号,IN |
655675523710 |
失败 |
无效 Aadhaar |
| GSTIN,IN |
29AAICP2912R1ZR |
通过 |
有效 GSTIN |
| GSTIN,IN |
29AAIZP2912R1ZR |
失败 |
无效 GSTIN |
| 一次性验证码,IN |
111000 |
通过 |
所有 OTP 请求的验证码 |
| 银行账号,IN |
026291800001191 |
通过 |
成功(配合 IFSC YESB0000262) |
| 银行账号,IN |
026291800001190 |
失败 |
失败:账号无效(配合 IFSC YESB0000262) |
Data APIs,沙盒。仅限沙盒。取自 Setu 的公开文档仓库,该仓库已于 2026 年 7 月 28 日归档:docs.setu.co 拒绝自动读取,所以使用某个值前请先在那里确认。打开 Setu 的页面
| 字段 |
值 |
适用于 |
沙盒的返回结果 |
| PAN,IN |
ABCDE1234A |
通过 |
有效 PAN |
| PAN,IN |
ABCDE1234B |
失败 |
无效 PAN |
| GSTIN,IN |
27AAICB3918J1CT |
通过 |
有效 GST |
| Aadhaar 号,IN |
999999990001 |
通过 |
有效 Aadhaar |
| Aadhaar 号,IN |
999999990000 |
失败 |
UIDAI 数据库中未找到 |
| 银行账号,IN |
1234567890 |
通过 |
小额打款验证成功(配合 IFSC ABCD0123456) |
| 银行账号,IN |
1234567890 |
审核 |
等待验证(配合 IFSC ABCD0123450) |
| 银行账号,IN |
1234567890 |
失败 |
账户信息无效(配合 IFSC ABCD0123467) |