切换主题
虚拟银行常见问题
快速判断
先确认请求参数是否完整，重点检查主体信息、账户信息、证件信息、手机号、验证码和请求流水号。
再确认账户状态是否满足当前操作，例如电子登记簿是否已开通、是否已激活、是否已开通免密支付。
涉及身份、营业执照、OCR 和三/四要素鉴权的错误，优先核对证件原件、主体名称、统一社会信用代码、法人姓名、身份证号和手机号。
涉及交易失败的错误，优先检查余额、收款账户是否绑定或在白名单内，以及买卖双方角色是否传反。
如果提示重复开户、重复流水或已有处理中申请，先查询原申请或原业务流水状态，不要直接重复提交。
银行账户通
| 报错提示 | 可能原因 | 处理建议 |
|---|---|---|
| 未查询到登记簿信息 | 主体尚未成功开通电子登记簿，或查询参数与开户主体不一致 | 先确认开户是否成功；核对主体编号、账户号、应用号等查询条件 |
| 电子登记簿未激活 | 电子登记簿已创建但未完成激活流程 | 按开户/激活流程完成后再发起后续业务 |
| 当前主体已存在电子登记簿，请勿重复开通 | 同一主体已完成开通 | 查询已有电子登记簿信息，避免重复提交 |
| 当前主体已存在接收方/发起方开通记录，请勿重复开通 | 同一主体、同一角色已有开通记录 | 查询已有开通记录；如需变更，按变更流程处理 |
| 该主体已有开户申请正在处理中，请等待完成后再操作 | 当前主体存在未完成开户申请 | 等待原申请完成，或查询原申请处理结果 |
| 开通接收方前，必须先在该应用下成功开通发起方账户 | 接收方开户依赖发起方账户已成功开通 | 先完成发起方账户开通，再开通接收方 |
| 发起方只能是企业账户 | 发起方主体类型不符合要求 | 发起方使用企业主体开户；个人主体不能作为发起方 |
| - | - | 您好，出现该提示有两种解决方式：一是核对身份证、银行卡号，删除号码里所有空格，只保留纯数字；二是重新拍摄清晰无反光、完整的证件原图上传，图片模糊识别失败可直接手动输入号码再提交审核。 |
| 激活退票-01-账号不存在 | 账号存在括号或者跟提交的结算账号对不上 | 请删除账号内所有括号等特殊符号，核对填写账号与备案结算账号保持一致后重新提交。 |
| 报错提示 | 可能原因 | 处理建议 |
|---|---|---|
| 开户主体类型[entPerFlag]不能为空/格式错误 | 未传主体类型或取值不合法 | 按接口要求传入主体类型，通常仅支持对私 P、对公 E |
| 开户主体类型异常 - 主体类型仅支持 对私P / 对公E | 主体类型取值不在支持范围内 | 修正为 P 或 E |
| 开户账户角色[acctRole]不能为空 | 未传账户角色 | 按业务场景传入发起方/接收方等账户角色 |
| 电子登记簿类型[eleAcctType]不能为空/目前只支持1(基本户) | 未传电子登记簿类型或类型不支持 | 固定传入当前支持的基本户类型 1 |
| 绑定账户号/名称不能为空 | 缺少绑定银行卡号或账户名称 | 补全绑定账户号和账户名称 |
| 证件姓名/号码/有效期/地址不能为空 | 缺少证件关键信息 | 补全证件姓名、证件号、有效期和证件地址 |
| 身份证号格式错误 | 身份证号码格式不合法 | 检查位数、校验位、出生日期等格式 |
| 法人手机号/绑定账户手机号格式错误 | 手机号为空或格式不合法 | 使用 11 位大陆手机号，并确认号码归属人符合业务要求 |
| 开通资料不能为空 | 未提交开户资料对象或资料列表为空 | 按接口要求提交完整开户资料 |
| 验证码和验证码流水号不能为空 | 缺少短信验证码或验证码流水号 | 先获取验证码，再携带验证码和流水号提交 |
| 请求流水号不能重复 | 同一个请求流水号重复提交 | 每次请求生成唯一流水号；重复请求需先查询原流水状态 |
| - | 备注字段 memo 超过长度限制或为空格式不符 | - |
| 报错提示 | 可能原因 | 处理建议 |
|---|---|---|
| 调用中台鉴权错误-auth1222-您输入的身份证号、手机号、姓名中有1项或多项不符,身份验证失败,请确认后重试 | 身份证号、手机号、姓名三要素不一致 | 使用本人实名手机号，核对身份证号和姓名后重试 |
| 调用中台鉴权错误-统一社会信用代码、公司名称、身份证、姓名中有一项或者多项不符 | 企业四要素不一致，或法人身份信息与企业登记信息不匹配 | 核对统一社会信用代码、企业名称、法人姓名和法人身份证号 |
| 调用中台鉴权错误-auth1222-交易失败，报文格式错误[1020030] | 身份证图片模糊或者不清楚 | 使用身份证原件重新拍照上传，上传原图 |
| 身份证OCR_企业法人的核验结果：存在风险：有水印 | 身份证图片带水印或非原件拍摄 | 使用身份证原件重新拍照上传，不要带水印 |
| 身份证OCR_企业法人的核验结果：存在风险：复印件 | 上传了身份证复印件或翻拍件 | 使用身份证原件清晰拍照 |
| 营业执照OCR_企业_XXX_91XXXX核验结果：统一社会信用代码或名称不匹配，识别结果为：XXXX，91XXXX | 营业执照图片不清晰、变形、反光，导致识别结果与填写信息不一致 | 更换清晰、完整、无遮挡、无明显弯曲变形的营业执照照片 |
| 开户驳回原因 | 开户资料、主体信息或影像资料未通过审核 | 按驳回原因逐项修正后重新提交 |
| auth1222-您的银行卡暂不支持该业务，发卡行机构尚未开通此交易或不具备此交易权限，请更换卡后重试[1010140] | 对应银行卡未开通对应权限，可以去银行开通或者更换银行卡 | 对应银行卡未开通对应权限，可以去银行开通或者更换银行卡 |
| 报错提示 | 可能原因 | 处理建议 |
|---|---|---|
| BUS100_BUS100 Args: [BTC]余额不足 | 账户可用余额不足 | 充值或调整交易金额后重试 |
| BUS100_收款账户非绑定账户或白名单账户 | 收款账户未绑定，或未加入白名单 | 先完成账户绑定或白名单配置 |
| 卖家信息中不能包含买家 | 买家和卖家信息重复，或角色传参错误 | 检查买家、卖家会员号和账户信息，确保双方主体不同 |
| [buyId]无效的卖家平台会员号 | 买方/卖方会员号字段传错，或会员号不存在 | 核对字段含义和会员号来源，确认会员号有效 |
| 对方行账户状态异常（ZDA6）[SPS] | - | - |
| 渠道：收款方单笔限额[200000元] | 对私收款方收款不能超过200000 | 建议使用分笔下发 |
| 渠道：收款方单笔免密限额[100000元] | 对私收款方收款不能超过200000 | 建议使用分笔下发 |
| 渠道：收款方单笔限额[200000元] | 对私收款方收款不能超过200000 | 建议使用分笔下发 |
| 报错提示 | 可能原因 | 处理建议 |
|---|---|---|
| 当前账户未开通免密支付，缺少短信验证码[smsCode]参数 | 当前账户需要短信验证，但请求未传 smsCode | 先获取短信验证码，再提交业务请求 |
| [UAP]口令错误 | 验证码错误、验证码已过期或验证码流水不匹配 | 重新获取验证码，并确认验证码与流水号匹配 |
仍无法处理时
不要只看错误文案，要同时保存请求报文、响应报文、请求流水号和业务流水号。
参数类错误修正后可以重新提交，但必须使用新的请求流水号。
已有申请处理中、已有开户记录、已有电子登记簿等状态类错误，优先查询原业务状态，不要重复开户。
OCR 类错误优先更换清晰原件照片，避免复印件、截图、水印、反光、遮挡和变形。
鉴权类错误需要以真实主体信息为准，不建议通过修改单个字段反复试错。
交易类错误需要先确认账户余额、账户角色、绑定关系和白名单配置。
排查记录模板
| 字段 | 记录内容 |
|---|---|
| 接口名称 | 例如：开户、绑定账户、交易、查询 |
| 请求流水号 | 填写本次请求唯一流水号 |
| 主体类型 | 对私 / 对公 |
| 账户角色 | 发起方 / 接收方 |
| 报错提示 | 原样粘贴接口返回的错误文案 |
| 初步分类 | 参数校验 / OCR / 鉴权 / 账户状态 / 交易失败 |
| 处理动作 | 记录已修改的字段或已补充的资料 |
| 复核结果 | 重新提交或查询后的结果 |
回单显示
虚拟账户是分两步完成到卡操作的，
第一步是分账，显示的是分账发起方的公司。
第二步是提现，通过自动提现实现到卡路径，显示的会是接收方的虚拟账户打款给同一接收方的实际到卡账户
| 步骤类型 | 收款方账单详情 | 电子回单 |
|---|---|---|
| 虚拟户分账 | 分账时，收款方无账单显示 | - |
| 自动提现 | 打款账户为收款方虚拟户 | - |