ocr_银行卡函数

函数名：ocr_银行卡 / ocr_bank_card

函数功能

对银行卡图片进行OCR识别，提取卡号、卡类型、银行名称等关键字段信息。支持返回原始JSON数据与字段标题行显示，满足银行卡信息采集、绑卡核验等多种场景需求。

参数规范

参数名	类型	必填	示例	特殊说明
文件路径	String	是	"C:\\images\\bankcard.jpg"	银行卡图片完整路径，支持jpg/jpeg/png/bmp格式
原始数据	Boolean	否	false	默认false，true返回原始JSON格式数据
显示标题	Boolean	否	false	默认false，true在首行显示字段标题行

使用案例

基础银行卡识别

问题描述：识别银行卡图片，提取关键字段信息

公式演示：

=ocr_银行卡("C:\\images\\bankcard.jpg")

输出效果：

卡号	卡类型	银行名称
6222021234567890123	借记卡	中国工商银行

显示字段标题行

问题描述：识别银行卡并在首行展示字段名称，便于核对字段含义

公式演示：

=ocr_银行卡("C:\\images\\bankcard.jpg",,1)

输出效果：

卡号	卡类型	银行名称
6222021234567890123	借记卡	中国工商银行

返回原始JSON数据

问题描述：获取银行卡识别的原始JSON结果，便于二次处理

公式演示：

=ocr_银行卡("C:\\images\\bankcard.jpg",1)

输出效果：

{"card_number":"6222021234567890123","card_type":"借记卡","bank_name":"中国工商银行"}

错误处理示例

问题描述：文件路径为空或文件不存在

公式演示：

=ocr_银行卡("")

输出效果：

文件路径不能为空

技术说明

识别原理

• 底层调用远程OCR服务接口（/ocr/recognize），识别类型为bank_card
• 图片以multipart方式上传，返回结果经AES解密后格式化为二维数组
• 异步执行，处理中返回"Waiting..."

返回字段

字段名	说明
卡号	银行卡卡号
卡类型	借记卡/信用卡等
银行名称	发卡银行名称

异常处理

错误场景	返回值
文件路径为空	文件路径不能为空
文件不存在	文件不存在
图片格式不支持	不支持的图片格式
网络连接失败	网络请求失败
OCR识别异常	处理错误: 错误信息

会员等级

本函数为**专业版(Pro)**功能，需开通专业版会员授权后使用。

扩展应用

批量银行卡识别

结合Excel批量文件路径，下拉调用本函数实现银行卡信息批量提取，便于财务对账与归档。

卡号脱敏处理

识别出的卡号可配合文本函数进行脱敏处理，仅保留前后若干位用于展示。

注：本函数为专业版功能，依赖联网环境调用AI服务接口。支持jpg/jpeg/png/bmp格式图片，建议在WPS 2019+和Excel 365中使用。