账户核验
创建账户核验
POST /v1/account_verifications）创建。该接口端点允许客户提交账户及账户持有人详细信息，系统随后将其与相应金融机构所持记录进行比对。
核验模型目录
Mexico
Colombia
Mexico – Account Ownership Verification
Mexico – Account Details Verification
该模型验证所提供的账户及账户持有人信息是否与金融机构的官方记录一致。
仅支持 MEX 地区的账户，且必须为 CLABE 账户或 SPEI 卡号。 核验流程完成后，
当请求对无效 CLABE 或 SPEI 卡（长度无效或非纯数字格式）进行账户核验，或该账户不存在时，我们的接口端点将实时返回包含相应错误信息的响应。
核验响应仅在规定时间表范围内提供。
| 模型 | 地区 | 账户类型 | 描述 |
|---|---|---|---|
mex_acc_ownership_1 | MEX | CLABE 或 SPEI 卡 | 通过验证账户号码及账户持有人身份证件，确认 CLABE 账户或 SPEI 卡的归属权 |
必填字段
| 字段 | 描述 |
|---|---|
account_number | CLABE 账户号码（18 位）或 SPEI 卡号（15-16 位） |
account_type | 必须为 clabe |
account_holder_id_type | 证件类型（rfc 或 curp） |
account_holder_id_number | 账户持有人的证件号码 |
核验结果
verification_response 字段将返回以下值之一：| 核验结果 | 描述 |
|---|---|
matched | 账户持有人信息与金融机构记录一致 |
unmatched | 账户持有人信息与记录不一致 |
unresolved | 核验未能对一个或多个字段进行确定性验证 |
unresolved 结果可能由无效格式、错误标识符或在短时间内重复核验请求导致。何时可实时获取核验结果
账户核验注意事项
| 条件 | 描述 |
|---|---|
| 响应时间表 | 工作日 7:00 a.m. – 6:30 p.m.，非工作日 7:00 a.m. – 4:00 p.m. |
| 响应时间 | P50 在 10 分钟内，P90 在 24 分钟内 注意： 这些时间取决于接收银行，每月可能有所不同。仅供参考。 |
| 重试 | 短时间内重复验证可能导致失败；请至少等待 12 小时后再重试 |
核验状态对象
| 状态 | 代码 | 描述 |
|---|---|---|
processing | NA | 核验正在处理中 |
completed | NA | 核验流程已完成 |
failed | F006 | 账户无法完成验证 |
账户核验可执行的操作
🔑 Create
🔍 Retrieval
描述： 使用受支持的模型创建新的账户核验请求。执行该操作后的预期结果：
一个账户核验对象，包含： 📘 了解更多： 🔗 创建账户核验
一个账户核验对象，包含：
id（例如，av_xxxxx）modelgeoverification_requestverification_responsestatus账户验证对象
关键属性
| 字段 | 描述 |
|---|---|
id | 验证记录的唯一标识符 |
creator_id | 执行验证的客户端标识符 |
model | 所使用的验证模型 |
geo | 被验证账户所属地区 |
verification_request | 提交的账户及持有人数据 |
verification_response | 验证结果 |
status | 验证的操作状态 |
external_id | 客户端提供的外部参考标识 |
created_at | 创建时间戳 |
updated_at | 最后更新时间戳 |
如何开始使用
Identify the verification use case
在创建交易对手方或发起资金流动之前，确认是否需要进行账户验证。
Select the appropriate verification model
选择与账户所属地区和类型相匹配的验证模型。
Prepare verification data
确保账户号码和身份识别字段格式正确。
Create the account verification
通过账户验证 API 提交验证请求。
Handle the verification result
根据验证响应结果决定是否继续执行后续操作。
使用此 API 后的预期效果
Reduced payment rejections
在发起资金流动前验证收款方信息，减少付款被拒的情况。
Improved data accuracy
确保交易对手方及账户数据与金融机构记录一致，提升数据准确性。
Operational risk mitigation
在业务流程早期发现数据不匹配或未完成的验证，降低操作风险。
Cross-feature consistency
在 Counterparties 与资金流动流程中复用验证结果，保持跨功能一致性。
Modified at 2026-06-12 23:18:07