验卡
本地付款
验卡
验卡用于付款前校验收款账户：确认账户是否有效，并判断持卡人姓名是否匹配。通常与 API 付款配合使用，验卡通过后再发起打款。
1
判断流程
验卡结果分三层，必须按顺序判断：上一层没有结论时，不要看下一层。
1
orderStatusPENDING结果未定，平台自动重试；轮询查询接口获取结果，暂不下单FAILED请求本身失败（渠道异常、参数错误等），可重新发起SUCCESS请求成功，进入下一层判断→
2
accountStatus仅 SUCCESS 时判断
VALID账户有效，进入下一层判断INVALID账户无效，不要发起付款UNKNOWN无法判定账户是否有效，不要继续判断姓名→
3
accountNameMatchResult仅 SUCCESS + VALID 时判断
MATCH姓名匹配，可发起付款NOT_MATCH姓名不匹配，先核对户名UNKNOWN渠道无法判定姓名是否匹配，建议核对备注
FAILED 只表示验卡请求失败，不代表账户无效；，UNKNOWN 表示传了姓名但渠道无法判定。accountNameMatchResult = UNKNOWN 时，accountName 仍可能返回，平台原样透传。
2
与 API 付款配合
代付打款只认账号、不校验收款人姓名，因此建议在首次向某个账户付款前先执行一次验卡：
- 获取收款账户信息。
- 调用验卡，并查询到最终结果。
- 账户有效且姓名匹配后再发起付款；其他结果先核对账户或户名。
不同验卡结论对应的建议动作：
VALID+MATCH**：可发起付款。INVALID或账户UNKNOWN**：不要付款，核对账号或提示用户更换账户。NOT_MATCH或姓名UNKNOWN**：先与用户核对户名，再按风控策略决定。FAILED或PENDING**：先处理验卡（重试 / 轮询），暂不下单。
备注
验卡通过只代表账户有效且姓名匹配，不保证付款一定成功——付款仍可能因余额不足、渠道限额、风控拦截等原因失败。
3
接口指引
- 发起验卡：
POST /open-api/inquiry-account - 查询验卡结果：
POST /open-api/inquiry-account/query
请求结构与代付接口一致（appId / sign / param）。重点关注以下参数：
| 参数 | 说明 |
|---|---|
countryCode | 国家编码：ID / MY |
mchOrderId | 商户验卡订单标识，需唯一 |
accountType | 账号类型，如 BANK / EWALLET / DUITNOWPROXY |
accountNo | 收款账号：银行账号、手机号或 DuitNow 账号 |
accountName | 选填；传入后做姓名匹配，不传则姓名结果为 null |
返回结果重点看 orderStatus、accountStatus、accountNameMatchResult；请求失败时看 failedCode / failedMessage。
备注
目前支持 ID（印度尼西亚）、MY（马来西亚）。验卡功能需要单独开通，请联系您的客户经理。
具体字段及完整枚举取值，请参考：验卡接口文档、查询验卡订单状态接口文档。