# UnionPay **Repository Path**: huangxunyue/UnionPay ## Basic Information - **Project Name**: UnionPay - **Description**: 【自助终端硬件 & 银联交易一体化系统】本系统围绕自助终端金融交易与外设集成场景设计，基于中国银联 ISO8583 报文协议，面向智慧医院、智慧药店、政务、商超等自助缴费场景，提供银联交易、社保卡/银行卡读取、医保刷脸、电子医保码解码、小票打印、报告/发票文件打印的一体化接口与集成方案。读卡器已适配华视、德卡、强氏、创自等厂商设备，票据打印已适配研科、美松等厂商设备。关键词： UnionPay、ISO8583、银联交易、社保卡读卡、银行卡读卡、医保刷脸、电子医保码、自助缴费、小票打印、发票打印、报告打印、德卡、强氏、创自、华视、研科、美松 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2026-10-21 - **Last Updated**: 2026-10-21 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 💳 自助终端硬件 & 银联交易一体化系统 > 🌐 基于中国银联 ISO8583 报文协议，面向智慧医院、智慧药店、政务、商超等自助缴费场景，提供银联交易、社保卡/银行卡读取、医保刷脸、电子医保码解码、小票打印、报告/发票文件打印的一体化接口与集成方案。读卡器已适配华视、德卡、强氏、创自等厂商设备，票据打印已适配研科、美松等厂商设备。 **关键词：** UnionPay、ISO8583、银联交易、社保卡读卡、银行卡读卡、医保刷脸、电子医保码、自助缴费、小票打印、发票打印、报告打印、德卡、强氏、创自、华视、研科、美松 > 🤝 **商务合作：** 如需软件授权、系统源码、私有化部署、定制开发、外设适配与接口联调，欢迎通过文末联系方式联系。 --- ## 📖 项目简介 本系统围绕自助终端金融交易与外设集成场景设计，服务端基于中国银联 ISO8583 报文协议，实现银联卡（信用卡或储蓄卡）、社保个账（实体社保卡或电子医保码）的消费、冲正、退费、个账余额查询、电子医保码解码等金融交易，并对接身份证读卡器、社保卡读卡器、银行卡读卡器、密码键盘、小票机、普通打印机等硬件外设。 系统提供统一的 HTTP 接口：银联交易与硬件外设接口采用 `code=0` 表示成功、`code!=0` 表示失败的返回结构；所有接口均采用 JSON 交互。仓库用于展示系统接口能力、集成文档与示例说明，方便合作伙伴评估与联调。 商户侧无需从零实现 ISO8583 组包解包与银联交易接口，只需向收单银行申请银联商户号、终端号、密码键盘密钥信息，完成终端绑定、签到与密钥注入后，即可通过本系统发起金融交易。具体准入、终端绑定与密钥管理要求以收单机构为准。 --- ## ⭐ 重点能力 - 💰 **银联交易**：终端签到、签到 Key 注入与校验、账户余额查询、消费、冲正、退费、电子医保码验证。 - 💳 **社保卡信息读取**：读卡器初始化/释放、设备信息、卡信息、持卡人信息、社保账户信息读取（需输入社保卡密码）。已适配德卡、强氏、创自等厂商读卡器设备。 - 🏧 **银联卡信息读取**：银行卡读卡器初始化/释放、设备信息、卡号、有效期、服务代码、序列号、磁轨数据、55 域、48 域、读卡数据读取。已适配德卡、强氏、创自等厂商读卡器设备。 - 👤 **医保刷脸与电子凭证**：电子凭证业务调用、二维码解码、终端二维码解码、刷脸身份授权、刷脸身份信息获取、刷脸认证、终端读取身份证信息、刷脸核身。 - 🆔 **身份证读卡**：身份证读卡器设备信息获取，读取姓名、性别、民族、地址、出生日期、身份证号、有效期起始/结束日期、签发机关等信息，可用于实名核验、自助业务身份确认及医保刷脸流程中的身份信息读取。 - 🧾 **小票打印**：小票机设备状态、XML 打印模板、文本/条码/二维码/走纸/切纸、打印前缺纸检查。票据/小票打印已适配研科、美松等厂商设备。 - 🖨️ **报告/发票文件打印**：打印机列表与默认打印机设置、本地/网络/Base64 文件打印、A2-A6 纸张、横打/竖打、打印机状态、耗材状态、唤醒打印机。 --- ## 🧩 功能模块 | 📦 模块 | 🔑 关键能力 | 🔗 接口示例 | | --- | --- | --- | | 💰 银联交易服务 | 签到、签到 Key 注入与校验、余额查询、消费、冲正、退费、电子医保码验证 | `/unionPay/signIn`
`/unionPay/uploadPlainKey`
`/unionPay/balance`
`/unionPay/consume`
`/unionPay/reversal`
`/unionPay/refund`
`/unionPay/electronCode` | | 🏧 银行卡读取 | 初始化/释放读卡器、设备信息、卡信息读取；已适配德卡、强氏、创自等厂商读卡器 | `/reader/bankCard/openReader`
`/closeReader`
`/deviceInfo`
`/cardInfo` | | 💳 社保卡读取 | 初始化/释放读卡器、设备信息、卡信息、持卡人信息、社保账户信息；已适配德卡、强氏、创自等厂商读卡器 | `/reader/ssCard/openReader`
`/closeReader`
`/deviceInfo`
`/cardInfo`
`/holderInfo`
`/accountInfo` | | 👤 医保电子凭证与刷脸 | 电子凭证业务、二维码解码、刷脸授权、身份获取、刷脸认证、身份证读取、刷脸核身 | `/insurance/nationEC/call`
`/ecToken`
`/qrcodeGet`
`/ecAuth`
`/ecAuthCheck`
`/faceAuth`
`/certGet`
`/certCheck` | | 🆔 身份证读取 | 读卡器信息、身份证信息读取 | `/reader/idCard/deviceInfo`
`/cardInfo` | | 🧾 小票打印 | 设备信息、XML 模板打印、条码/二维码、走纸、切纸；票据打印已适配研科、美松等厂商设备 | `/receipt/deviceInfo`
`/print` | | 🖨️ 文件打印 | 打印机列表、默认打印机、设置默认、文件打印、唤醒、状态、耗材 | `/printer/getPrinterNames`
`/getDefaultPrinterName`
`/setDefaultPrinter`
`/printFile`
`/wakePrinter`
`/getPrinterStatus`
`/getSupplyStatus` | | ⌨️ 密码键盘 | 打开/关闭、键盘信息、扫描按键 | `/keyboard/open`
`/close`
`/info`
`/scanKeyPress` | ### 💰 1. 银联交易 系统基于中国银联 ISO8583 报文协议封装交易接口，支持： - 🔐 银联终端签到，返回 PinKey、MacKey、校验码与签到时间； - 🔑 签到 Key 注入与校验； - 💰 社保个账余额查询，返回账面余额与可用余额； - 🛒 银联消费交易（支持储蓄卡/信用卡/社保卡/电子医保）； - ↩️ 冲正消费交易（支持储蓄卡/信用卡/社保卡/电子医保）； - 💸 银联退费交易（支持储蓄卡/信用卡/社保卡/电子医保）； - 📱 电子医保码验证与解码。 消费、冲正、退费接口支持商户号、终端号、卡代码、卡类型、主账号、交易金额、交易单号、原检索参考号、退款单号等参数，并返回系统跟踪号、检索参考号、批次号、交易日期时间、55 域、61 域、受理机构标识码等交易结果信息。 ### 💳 2. 社保卡信息读取 支持实体社保卡读卡器完整生命周期管理： - 🔌 初始化读卡器、释放读卡器资源； - 📟 获取设备唯一标识、版本号、设备状态； - 📇 读取社保卡卡信息：识别码、卡类型、规范版本、发卡机构代码、发卡日期、有效期、卡号； - 👤 读取持卡人信息：卡号、姓名、性别、民族、出生日期等； - 💼 读取社保账户信息：医保主账号、PSAM 卡号/终端号/地区代码、应用序列号、应用有效期、服务码、货币代码、国家代码、磁轨数据、48/55 域、读卡数据等，需要输入社保卡密码。 支持读取一代、二代、三代社保卡；读取社保账户信息后，返回的医保主账号、有效期、服务代码、货币代码、国家代码、磁轨数据、55 域、读卡数据等字段可直接用于银联余额查询、消费、冲正、退费等交易接口，无需重复读卡组包。读卡器硬件已支持德卡、强氏、创自等厂商设备，具体型号与固件版本以实际联调确认为准。 ### 🏧 3. 银联卡信息读取 支持银行卡读卡器初始化、释放、设备状态查询与卡信息读取，返回： - 💳 卡类型、卡号、有效期、服务代码、卡序列号； - 🌍 货币代码、国家代码； - 📶 磁轨 1/2/3 数据； - 🔢 55 域、48 域、读卡数据等。 读取结果可直接用于银联消费、冲正、退费等交易接口。银行卡读卡器已适配德卡、强氏、创自等厂商设备，具体型号与固件版本以实际联调确认为准。 ### 👤 4. 医保刷脸与电子凭证 支持医保电子凭证与刷脸身份核验相关能力： - 📞 医保电子凭证业务调用； - 🔳 电子凭证二维码解码，返回参保人身份证、姓名、证件类型、参保地区编码、电子凭证令牌等； - 📲 终端电子凭证二维码解码； - 👤 医保刷脸身份授权； - 👁️ 获取医保刷脸身份信息； - ✅ 医保刷脸身份认证； - 🆔 终端读取身份证信息； - 🛡️ 医保刷脸核身。 需按当地医保平台要求配置 `api_url`、`orgId`、`businessType`、`operatorId`、`officeId`、`deviceType` 等参数。 ### 🆔 5. 身份证与密码键盘 - 🆔 **身份证读卡器**：获取设备信息、读取姓名、性别、民族、地址、出生日期、身份证号、有效期、签发机关等； - ⌨️ **密码键盘**：打开/关闭键盘、读取键盘序列号/版本/算法模式、扫描按键值，用于密码输入与交易授权流程。 ### 🧾 6. 小票打印 小票机支持基于 XML 模板的打印能力： - 🎨 打印格式设置：行间距、左边距、打印区域、对齐方式、加粗、下划线、字体放大； - 📝 内容打印、走纸/退纸、换行； - 📊 一维条码：HRI 位置、字体、高度、宽度、条码类型、条码数据； - 🔳 二维码：模块大小、纠错等级、二维码数据； - ✂️ 自动切纸； - 🔍 打印前状态检查，可配置是否检查缺纸； - 📟 设备信息查询：连接状态、在线状态、纸耗尽、纸即将耗尽、堵纸、切纸错误等。 票据/小票打印硬件已适配研科、美松等厂商设备，具体型号与固件版本以实际联调确认为准。 ### 🖨️ 7. 报告/发票文件打印 普通打印机模块支持： - 📋 获取打印机列表、获取/设置默认打印机； - 📄 打印本地文件、网络文件、Base64 文件； - 📐 文件后缀名、打印机名称、纸张大小 A2/A3/A4/A5/A6、打印方向横打/竖打； - ⏰ 唤醒打印机； - 📊 获取打印机状态：就绪、缺纸、打印中、卡纸、门打开、硒鼓未安装等； - 🎨 获取耗材状态：黑色/青色/红色/黄色墨盒剩余量、总打印页数、单色/彩色打印张数。 适用于自助机报告打印、发票打印、缴费凭证打印等场景。普通文件打印通过系统打印队列支持已安装的打印机。 --- ## 🔌 硬件兼容与已适配厂商 | 🖥️ 硬件类别 | 🏭 已适配厂商（示例） | 📝 说明 | | --- | --- | --- | | 💳 社保卡/银行卡读卡器 | 德卡、强氏、创自等 | 支持初始化/释放、设备信息、卡信息、持卡人信息、社保账户信息、银行卡磁轨与 55/48 域读取 | | 🧾 票据/小票打印机 | 研科、美松等 | 支持 XML 小票模板、文本/条码/二维码、走纸/切纸、缺纸检查与设备状态查询 | | 🆔 身份证读卡器 | 华视、明泰等 | 支持设备信息与身份证信息读取 | | ⌨️ 密码键盘 | 旭子、证通等 | 支持打开/关闭、键盘信息、按键扫描 | | 🖨️ 普通打印机 | 系统打印队列 | 支持本地/网络/Base64 文件、纸张与方向设置、状态与耗材查询 | > ℹ️ 以上为已支持厂商示例，不表示覆盖全部型号；具体型号、固件版本、驱动与接口协议以实际联调确认为准。如有其他厂商设备适配需求，可联系商务沟通定制开发。 --- ## 🔄 典型业务流程 1. 🏦 商户向收单银行申请银联商户号、终端号、密码键盘密钥信息； 2. 🚀 部署银联交易服务与硬件外设服务，完成终端绑定、签到和密钥注入； 3. 👤 用户选择银行卡、社保卡、电子医保码或医保刷脸； 4. 📇 通过读卡器/扫码/刷脸获取卡信息、账户信息或医保电子凭证令牌； 5. 💳 调用余额查询、消费、冲正、退费等银联交易接口； 6. 🧾 交易成功后打印小票、报告或发票； 7. 🔁 异常时发起冲正或退费，并记录交易流水与设备状态。 --- ## 🏥 适用场景 - 🏥 **智慧医院**：自助挂号缴费、医保个账支付、银行卡支付、报告打印、发票打印、医保刷脸核身； - 💊 **智慧药店**：社保卡个账购药、电子医保码支付、银联卡消费、小票打印； - 🛒 **商超与自助终端**：银行卡消费、冲正、退费、小票打印、交易凭证打印； - 🏢 其他需要银联交易、读卡、扫码、刷脸与打印外设集成的自助服务场景。 --- ## ⚙️ 技术特点 - 🏦 基于中国银联 ISO8583 报文协议设计金融交易服务； - 🔗 统一 HTTP 接口风格，银联交易与硬件接口以 `code=0` 表示成功； - 📦 支持 `form-data`、`urlencoded`、`json` 等多种 Content-Type； - 🖥️ 覆盖银行卡、社保卡、身份证、密码键盘、小票机、普通打印机等外设； - 🔌 读卡器已适配德卡、强氏、创自等厂商设备，票据打印已适配研科、美松等厂商设备； - 📄 支持本地/网络/Base64 文件打印与 XML 小票模板； - 🧱 可作为自助终端业务系统、医院/药店自助机、收银终端的支付与外设集成层。 --- ## 🤝 商务合作 我们提供以下合作方式，欢迎有需求的客户联系： - 📜 **软件授权**：银联交易服务、硬件外设服务、医保刷脸/电子凭证模块授权； - 💻 **系统源码**：完整系统源码授权、私有化部署与二次开发； - 🛠️ **定制开发**：收单银行/医保平台接口适配、外设型号适配（含德卡、强氏、创自读卡器，研科、美松票据打印机等）、打印模板定制、业务流程定制； - 🔧 **接口联调**：签到、密钥注入、余额、消费、冲正、退费、医保解码、刷脸核身、打印联调； - 🚀 **交付与运维**：部署文档、培训、维保与技术支持。 **📌 联系时建议提供：** 应用场景、终端数量、收单银行/医保接口现状、需要对接的外设型号、是否需要源码或私有化部署、计划上线时间。 ### 📞 联系方式 - 📧 邮箱：`h88305@qq.com` - 💬 微信：`18898383545` - ☎️ 电话：`18898383545` - ✉️ 邮件标题建议：`【银联自助交易系统合作】公司/项目名称+需求` > 🔐 商务合作、软件授权、源码授权、定制开发请联系上述方式。敏感信息请通过邮件或私密渠道沟通，请勿在公开 Issue 中提交商户密钥、证书、患者信息等敏感数据。 --- ## 🔒 合规与安全声明 - 🏦 使用本系统开展银联交易，需具备相应商户资质并完成收单机构准入、终端绑定与密钥管理要求； - 🏥 医保电子凭证、医保刷脸相关能力需获得当地医保平台授权并按其规范接入； - 🛡️ 生产环境请使用加密通道、密钥托管、访问控制、日志脱敏等安全措施，禁止在公开仓库保存生产密钥、证书和真实客户数据； - 📝 文档中的商户号、终端号、卡号、身份证号、姓名、密钥等均为演示数据，仅用于接口说明； - ⚖️ 本仓库内容用于展示系统接口能力与集成方案，不构成收单准入、医保准入或监管合规承诺，具体以收单银行、医保部门及监管要求为准。 --- ## 📚 仓库说明 本仓库主要展示接口文档、集成说明、打印模板示例与联调说明。生产商户密钥、终端密钥、医保授权参数、真实交易数据不入库。商业授权可提供完整系统源码、私有化部署与定制开发服务。 ⭐ 如果本项目对你有帮助，欢迎 Star、Issue 反馈文档问题；🤝 商务合作请通过上方联系方式联系。