银银平台技术规范_代理快捷支付接口V1.1.12.doc

银银平台技术规范银银平台技术规范 第十部分第十部分 代理快捷支付接口代理快捷支付接口 编制单位 兴业银行 银行合作服务中心 版本号 1 0 1 发布日期 2012 8 修订历史记录修订历史记录 日期版本文档负责人修改内容 2012 10 81 0赵升平实施稿初稿 目目 录录 1 总体说明总体说明 1 2 术语定义术语定义 1 3 交互模式交互模式 1 3 1 请求 应答模式 1 3 2 单向通知模式 2 3 3 文件上传模式 3 4 报文结构报文结构 4 4 1 报文结构 4 4 2 报文分类 5 4 4 通用报文 5 4 5 报文的解析与传输 10 5 文件交换规范文件交换规范 11 5 1 文件访问路径 11 5 2 文件命名规范 11 5 3 文件压缩 12 5 4 文件加密 12 5 5 文件摘要 12 5 6 文件上传规则 12 6 业务顺序图业务顺序图 13 6 1 签约验证 13 6 2 网上支付 14 6 3 单笔提现 16 6 4 单笔实时查询 18 6 5 中间账户查询 18 6 6 单笔退货 20 6 7 清算对账 20 6 8 转账受理预处理 23 6 9 转账受理 23 6 10 冲正 24 7 接口实现说明接口实现说明 24 7 1 签约验证 24 7 2 网上支付 25 7 3 单笔提现 26 7 4 单笔实时查询 26 7 5 中间账户查询 27 7 6 单笔退货 28 7 7 清算对账 29 7 8 转账受理预处理 30 7 9 转账受理 30 7 10 冲正 31 8 安全规范安全规范 32 8 1 安全威胁 32 8 2 数字签名 33 8 3 报文日志管理 36 9 网络连接规范网络连接规范 36 9 1 专线连接 36 10 其他规范其他规范 36 10 1 异常处理规范 36 10 2 错误码规范 37 10 3 处理响应时间要求 37 10 4 可用性要求 37 11 附录附录 37 11 1 第三方支付金额格式 37 11 2 第三方支付货币代码表 37 银银平台技术规范 第十部分 代理快捷支付接口 1 1 1 总体说明总体说明 本文档为 银银平台技术规范 的组成部分之一 对银银平台代理快捷支付的业务合作技术规范进行了 定义 本文档适用范围 银银平台代理快捷支付业务的处理流程 本文档阅读对象 参与银银平台代理快捷支付业务的各合作第三方支付公司业务 技术人员 本文档由兴业银行银行合作服务中心起草 发布 2 2 术语定义术语定义 1 代理快捷支付 代理快捷支付业务为银银平台提供的支付结算产品之一 为参与银银平台代理快捷 支付业务的各联网机构的客户提供网上支付服务 2 合作行 参与银银平台代理快捷支付业务的各联网机构 3 客户 开通银银平台代理快捷支付的个人 3 3 交互模式交互模式 在银银平台代理快捷支付业务的技术实现中 第三方支付公司与银银平台之间通过交换报文与数据文件 来交换业务信息 实现业务流程 控制业务规则 实现代理快捷支付业务所需的交互模式可以归纳为请求 应答 单向通知 文件上传这三种模式 实际 业务中可能将各种交互模式结合起来使用 下面详细介绍这三种交互模式适用的场景与实现方式 3 1 请求请求 应答模式应答模式 在请求 应答模式下 一方作为服务提供者 另一方作为服务使用者 由服务使用者主动向服务提供者 发起请求并等待应答 服务提供者接受请求 完成处理 并向服务使用者应答处理结果 服务使用者接收到 处理结果之后进行后续处理 请求 应答模式适用于服务使用者需要根据服务提供者的应答才能进行正确的后续处理场景 比如 在 代理快捷支付业务中 第三方支付方作为服务使用者 银银平台作为服务提供者 第三方支付需要知道银银 平台的支付处理结果之后才能继续交易流程 银银平台技术规范 第十部分 代理快捷支付接口 2 第三方支付 公司 银银平台 3 服务处理 1 服务请求 4 服务应答 6 后续服务处理 合作行 2 转发服务 5 转发服务 3 2 单向通知模式单向通知模式 在单向通知模式下 一方作为通知发送者 一方作为通知接收者 发送者发送通知 并保证接收者接收 到通知 通知接收者在收到通知之后 立即返回发送者通知已收到 通知送达之后 发送方与接收方可以独 立地进行后续业务处理 在第三方支付标准中 如果对方业务处理所需的时间不可预知时 采用单向通知模式 单向通知模式可 以单独使用 也可以作为其它交互模式的一部分使用 比如文件上传模式中应用了单向通知模式 银银平台技术规范 第十部分 代理快捷支付接口 3 通知发送者通知接收者 2 响应 1 通知 3 通知已收到 5 发送者业务处理 4 接收者业务处理 3 3 文件上传模式文件上传模式 在文件上传模式中 一方作为文件提供者 另一方作为文件使用者 文件提供者首先生成文件 然后将 文件上传给文件使用者 在文件上传完成之后 文件提供者通知使用者 通知信息中包含文件的上传位置与 其它信息 文件使用者接到通知后 根据文件内容进行后续的业务处理 文件上传模式的特点是文件使用者拥有文件服务系统 文件服务系统由第三方支付系统统一提供 文件 上传模式适用于由银银平台向第三方支付发起的处理请求 如清算对账等 银银平台 第三方支付 公司 2 上传文件 3 通知文件信息 5 后续业务处理 1 生成文件 4 通知已收到 银银平台技术规范 第十部分 代理快捷支付接口 4 4 4 报文结构报文结构 本部分介绍银银平台代理快捷支付报文的一般结构与公共元素 这些规范适用于所有的代理快捷支付协 议报文 具体代理快捷支付业务中使用的报文 在各个业务实现规范中分别进行阐述 4 1 报文结构报文结构 第三方支付报文统一采用 xml 格式 所有的第三方支付报文均以 YYPT 作为根元素 每个 YYPT 元素 中包含代表具体的业务元素 比如 CSReq CSRes 等 每个业务元素由一些列属性元素构成 不同的业务中 包含的属性元素有所不同 对于涉及到资金变动的业务元素 必须要有与之匹配的 Signature 元素进行数字 签名 作为约定 YYPT 元素 Message 元素均是首字母大写的形式 所有属性元素均是首字母小写的形式 样例报文格式如下 注意 extension 里面可能包含嵌套报文 包含 1 个或者 1 个以上的子节点 例如 lwhbh43002 在下文中出现的具体报文格式描述中 出现要求 列包含的值的含义如下表所示 符 号 含义请求方约束服务方约束 RRequired 必须的 必须包含该域必须校验该域是否存在和内容的合法性 CConditional 有条件的 如果条件符合必须包含该域当条件满足时 必须校验该域是否存在 当该域存在时 必须检验其内容的合法 性 OOptional 可选的 该域可选当该域存在时 必须检查其内容的合法 银银平台技术规范 第十部分 代理快捷支付接口 5 性 4 2 报文分类报文分类 第三方支付协议中的报文按照交互模式的不同 分为以下几类 服务请求类报文服务请求类报文 服务请求类报文用于请求 应答交互模式 由服务使用者向服务提供者发送 服务请求类报文的命令规 范是 XXReq 其中 XX 是报文代表的业务的首字母缩写 Req 是 Request 的缩写 服务应答类报文服务应答类报文 服务应答类报文用于请求 应答交互模式 由服务提供者向服务使用者返回 服务应答类报文的命令规 范是 XXRes 其中 XX 是报文代表的首字母缩略 Res 是 Response 的缩写 比如对于签约应答报文 命名为 CSRes 代表 Card Sign Response 通知类报文通知类报文 通知类报文用于单向通知交互模式 由通知发送者向通知接收者发送 通知类报文的命令规范是 XXNotify 其中 XX 是报文代表的业务的首字母缩略 通用报文通用报文 通用报文适用于所有的代理快捷支付业务 第三方支付协议中有三种通用报文 一种是 Error 报文 用 于返回处理错误 一种是 NotifyAccept 代表单向通知已被接受 还有一种是 FileAccept 代表文件上传 对于业务相关的服务请求类 服务应答类与通知类报文的具体格式 将放在具体的业务实现规范中加以 描述 报文的通用结果与通用报文将在本部分描述 4 4 通用报文通用报文 4 4 1 错误消息报文 Error 功能功能 用来当请求或者应答不能被正确处理时返回 Error 域域 下面列举了 Error 消息域的定义 中文域名英文域名类型出现 要求 说明 版本号versionchar 7 R目前版本号 1 0 1 机构标识instIdchar 16 R报文发送方的机构标识 数字证书标识certIdchar 16 R对报文进行签名的数字证书标识 见 数字签名 错误代码errorCodechar 4 R 银银平台技术规范 第十部分 代理快捷支付接口 6 错误描述errorMessagechar 256 O 详细错误信息errorDetailChar 512 O 服务方代码vendorCodechar 256 O消息创建者持有的代码 消息扩展extensionO 联网行编号bankNochar 5 R联网行编号 错误代码说明错误代码说明 下表列举了标准的错误代码 错误代码错误描述解释 报文类错误 0000无效的根元素根元素无法识别 0001未定义的消息域消息不是 CSReq CSRes 等 或者消 息发送给了一个错误的组件 0002必填域缺少报文中出现要求为 R 的参数缺失 0003无法识别关键域如 版本号错误 0004根据规范 一个或 多个域不符合格式 要求 例如 非数字 或者不是有效地日期格 式等等 0005银行标识不正确instId 域中的银行标识不正确 0006协议版本有误暂未使用 0007签名无效报文签名校验不通过 0008加密密钥不存在加密密钥不存在 0009签名密钥不存在签名密钥不存在 文件类错误 0300文件格式不正确系统导入文件时发现格式不对 导入 失败 0301业务日期不正确业务日期格式不对 一般情况下业务 日期必须是昨日 不过系统也支持以 前日期的数据处理 0302文件已锁定当文件上传通知发送后 不允许再次 上传相同 0303文件不存在下载文件时 找不到指定的文件 0304文件无法解密上传的文件无法正确解密 0305文件已处理对于不允许重复处理的业务文件 如 果已处理过 就发生此错误 0306文件无法解压缩上传的文件无法正确解压缩 0307文件无法删除上传的文件无法删除 0308文件摘要不正确文件上传通知报文中的文件摘要不正 确 查询类错误 0400支付流水重复重复的网上支付流水 0401原支付流水不存在原支付流水不存在 银银平台技术规范 第十部分 代理快捷支付接口 7 0402查询范围太大查询时间跨度太大 0403查询的交易不存在查询的交易不存在 用户类错误 适用于 CSReq 请求 第三方支付返回给银银平台 1000已经签约成功 1001第三方支付银行卡 折无效 银行卡 折号不存在有效地第三方支付 签约记录 1002第三方支付签约状 态不正确 第三方支付签约状态不允许执行当前 的业务 1200身份证已经被使用身份证已经被其它用户使用 并签约 1201年龄不满足如 用户未满 18 岁 1202身份证格式不正确身份证不是有效地身份证 1203真实姓名不正确真实姓名与第三方支付的不一致 1204证件类型不正确证件类型与第三方支付中的不一致 1205身份证号码不匹配身份证号码与第三方支付中登记的身 份证号码不匹配 1206认证信息不匹配认证信息与第三方支付通过认证的信 息不匹配 1207该银行卡 折号已经 成功签约 该银行卡 折号对应的第三方支付帐号 已经签约成功 1301第三方支付帐户不 存在 第三方支付帐户标识不对应有效地第 三方账户 1302第三方账户状态不 正确 第三方支付帐户状态不允许签约 1303第三方账户类型不 正确 第三方支付帐户类型不允许签约 1304第三方支付帐户已 经申请 1305第三方支付账号绑 定的第三方支付数 量超额 第三方支付账号绑定的银行卡 折已经 超过最大数量 1306第三方支付账号通 过的认证数量超过 最大值 第三方支付账号通过的认证数量超过 最大值 1307登陆账号无效 只 能是合法 EMAIL 或者中国大陆内的 手机号 第三方支付帐户格式不对 1308系统创建账户失败 原因未知 请与第 三方支付客服联系 自动注册第三方支付用户失败 1309无效的第三方支付 账号 不允许签约 代理快捷支付业务 第三方支付帐户格式不对 银银平台技术规范 第十部分 代理快捷支付接口 8 1310此手机号码已经开 通了第三方支付的 手机支付业务 不 能再绑定第三方支 付 请直接使用第 三方支付的登录 EMAIL 绑定 用户已开第三方支付手机支付 不允 许开代理快捷支付业务 1311账号无效 如果没 有第三方支付账号 请填写注册过程中 所用的 EMAIL Email 类型的账户不能自动注册 银行卡 折类错误 适用于 CSVReq 请求 银银平台返回给第三方支付系统 1800银行卡 折用户名不 存在 户名不存在 1801银行卡 折号不存在银行卡 折号不存在 1802户名与银行卡 折号 不匹配 户名与银行卡 折号不匹配 1803银行卡 折号与卡类 型不匹配 银行卡 折号与卡类型不匹配 1804不支持的银行卡 折 号 不支持的银行卡 折号 1805不支持的证件类型不支持的证件类型 1806证件号码格式错误证件号码格式错误 1807与登记证件类型不 匹配 与登记证件类型不匹配 1808与登记证件号码不 匹配 与登记证件号码不匹配 1809未登记手机号码未登记手机号码 18010与登记的手机号码 不匹配 与登记的手机号码不匹配 支付类错误 1401密码校验次数超限密码校验次数超限 1402银行卡 折状态不正 确 银行卡 折状态不正确 1403银行账户状态不允 许该操作 银行账户状态不允许该操作 1404银行支付校验码输 入错误 银行支付校验码输入错误 1405银行支付校验码输 入失效 银行支付校验码输入时间范围限制 失效 1406原支付申请流水号 已经支付 支付流水号已经支付过 1407原支付申请流水号 不存在 支付申请流水不存在 银银平台技术规范 第十部分 代理快捷支付接口 9 1408支付密码输入超限第三方支付密码超过输入次数限制 银行卡 折类错误 1601金额超限支付金额超过每日限额 1602余额不足银行账户中的余额不足以完成支付 1603第三方支付在该提 体现金额不足 1604银银平台交易处理 中 该笔交易在银银平台前置系统中状态 未知 1605银银平台交易失败该笔交易在银银平台系统中已经失败 且状态不会再发生变更 1606提现金额超限提现金额超过每日限额 1607银行卡 折号不正确银行卡 折号不正确 管理类错误 2000第三方支付渠道关 闭 没有开通第代理快捷支付业务 2001服务没有开通请求的业务没有开通 系统类错误 9000暂时系统异常例如 一个请求队列满了 9001永久系统异常例如 无法访问一个重要数据库所在 的磁盘 4 4 2 NotifyAccept 报文报文 功能功能 用来代表单向通知已被接受 消息域消息域 下表列举了消息域的定义 中文域名英文域名类型出现要求说明 版本号versionchar 7 R目前版本 1 0 1 机构标识instIdchar 16 R报文发送方的机构标识 见数字签名 数字证书标识certIdchar 16 R对报文进行签名的数字 证书标识 见数字签名 服务方代码vendorCodechar 256 O通知接受人特有的代码 消息扩展extensionO 4 4 3 FileAccept 报文报文 功能 用来代表文件上传已被接受 银银平台技术规范 第十部分 代理快捷支付接口 10 消息域消息域 下表列举了消息域的定义 中文域名英文域名类型出现要求说明 版本号versionchar 7 R目前版本 1 0 1 机构标识instIdchar 16 R报文发送方的机构标识 见数字签名 数字证书标识certIdchar 16 R对报文进行签名的数字 证书标识 见数字签名 服务方代码vendorCodechar 256 O通知接受人特有的代码 消息扩展extensionO 4 5 报文的解析与传输报文的解析与传输 第三方支付报文的传输使用 XML Over HTTP S 方式 在 HTTP 请求 响应体中包含 XML 形式的报文 4 5 1 报文解析报文解析 对 XML 解析的基本要求如下 版本号检查版本号检查 用于表示组件支持的协议版本号 消息版本号必须表示为 n n n 其中 n 表示数字 表示一 个或多个 比如 1 0 或 1 0 1 在所有的消息中 各组件都必须填写自身支持的协议版本号 消息版本号不能 低于 1 0 1 如果消息版本号低于接收方组件支持的最低版本号 则接收方组件必须返回 Error 消息 并且设 置错误码 0006 xml 解析解析 为了可以支持后续协议版本 xml 解析的实现不要做严格的验证 特别是需要忽略未被确认的域 所有 xml 消息必须用 utf 8 编码 Message 域之域之 id 属性匹配属性匹配 请求和应答报文的 Message 域之 id 属性必须相同 id 是请求方生成的唯一序列号 比如 银银平台在 CSReq 的 Message 域设置了一个 id 属性值 则第三方支付在 CSRes 里面的 Message 域的 id 属性必须和 CSReq 的 Message 域之 id 值相同 4 5 2 报文传输报文传输 对 HTTP 传输的基本要求如下 使用使用 POST 发送消息发送消息 银银平台技术规范 第十部分 代理快捷支付接口 11 消息请求基于 HTTP HTTPS 的 POST 方式 HTTP 消息头要求消息头要求 HTTP 请求与响应消息中必须按照如下要求设置头部域 Content Length 必须设置成消息体的长度 Content Type 必须设置下面的值 application xml charset utf 8 5 5 文件交换规范文件交换规范 5 1 文件访问路径文件访问路径 快捷支付文件服务器的访问 URL 格式如下 http s ip 地址 file action instId yyyymmdd filename certId xxxx sign xxxxxx 其中 1 http s file ip 地址 file 第三方支付文件系统的根路径 具体路径联调时确定 2 action 操作类型 如 upload 表示上传 download 表示下载 3 instId 银行机构代码 第三方支付统一分配 管理 4 yyyymmdd 文件业务日期 如 清算日期 5 filename 遵循业务文件命名规范的文件名 6 certId 签名证书 ID 详情见证书获取规范 7 sign 使用 certId 指定的证书 文件上传方 RSA 私钥 对 action instId yyyymmdd filename 进行 签名 对签名结果进行 Base64 编码后获得的字符串 8 由于文件上传使用 GET 方式的 HTTP 请求 未防止 URL 中出现特殊字符 需要对 URL 中的 sign 值进行编码 注 文件上传时 文件通过附件方式上传 如果文件上传成功 服务器返回注 文件上传时 文件通过附件方式上传 如果文件上传成功 服务器返回 FileAccept 报文 如果文件报文 如果文件 上传失败 服务器返回上传失败 服务器返回 Error 报文 报文 5 2 文件命名规范文件命名规范 文件命名规范对文件名称进行统一的规划 以达到从文件名称上区分不同业务文件的目的 文件命名规 范 filetype yyyymmdd sequence zip 其中 filetype 文件类型 yyyymmdd 文件业务日期 如 清算日期 sequence 批次号 批量仅用于文件区分 无业务含义 由银银平台自行生成 银银平台技术规范 第十部分 代理快捷支付接口 12 目前已有的文件类型如下 CCF 清算对账文件 5 3 文件压缩文件压缩 文件传输前需要压缩成 zip 格式 5 4 文件加密文件加密 对压缩后的文件 需要加密之后再传输 加密时采用三重 DES 对称加密算法 3DES 加密密钥按事先约 定好的方式分发 5 5 文件摘要文件摘要 对加密后的文件进行摘要 摘要不包含在文件中 通过文件上传通知报文传送 摘要算法使用标准 SHA1 算法 结果表示成 40 位 16 进制大写字母数字串 文件使用方接收到文件上传通知报文时 将对文件 摘要进行验证 5 6 文件上传规则文件上传规则 文件上传完成后 文件上传者发送文件上传通知报文给对方 文件上传方一旦发送了文件上传通知报文 文件系统不允许再次上传该文件 在发送文件上传通知报文前 文件上传方可以重新上传新的文件 文件名 与老文件不能相同 发送通知报文时以最新上传的文件进行通知 银银平台技术规范 第十部分 代理快捷支付接口 13 6 6 业务顺序图业务顺序图 6 1 签约验证签约验证 三方支付银银平台合作行 1 用户申请签约 签约验证流程 2 填写银行卡 折 信息 身份信 息 手机校验 码 3 签约规则校 验 4 提交验证请 求 5 接收签约验 证请求 8 返回结果解 析 7 返回校验结果 登记签约信息 6 验证用户卡信 息和手机号 返回校验结果 说明 本交易的需要满足以下约束条件 签约用户 银行卡 折持有人与第三方支付账户所有人必须是同一个人 签约关系一旦成立 则参与第代理快捷支付业务的银行卡 折和客户将不可变更 直至签约关系终 止 银行卡 折号信息为银行与持人所拥有 在第三方支付签约过程中 第三方将保存银行卡 折号等支 付关键要素 第三方支付签约用户必须持有手机 且手机号为用户在银行端开卡时所登记的手机号 具体交易处理流程如下 1 用户登陆三方支付网站申请签约 2 填写银行卡 折信息及身份信息 如 姓名 卡 折号 卡 折类型 证件类型 身份证号 手机号等 3 第三方支付公司根据用户填写的信息进行签约规则校验 4 校验通过后 构造签约验证请求 发送到银银平台 银银平台技术规范 第十部分 代理快捷支付接口 14 5 银银平台接收到签约验证请求 6 合作行对用户的银行卡 折信息等进行验证 验证要素包含但不限于 卡 折号 卡类型 户名 证件 类型 证件号码 手机号码 其中手机号必须为用户签约银行卡 折在银行登记的手机号码 验证完成后返 回验证结果 7 银银平台转发验证结果 8 如果验证成功 第三方支付系统登记用户的签约信息 页面显示结果信息 签约成功后用户便可以 使用已签约银行委托第三方支付公司进行扣款 否则 返回错误信息 6 2 网上支付网上支付 客户三方支付银银平台 1 互联网购物 网上支付 交易流程 2 输入支付密码请求 网上支付 11 显示支付结果 10 入账并交易支付 7 网上支付交易 处理 5 银银平台转发 8 返回网上支付应答指令 合作行 3 验证网上支 付合法性 4 发送网上支 付请求报文 9 返回交易结果 6 验证合法性 说明 网上支付业务在执行中需要满足以下约束条件 网上支付必须由客户请求 第三方支付方发起 网上支付时的资金只能从第三方支付签约时确定的签约银行卡 折账户支出 用于同一客户的网上 支付 网上支付时客户在签约银行卡 折账户中的资金只能转移到第三方支付公司指定的清算账户中 银银平台技术规范 第十部分 代理快捷支付接口 15 同一支付订单号的第三方支付网上支付交易银行必须保证只能执行一次 银银平台与第三方支付方需要保存网上支付相关报文的日志作为解决资金清算不一致的依据 本交易的具体处理流程如下 1 客户通过互联网在三方支付商户处购物 并在三方支付创建交易 2 客户输入支付密码 并请求三方支付使用本人三方支付账户关联的快捷支付签约银行卡 折为交易支 付 3 三方支付验证客户身份与快捷支付网上支付请求的合法性 验证项目包含 该第三方支付账户的状态允许支付 支付密码正确 第三方支付服务已激活 账户安全等级达到第三方支付支付的要求 当日第三方支付网上支付总额在第三方支付规定的三方支付每日支付限额内 上述验证中如果有一项不符 则第三方支付拒绝客户的第三方支付网上支付请求 并将客户引导到恰当 的第三方功能页面 4 三方支付生成唯一的快捷支付网上支付订单号 并根据该三方支付账户的使用的银行卡 折号确定银 行 构造 网上支付请求 报文 三方支付将该报文发送给银银平台 5 银银平台转发合作行处理 6 合作行接受 网上支付请求 报文 验证网上支付的合法性 验证项目至少包括 银行卡 折状态有效 银行卡 折余额足够 上述验证中如果有一项不符 则合作行拒绝该请求报文 并返回第三方支付支付失败的原因 7 合作行处理网上支付交易 从第三方支付签约记录中的银行卡 折账户划付资金至第三方支付资金清 算专用账户中 并进行其它关联处理 比如手续费扣减 积分计算等 8 合作行处理网上支付交易成功之后 将交易处理结果通过 网上支付应答 报文返回给第三方支付 9 三方支付接受到银行返回的 网上支付应答 报文 从中解析出处理结果 如处理结果显示银行处 理成功 则三方支付为客户进行资金入账 并支付该笔互联网交易 10 三方支付向用户显示网上支付的结果 11 客户查看网上支付的结果 银银平台技术规范 第十部分 代理快捷支付接口 16 6 3 单笔提现单笔提现 客户三方支付银银平台 1 登录三方支付 单笔提现 交易流程 2 输入支付密码请求 单笔提现 14 显示提现结果13 解冻客户提现资 金并转账 7 验证转入账户 11 返回单笔提现报文 合作行 3 验证单笔提 现合法性 4 临时冻结客 户提现资金 5 发送单笔提 现请求报文 10 单笔提现交易 处理 12 银银平台转发 6 验证单笔提现合法 性 8 返回验证结果 9 验证通过 说明 单笔提现业务在执行中需要满足以下约束条件 单笔提现业务只能由客户请求 并从第三方发起 提现的资金只能划转到客户的第三方签约银行卡 折账户中 提现的资金只能从事先约定的第三方资金清算账户中划拨 提现的资金不能超过第三方支付与银行对每日提现额度的限制 提现的资金不能超过客户在第三方账户中的可用余额 同一提现订单号的单笔提现交易银行必须保证只能执行一次 银行与第三方支付需要保存双方与提现相关的报文日志作为解决资金清算不一致的凭证 本交易的具体处理流程如下 1 客户使用三方支付账号与三方支付登录密码登录三方支付网站 2 客户输入支付密码与提现金额 请求从三方支付账户向签约银行卡 折提现 3 三方支付验证客户身份与三方支付单笔提现请求的合法性 验证项目包含 银银平台技术规范 第十部分 代理快捷支付接口 17 该第三方支付账户的状态是否允许提现 支付密码正确 第三方支付服务已激活 提现金额不大于第三方账户内的可用余额 账户安全等级达到第三方提现的要求 当日第三方提现次数与总额在第三方规定的每日提现限次与限额内 其它第三方针对提现的业务规则 上述验证中如果有一项不符 则第三方支付拒绝客户的单笔提现要求 并将客户引导到恰当的第三方支 付功能页面 4 三方支付临时冻结该三方支付账户内与提现金额等量的资金 5 三方支付产生唯一的单笔提现订单号 并根据该三方支付账户签约的协议号确定银行 构造 单笔 提现请求 报文 三方支付将该报文发送给银行 6 合作行接受 单笔提现请求 报文 验证提现的合法性 验证项目至少包括 第三方支付协议对应的签约记录已成功 银行卡 折状态有效 本次单笔提现订单号之前未执行过 上述验证中如果有一项不符 则银行拒绝该请求报文 并返回第三方支付单笔提现失败原因 7 验证转入行账户 8 合作行返回验证结果 9 验证通过后执行以下步骤 10 合作行行处理单笔提现交易 从三方支付资金清算专用账户中实时划付资金至客户的签约银行卡 折账户中 并进行其它关联处理 比如手续费扣减 11 合作行处理单笔提现交易成功之后 将交易处理结果通过 单笔提现应答 报文返回给第三方 12 第三方支付接收到银行返回的 单笔提现应答 报文 从中解析出处理结果 若处理结果显示银行处 理成功 则第三方解冻客户因提现临时冻结的资金 并扣减客户第三方支付账户中的余额 若处理结果显示 银行处理失败 则第三方支付直接解冻客户因提现临时冻结的资金 不变动客户第三方支付账户中的余额 13 第三方支付向客户显示单笔提现结果 银银平台技术规范 第十部分 代理快捷支付接口 18 6 4 单笔实时查询单笔实时查询 三方支付银银平台 1 确定业务类型 查 询订单号 单笔实时查询流程 2 发送交易请求 STQReq 3 检查交易合法性 5 返回结果解 析 4 返回查询结果 单笔交易查询业务执行需要满足以下约束条件 只有网上支付 单笔提现是可以查询的 银行端根据第三方支付请求信息实时返回处理结果 返回成功的交易状态代表账务成功 返回失 败的代表账务失败 单笔交易查询的处理流程如下 1 第三方支付端获取交易类型和查询订单号 2 第三方系统构造 单笔交易查询请求 报文 并发送给银银平台 3 银银平台收到 单笔交易查询请求 报文之后 做合法性检查 4 银银平台根据查询请求中的交易类型 第三方订单号来查询这笔交易的实际执行结果 5 向第三方支付返回 单笔交易查询应答 报文 6 5 中间账户查询中间账户查询 银银平台技术规范 第十部分 代理快捷支付接口 19 三方支付 中间账户查询流程 2 接收第三方支付请 求报文 根据帐务日 期查询第三方支付内 部户相关信息 3 按查询结果生成第 三方支付响应报文4 后续处理 1 根据需要生成查询 请求报文发送银行 银银平台 第三方支付为及时掌握银银平台待清算账户的资金变动情况 需要能查到银银平台每个清算日的相关资 金账户信息 银银平台提供让第三方支付系统查到每个清算日第三方支付中间账户的可用余额以及上日余额 的交易 若第三方支付在银银平台开有清算账户 有其它途径可以查到该第三方支付中间账户状态的 可以 不做此功能 处理流程 1 第三方支付资金管理人员输入银行账务日期 币种 发送 中间账户日报查询请求 报文到银银平台 2 银银平台接收报文 到核心系统查询第三方支付临时户的相关余额变动信息 3 按查询结果生成返回第三方支付的 中间账户日报查询应答 报文 4 第三方支付系统进行后续处理 银银平台技术规范 第十部分 代理快捷支付接口 20 6 6 单笔退货单笔退货 三方支付工 作人员 三方支付银银平台 1 核实交易需要退 货 并确定退货 单笔退货 交易流程 2 请求退货 14 显示单笔退货结 果 13 解冻并扣减客户 第三方支付账户退货 资金 7 验证转入账户 11 返回单笔退货报文 合作行 3 验证单笔退 货合法性 4 临时冻结客 户三方支付账 户待退货资金 5 发送单笔退 货请求报文 10 单笔退货交易 处理 12 银银平台转发 6 验证单笔退货合法 性 8 返回验证结果 9 验证通过 说明 与单笔提现类似 这里不再重述 6 7 清算对账清算对账 银银平台技术规范 第十部分 代理快捷支付接口 21 银银平台三方支付 1 生成T日0 00 24 00 清算对账文件 签约验证流程 2 上传清算对账文件 3 发送 清算对账 通知报文 4 核对T日第三方支 付交易流水 5 数据恢复与订 正 成功后 清算对账业务在执行中需要满足以下约束条件 银银平台提供的 T 日 0 00 24 00 变化的第三方支付交易明细数据 银银平台在 T 1 日上午 8 00 点之前主动向第三方支付提供 T 日第三方支付交易明细数据文件 当清算对账完成后 并完成差错处理之后 双方直至 T 日的所有第三方支付交易引起的资金变动必 须一致 清算对账的处理流程 1 银银平台在 T 日日终时 将 T 日 0 00 24 00 已经与银银平台账务系统核对正确的第三方支付支 付 提现的第三方支付交易记录生成清算对账文件并保存 不同交易性质的第三方支付交易保存在同一个清 算对账文件中 按照交易性质排序与交易时间排序 2 银银平台按照事先约定的上传 URL 与文件名格式向第三方支付上传清算对账文件 如果上传文件 失败 银银平台有 6 次重试 3 银银平台以清算对账日期 时间与文件名等信息构造 清算对账通知 报文 CCNotify 告知第三方 支付清算对账文件已上传 4 第三方支付收到 清算对账通知 报文 CCNotify 后 从银银平台提供的清算对账文件中解析出每 一条第三方支付交易记录 与自己在该对账日期的所有第三方支付交易记录进行逐笔核对 找出并生成以下 三类交易记录的清单 A 银银平台有 但第三方支付没有的交易记录 银银平台技术规范 第十部分 代理快捷支付接口 22 B 第三方支付有 但银银平台没有的交易记录 C 双方都有 但内容不一致的交易记录 5 第三方支付对不一致的第三方支付交易记录进行恢复与处理 对于 A 类交易记录 第三方支付进行 交易恢复 使第三方支付对该笔交易的资金处理与银银平台一致 对于 B 类交易记录与 C 类交易记录 第 三方支付人工介入处理 通过核对原始的银银平台应答指令 找出原因并确定该由哪方进行订正 如果存在 需要银银平台进行调整的交易记录 则第三方支付线下提供给银银平台的需要调整的交易记录清单 以及原 始的银银平台应答指令 由银银平台在人工核实之后进行处理 文件格式文件格式 文件格式采用 CSV Comma Separated Variable 标准 清算对账 文件结构 清算对账文件包括当日银银平台发生的所有第三方支付账务交易数据 包括支付 提现清算对账文件由 汇总项与明细项两部分组成 汇总项为文件第一行 其中包含以下各项 中文名称中文名称出现要求出现要求备注备注 处理成功总金额R本批处理成功的总金额 格式见 金额格式说明 处理成功总笔数R本批处理成功的总笔数 处理失败总笔数R本批处理失败的总笔数 明细项从文件第二行开始直到文件结束 其中每一行包含以下各项 中文名称中文名称出现要求出现要求备注备注 流水号 订单号 R第三方支付公司流水号 交易日期RYYYYMMDD HH MM SS 交易类型R0 提现 1 支付 2 退货 银行卡 折号R这个字段不要填 留空即可 手续费O见金额格式说明 交易金额R见金额格式说明 交易货币代码O 原流水号C 原交易日期CYYYYMMDD 处理状态RY 成功 N 失败 失败原因R如果处理状态失败 则描述失败的原因 联网行编号R联网行编号 银银平台技术规范 第十部分 代理快捷支付接口 23 清算对账业务在执行中需要满足以下约束条件 银银平台在 T 1 日上午 8 00 点之前主动向第三方支付提供 T 日第三方支付转账联网行列表文件 清算对账的处理流程 1 银银平台在 T 日日终时 将 T 日 0 00 24 00 已经与银银平台开通柜面互通交易联网行记录生成 转账联网行列表文件并保存 2 银银平台按照事先约定的上传 URL 与文件名格式向第三方支付上传转账联网行列表文件 如果上 传文件失败 银银平台有 6 次重试 3 银银平台以日期 时间与文件名等信息构造 转账联网行列表通知 报文 TBLNotify 告知第三方 支付转账联网行列表文件已上传 文件格式文件格式 文件格式采用 CSV Comma Separated Variable 标准 转账联网行列表 文件结构 转账联网行列表文件包括转出联网行列表和转入联网行列表两部分组成 文件第一行开始直到文件结束 其中每一行包含以下各项 中文名称中文名称出现要求出现要求备注备注 联网行编号R联网行编号 联网行名称R联网行名称 转出转入标志R1 转出 2 转入 中间空一行 下面部分为转入联网行列表 结构同上 7 7 接口实现说明接口实现说明 序号序号交易名称交易名称实现方式实现方式 1签约验证必须 2网上支付必须 3单笔提现必须 4单笔实时查询必须 5中间账户查询必须 6单笔退货必须 7清算对账必须 银银平台技术规范 第十部分 代理快捷支付接口 24 8转账受理预处理银联支付用 9转账受理银联支付用 10冲正银联支付用 11转账联网行列表银联支付用 银联支付比较特殊 不必实现接口银联支付比较特殊 不必实现接口 1 6 其单独使用 其单独使用 8 11 这几个接口 这几个接口 7 1 签约验证签约验证 签约验证请求报文 CSVReq Card Sign Validation Request 签约验证请求是由第三方支付主动发起的请求 中文域名英文域名类型出现 要求 说明 版本号versionchar 7 R目前版本号 1 0 1 机构标识instIdchar 16 R报文发送方的机构标识 数字证书标识certIdchar 16 R对报文进行签名的数字证书标识 见 数字签名 交易时间datechar 17 RYYYYMMDD HH MM SS 银行卡 折户名accountNamechar 30 R对应银行卡 折的账户名称 银行卡 折号bankCardNochar 45 R银行卡 折号 银行卡 折类型bankCardTypechar 1 RD 借记卡或存折 C 贷记卡 证件类型certificateTypechar 1 R1 身份证 证件号码certficateNo char 30 R 手机号码mobilePhonechar 20 R用户在银行端预留的手机号 消息扩展extensionO 联网行编号bankNochar 5 R联网行编号 签约验证应答报文 CSVRes Card Sign Validation Response 中文域名英文域名类型出现 要求 说明 版本号versionchar 7 R目前版本号 1 0 1 机构标识instIdchar 16 R报文发送方的机构标识 数字证书标识certIdchar 16 R对报文进行签名的数字证书标识 见 数字签名 交易时间datechar 17 RYYYYMMDD HH MM SS 银行卡 折号bankCardNochar 45 R银行卡 折号 消息扩展extensionO 银银平台技术规范 第十部分 代理快捷支付接口 25 7 2 网上支付网上支付 网上支付请求 报文 CPReq Card Payment Request 网上支付报文请求 CPReq 是从第三方支付向银银平台发起的第三方支付支付请求 中文域名英文域名类型出现 要求 说明 版本号versionchar 7 R目前版本号 1 0 1 机构标识instIdchar 16 R报文发送方的机构标识 见数字签名 数字证书标识certIdchar 16 R对报文进行签名的数字证书标识 见 数字签名 流水号serialNochar 19 R对应第三方支付的支付订单号 交易日期和时间datechar 17 RYYYYMMDD HH MM SS 银行卡 折号bankCardNochar 45 R银行卡 折号 手续费chargeLong 12 C预留字段 交易金额amountLong 12 R见金额格式说明 交易货币代码currencychar 3 R见货币代码表 消息扩展extensionO 联网行编号bankNochar 5 R联网行编号 网上支付应答 报文 CPRes Card Payment Response 网上支付应答报文 CPRes 是银银平台返回给第三方支付 CPReq 的应答 中文域名英文域名类型出现 要求 说明 版本号versionchar 7 R目前版本号 1 0 1 机构标识instIdchar 16 R报文发送方的机构标识 见数字签名 数字证书标识certIdchar 16 R对报文进行签名的数字证书标识 见 数字签名 流水号serialNochar 19 R支付流水号 银行卡 折号bankCardNochar 45 R银行卡 折号 交易金额是否透支overdraftchar 1 R交易金额是否通过透支获得 消息扩展extensionC 7 3 单笔提现单笔提现 单笔提现请求 报文 SWReq Single Withdraw Request 单笔提现请求报文 SWReq 是第三方支付向银银平台发起的单笔提现请求 中文域名英文域名类型出现 要求 说明 版本号versionchar 7 R目前版本号 1 0 1 银银平台技术规范 第十部分 代理快捷支付接口 26 机构标识instIdchar 16 R报文发送方的机构标识 见数字签名 数字证书标识certIdchar 16 R对报文进行签名的数字证书标识 见 数字签名 流水号serialNochar 19 R 交易日期和时间datechar 17 RYYYYMMDD HH MM SS 银行卡 折号bankCardNochar 45 R银行卡 折号 手续费chargeLong 12 R预留字段 见金额格式说明 交易金额amountLong 12 R见金额格式说明 交易货币代码currencychar 3 R见货币代码表 消息扩展extensionO 联网行编号bankNochar 5 R联网行编号 单笔提现应答 报文 SWRes Single Withdraw Response 单笔提现应答报文 SWRes 是银银平台返回给第三方支付 SWReq 的应答 中文域名英文域名类型出现 要求 说明 版本号versionchar 7 R目前版本号 1 0 1 机构标识instIdchar 16 R报文发送方的机构标识 见数字签名 数字证书标识certIdchar 16 R对报文进行签名的数字证书标识 见 数字签名 流水号serialNochar 19 R提现流水号 银行卡 折号signNochar 45 R来自 SWReq 7 4 单笔实时查询单笔实时查询 单笔交易查询请求 报文 STQReq Single Trade Query Request 中文域名英文域名类型出现 要求 说明 版本号versionchar 7 R目前版本号 1 0 1 机构标识instIdchar 16 R报文发送方的机构标识 见数字签名 数字证书标识certIdchar 16 R对报文进行签名的数字证书标识 见 数字签名 交易日期datechar 17 RYYYYMMDD HH MM SS 交易性质typechar 1 R0 提现 1 支付 交易订单号serialNochar 19 R要查询的第三方支付订单号 必须保 证在所有业务及日期中唯一 联网行编号bankNochar 5 R联网行编号 单笔实时查询应答报文 单笔交易查询接受 应答报文 STQRes Single Trade Query Response 银银平台技术规范 第十部分 代理快捷支付接口 27 中文域名英文域名类型出现 要求 说明 版本号versionchar 7 R目前版本号 1 0 1 机构标识instIdchar 16 R报文发送方的机构标识 见数字签名 数字证书标识certIdchar 16 R对报文进行签名的数字证书标识 见 数字签名 交易性质typechar 1 R0 提现 1 支付 交易订单号serialNochar 19 R 交易日期datechar 17 R 银