![快钱支付清算信息有限公司 版权所有 第 8 页
payerContactType 支 付 人 联 系
方式类型
2 可为空 固定值：1 或者 2
1 代表电子邮件方式；2 代表手机联系方式
payerContact 支 付 人 联 系
方式
50 可为空 字符串
根据 payerContactType 的方式填写对应字符，邮
箱或者手机号码
payerIdType 指定付款人 2 可为空 数字串
类型固定值 0，1，2，3
0 代表不指定
1 代表通过商户方 ID 指定付款人
2 代表通过快钱账户指定付款人
3 代表付款方在商户方的会员编号(当需要支持保
存信息功能的快捷支付时，,需上送此项)
4 代表公司网银的交通银行直连
如果为空代表不需要指定
payerId 付款人标识 50 可为空 字符串
当公司网银中的交通银行直连，此值不能为空。此
参数需要传入交行公司网银的付款方银行账号
当需要支持保存信息功能的快捷支付时，此值不能
为空，此参数需要传入付款方在商户方的会员编号
payerIP 付款人 IP 15 可为空 付款人 IP，商家传递获取到的客户端 IP
业务参数
orderId 商户订单号 30 不可空 字符串
只允许使用字母、数字、- 、_,并以字母或数字开
头
每商户提交的订单号，必须在自身账户交易中唯一
orderAmount 商 户 订 单 金
额
10 不可空 整型数字
以分为单位。比方 10 元，提交时金额应为 1000,
商户页面显示金额可以转换成以元为单位显示
orderTime 商 户 订 单 提
交时间
14 不可空 数字串，一共 14 位
格式为：年[4 位]月[2 位]日[2 位]时[2 位]分[2 位]
秒[2 位]
例如：20071117020101
orderTimestamp 快钱时间戳 14 可为空
（ 高 钓 鱼
风 险 商 户
必填）
数字串，一共 14 位
格式为：年[4 位]月[2 位]日[2 位]时[2 位]分[2 位]
秒[2 位]
例如：20071117020101
productName 商品名称 256 可为空 英文或中文字符串
productNum 商品数量 8 可为空 整型数字
productId 商品代码 20 可为空
字母、数字或 - 、_ 的组合](https://image.slidesharecdn.com/v303-160809133504/85/V3-0-3-8-320.jpg)
![快钱支付清算信息有限公司 版权所有 第 11 页
与提交订单时的商户订单金额保持一致
bindCard 已绑短卡号 10 数字串
可为空
信用卡快捷支付绑定卡信息后返回前六后四位信用卡号
bindMobile 已 绑 短 手 机
尾号
7 数字串
可为空
信用卡快捷支付绑定卡信息后返回前三位后四位手机号码
dealId 快钱交易号 30 数字串
该交易在快钱系统中对应的交易号
bankDealId 银行交易号 30 数字串
该交易在银行支付时对应的交易号，如果不是通过银行卡支付，则
为空
dealTime 快 钱 交 易 时
间
14 数字串
快钱对交易进行处理的时间,格式为：年[4 位]月[2 位]日[2 位]时[2
位]分[2 位]秒[2 位]
payAmount 订 单 实 际 支
付金额
10 整型数字
返回在使用优惠券等情况后，用户实际支付的金额
以分为单位。比方 10 元，提交时金额应为 1000
fee 费用 10 整型数字
快钱收取商户的手续费，单位为分（CNP 支付、快捷支付等非实
时结算类交易，通知时值为 0）。
ext1 扩展字段 1 128 字符串
与提交订单时的扩展字段 1 保持一致
ext2 扩展字段 2 128 字符串
与提交订单时的扩展字段 2 保持一致
payResult 处理结果 2 10：支付成功
errCode 错误代码 10 失败时返回的错误代码，可以为空。
详细资料见下文参考资料。
signMsg 签名字符串 1024 对于所有值不为空的参数及对应值，按照如上顺序及如下规则组成
字符串
DSA 或 RSA 方式：参数 1={参数 1}&参数 2={参数 2}&……&参
数 n={参数 n}然后进行快钱证书加密形成密文后进行 1024 位的
Base64 转码。
2.3.3 短链接支付
商户采用短链接支付时，先向快钱服务器提交支付报文，收到快钱提交成功的响应报文后使用
短链接地址跳转到快钱支付。
短链接支付订单提交地址：](https://image.slidesharecdn.com/v303-160809133504/85/V3-0-3-11-320.jpg)
![快钱支付清算信息有限公司 版权所有 第 14 页
{ext1}&ext2={ext2}&payResult={payResult}&errCode={errCode}
注：商户使用快钱生成的快钱公钥进行加密。
所有参与签名的参数及其值的大小写必须与示例保持一致。
2.4.2 使用 PKI-应用安全认证开发工具包（PKI-ASAP-SDK）
快钱目前支持三种数据安全策略,分别为:签名[Key]、签名[证书]、签名-加密[证书]。
三种安全策略比较:
安全策略 描述 安全级别
签名[Key] 将数据和 Key(自定义契
约密钥)组合后进行摘要
安全级别低，契约密钥安全性比较低。
在契约密钥安全情况下能保障数据不可
篡改性。--不建议使用
签名[证书] 使用证书和非对称签名算
法对数据进行签名
安全级别中，能够保障数据的不可篡改
性和不可抵赖性。
签名-加密[证书] 使用证书和非对称算法对
数据签名，使用一次一密
的密钥和对称算法对数据
进行加密
安全级别高，能够保障数据的不可篡改
性和不可抵赖性，而且能够保障数据的
私密性。
PKI-ASAP-SDK 工具包可以方便实现这三种安全策略。
1、从快钱获取最新的 pki-asap-sdk 包。
2、确定您使用的安全策略，我们推荐使用最高安全级别的方式签名-加密[证书]。
3、确定您使用的证书生成方式:DSA 或 RSA。请参考《ASAP-OpenSSL 证书生成手册.doc》。
4、生成商户数字证书后，请登录快钱系统 www.99bill.com/安全中心上传人民币网关商户数字](https://image.slidesharecdn.com/v303-160809133504/85/V3-0-3-14-320.jpg)
![[DCTPE2010] 綠界科技-網路金流機制服務簡介](https://cdn.slidesharecdn.com/ss_thumbnails/dctpe2010-greenworld-100912091641-phpapp02-thumbnail.jpg?width=560&fit=bounds)
More Related Content
Viewers also liked (6)
Similar to 快钱移动网关支付接口文档 V3 0 3 (13)
快钱移动网关支付接口文档 V3 0 3
- 2. 快钱支付清算信息有限公司 版权所有 第 2 页 修订历史 版本号 作者 更新章节 更新内容 更新日期 V2.0 快钱 全版修改 1、 整合普通版，高级版，防钓鱼，风控字段， 信用卡支付，手机语音 2、 更新银行代码表 3、 更新错误代码表 4、 更新技术支持联系方式 5、 加入快钱支付图片、银行 logo 下载资源 6、 增加了信用卡快捷支付所需信息 7、 增加公司网银直连 2011-8-25 V2.0 快钱 3.2 章节 增加新银联 UPOP 代码 2011-09-14 V2.0 快钱 2.3 和 3.3 章节 删除 MD5 加密方式，加入实名验证错误码、 加入中国银行公司网银支付 2011-09-16 V2.0.1 快钱 更新快钱 logo 更新文档 logo 2012-1-13 V2.0.2 快钱 2.3.1 章节 修改 inputCharset 为必填参数 2012-3-21 V2.0.3 快钱 2.3.1 和 3.2 章节 增加交通银行和兴业银行公司网银支付（支持 直连） 2012-4-17 V2.0.4 快钱 3.2 章节 删除广州农商银行直连代码 2012-7-16 V2.0.5 快钱 2.3.1、2.4.1 章节 加入之前上线的后台提交线下支付 （remitType、remitCode、submitType 三个） 参数 2012-8-6 V2.0.6 快钱 2.3.1 章节 修改 bankId 参数，当 payType=15 的时候也 支持 CNP 网关直连 2012-8-31 V2.0.7 快钱 2.3.1 章节 修改 payerIdType 、payerId、payType 和 bankId 参数 2012-10-31 V2.0.9 快钱 2.3.1 2.4.1 章节 增加交易超时时间参数(orderTimeOut) 2013-6-17 V3.0.0 快钱 3.2 章节 增加大连银行、江苏银行、光大银行 BANKID 2013-7-19 V3.0.1 快钱 2.3.1 章节 修改参数 cardIssuer cardNum 支持快钱发行 卡的描述 2013-9-29 V3.0.2 快钱 2.3.1 章节，2.3.3 章节 描述增加交易 30 秒内有效 修改交易超时时间参数(orderTimeOut)描述 2013-11-21 V3.0.3 快钱 增加移动网关 2013-11-28
- 3. 快钱支付清算信息有限公司 版权所有 第 3 页 目 录 1. 文档说明 .........................................................................................................................................................5 1.1 文档目标 ........................................................................................................................................ 5 1.2 阅读对象 ........................................................................................................................................ 5 1.3 相关约定 ........................................................................................................................................ 5 1.4 技术支持 ........................................................................................................................................ 6 2. 接口开发 .........................................................................................................................................................6 2.1 功能说明及流程 ............................................................................................................................ 6 2.2 开发准备 ........................................................................................................................................ 6 2.3 参数说明 ........................................................................................................................................ 7 2.3.1 商户提交到快钱................................................................................................................. 7 2.3.2 快钱返回到商户............................................................................................................... 10 短链接支付.................................................................................................................................. 11 2.3.3 商户查询交易时间戳..................................................................... 错误! 未定义书签。 2.4 开发提示 ...................................................................................................................................... 12 2.4.1 签名字符串....................................................................................................................... 12 2.4.2 使用 PKI-应用安全认证开发工具包（PKI-ASAP-SDK） .......................................... 14 2.4.3 通知支付结果................................................................................................................... 15 2.4.4 商户对支付结果的处理................................................................................................... 16 2.5 安全要点 ...................................................................................................................................... 16
- 4. 快钱支付清算信息有限公司 版权所有 第 4 页 2.5.1 数据校验............................................................................................................................ 16 2.5.2 对账.................................................................................................................................... 17 2.6 特殊定制 ...................................................................................................................................... 17 2.6.1 绑定快钱服务器 IP ........................................................................................................... 17 3. 参考资料 .......................................................................................................................................................17 3.1 常见问题 ...................................................................................................................................... 17 3.1.1 如何获取收款账户的账号............................................................................................... 17 3.1.2 如何查询网关交易记录.................................................................................................... 18 3.1.3 如何自助补发支付结果................................................................................................... 18 3.2 银行代码表 .................................................................................................................................. 19 银行代码列表：.......................................................................................................................... 19 3.3 错误代码表 .................................................................................................................................. 20 4 附录 .................................................................................................................................................................25 4.1 版权说明 ....................................................................................................................................... 25 4.1 快钱资源 ...................................................................................................................................... 26
- 5. 快钱支付清算信息有限公司 版权所有 第 5 页 1. 文档说明 1.1 文档目标 本文档的目的是为快钱人民币支付网关平台定义一个接口规范，以帮助商户技术人员接入快 钱人民币支付网关，并快速掌握快钱人民币支付网关相关功能，便于尽快投入使用。 1.2 阅读对象 快钱人民币支付网关商户的网上应用开发人员、维护人员和管理人员。 他们应具备以下基本知识： l 了解 MICROSOFT WINDOWS/NT、WINDOWS9X、WINDOWS 2000、HP-UX、AIX、 SUN SOLARIS、LINUX、BSD 等操作系统的其中一种； l 了解上述系统上的网站设置和网页制作方法； l 了解 HTML 语言以及 CGI（COMMON GATEWAY INTERFACE）或 ASP（ACTIVE SERVER PAGES）或 PHP 或 JAVA 等开发语言； l 了解信息安全的基本概念。 1.3 相关约定 商户：指已注册成为快钱用户、并使用快钱产物实现其收付费功能需求、为其用户提供各类产 品或者相关服务的公司或个人。 用户：指在商户网站等系统购物的公司或个人。 购物：指用户在商户网站购买相关产物或服务。
- 6. 快钱支付清算信息有限公司 版权所有 第 6 页 {XXX}：XXX 前后分别加{和}，表示名称为 XXX 的变量所对应的值。 1.4 技术支持 如果您有任何技术上的疑问，可按如下方式寻求帮助： 技术支持邮箱：support@99bill.com 技术支持时间：周一到周五 9:00-18:00 2. 接口开发 2.1 功能说明及流程 用户向商户购物时，需要通过一定方式向商户支付相关费用。商户网站系统如果集成了快钱人 民币支付网关，可以让用户很方便向商户支付相关款项，并且商户也可以很容易了解到款项的 到帐情况及用户购买的产物或服务。 整体流程如下： 用户在商户选择产物或服务，在下订单完成后，商户网站等系统会将该订单号及对应订单金额 以及收款方信息等相关资料提交到快钱，然后跳转到快钱页面进行支付。当支付完成后，快钱 通知商户支付结果，并且根据商户指定的地址跳转到商户指定页面。商户在接收到支付结果之 后，可以对数据库进行相应更新，然后在显示给用户的页面中作出相应提示。 2.2 开发准备 商户开发人员应该仔细阅读本协议以及注意事项，并准备好如下信息： l 商户在快钱的用于收款的人民币账号
- 7. 快钱支付清算信息有限公司 版权所有 第 7 页 l 商户的人民币网关密钥 l 如果是使用 PKI 方式，接入前要准备好商户证书，可以用 OPENSSL 工具生成，具 体生成命令可以参考 OPENSSL 命令集，OPENSSL 工具可以从快钱后台下载，也 可以从技术支持处获得。 2.3 参数说明 2.3.1 商户提交到快钱 提交地址 https://www.99bill.com/mobilegateway/recvMerchantInfoAction.htm (推荐！） 或 http://www.99bill.com/mobilegateway/recvMerchantInfoAction.htm 参数名称 参数含义 长度 可否为空 参数说明 协议参数 inputCharset 字符集 2 不可空 固定选择值：1、2、3 1 代表 UTF-8; 2 代表 GBK; 3 代表 GB2312 pageUrl 接 受 支 付 结 果 的 页 面 地 址 256 可为空 需要是绝对地址，与 bgUrl 不能同时为空 当 bgUrl 为空时，快钱直接将支付结果 GET 到 pageUrl 当 bgUrl 不为空时，按照 bgUrl 的方式返回 bgUrl 服 务 器 接 受 支 付 结 果 的 后台地址 256 可为空 需要是绝对地址，与 pageUrl 不能同时为空 快钱将支付结果发送到 bgUrl 对应的地址，并且获 取商户按照约定格式输出的地址，显示页面给用户 version 网关版本 10 不可空 固定值：mobile1.0 注意为小写字母 移动网关：mobile1.0 mobileGateway 移 动 网 关 版 本 10 可为空 移动网关版本，当 version= mobile1.0 时有效 phone 代表手机版移动网关，pad 代表平板移动网 关，默认为 phone language 网 关 页 面 显 示语言种类 2 不可空 固定值：1 1 代表中文显示 signType 签名类型 2 不可空 4 代表 DSA 或者 RSA 签名方式 买卖双方信息参数 merchantAcctId 人民币账号 30 不可空 数字串 本参数用来指定接收款项的人民币账号 payerName 支付人姓名 32 可为空 英文或中文字符
- 8. 快钱支付清算信息有限公司 版权所有 第 8 页 payerContactType 支 付 人 联 系 方式类型 2 可为空 固定值：1 或者 2 1 代表电子邮件方式；2 代表手机联系方式 payerContact 支 付 人 联 系 方式 50 可为空 字符串 根据 payerContactType 的方式填写对应字符，邮 箱或者手机号码 payerIdType 指定付款人 2 可为空 数字串 类型固定值 0，1，2，3 0 代表不指定 1 代表通过商户方 ID 指定付款人 2 代表通过快钱账户指定付款人 3 代表付款方在商户方的会员编号(当需要支持保 存信息功能的快捷支付时，,需上送此项) 4 代表公司网银的交通银行直连 如果为空代表不需要指定 payerId 付款人标识 50 可为空 字符串 当公司网银中的交通银行直连，此值不能为空。此 参数需要传入交行公司网银的付款方银行账号 当需要支持保存信息功能的快捷支付时，此值不能 为空，此参数需要传入付款方在商户方的会员编号 payerIP 付款人 IP 15 可为空 付款人 IP，商家传递获取到的客户端 IP 业务参数 orderId 商户订单号 30 不可空 字符串 只允许使用字母、数字、- 、_,并以字母或数字开 头 每商户提交的订单号，必须在自身账户交易中唯一 orderAmount 商 户 订 单 金 额 10 不可空 整型数字 以分为单位。比方 10 元，提交时金额应为 1000, 商户页面显示金额可以转换成以元为单位显示 orderTime 商 户 订 单 提 交时间 14 不可空 数字串，一共 14 位 格式为：年[4 位]月[2 位]日[2 位]时[2 位]分[2 位] 秒[2 位] 例如：20071117020101 orderTimestamp 快钱时间戳 14 可为空 （ 高 钓 鱼 风 险 商 户 必填） 数字串，一共 14 位 格式为：年[4 位]月[2 位]日[2 位]时[2 位]分[2 位] 秒[2 位] 例如：20071117020101 productName 商品名称 256 可为空 英文或中文字符串 productNum 商品数量 8 可为空 整型数字 productId 商品代码 20 可为空 字母、数字或 - 、_ 的组合
- 9. 快钱支付清算信息有限公司 版权所有 第 9 页 如商户发布了优惠券，并只想对指定的某商品或某 类商品进行优惠时，请将此参数与发布优惠券时设 置的“适用商品”保持一致。只可填写一个代码。 如果不使用优惠券，本参数不用填写 productDesc 商品描述 400 可为空 英文或中文字符串 ext1 扩展字段 1 128 可为空 英文或中文字符串 支付完成后，按照原样返回给商户 ext2 扩展字段 2 128 可为空 英文或中文字符串 支付完成后，按照原样返回给商户 payType 支付方式 2 不可空 固定选择值：00、15、21、21-1、21-2 00 代表显示快钱各支付方式列表； 15 信用卡无卡支付 21 快捷支付 21-1 代表储蓄卡快捷；21-2 代表信用卡快捷 *其中”-”只允许在半角状态下输入。 bankId 银行代码 8 可为空 银行的代码，仅在银行直连/快捷支付指定银行定制 时使用。 快捷支付指定银行定制:payType=21-1,21-2 无卡支持指定银行定制:payType=15 银行代码表见本文档 3.2 章节; 指定银行定制默认开通. cardIssuer 发卡机构 20 可为空 字符串，固定值 cardNum 卡号 19 可为空 整形数字 提交给快钱的支付卡号 redoFlag 同 一 订 单 禁 止 重 复 提 交 标志 1 可为空 固定选择值： 1、0 1 代表同一订单号只允许提交 1 次；0 表示同一订 单号在没有支付成功的前提下可重复提交多次。 默认为 0 建议实物购物车结算类商户采用 0；虚拟产物类商 户采用 1； submitType 提交方式 2 可为空 00:代表前台提交 01：代表后台提交 为空默认为前台提交。 orderTimeOut 交 易 超 时 时 间 10 可为空 正整数,0~ 2592000（30 天） 单位为秒 默认为空，为空表示订单无超时时间 订单超时计算规则：订单支付成功时间 减去 订单 提交时间（orderTime） 大于 订单超时时间 （orderTimeOut） 超时成功订单，快钱会自动发起退款。 extDataType 附 加 信 息 类 型 1024 可为空 字符串
- 10. 快钱支付清算信息有限公司 版权所有 第 10 页 extDataContent 附加信息 4000 可为空 XML 格式 signMsg 签名字符串 1024 不可空 参数 1={参数 1}&参数 2={参数 2}&……&参数 n={参数 n}然后进行商户私钥证书加密形成密文后 进行 1024 位的 Base64 转码。 商户交易参考信息参数（不包含在报文加签中） referDataType 参 考 交 易 信 息类型 7 可为空 数字字符串 3 位交易的行业类型+3 位版本号 详见风险交易参考信息规则文档 referData 参 考 交 易 信 息 4000 可为空 字符串(XML 或其他格式) 用于交易风险控制的交易参考信息 商户可以选择不同版本的参考信息规则 详见风险交易参考信息规则文档 2.3.2 快钱返回到商户 在用户支付完成之后，快钱会给商户返回如下数据： 返回地址 pageUrl 或 bgUrl 对应的地址 只填写 pageUrl 时，或者 bgUrl 所指定的地址不可用时，快钱会将支付结果直接以 GET 方 式发送到 pageUrl 对应的地址 参数名称 参数含义 长度 参数说明 快钱反馈的参数 merchantAcctId 人民币账号 30 数字串 与提交订单时的快钱账号保持一致 version 网关版本 10 固定值：v2.0 与提交订单时的网关版本号保持一致 language 网 页 显 示 语 言种类 2 固定选择值：1 1 表示快钱支付网关网页是中文显示 signType 签名类型 2 固定值：4 与提交订单时的签名类型保持一致 payType 支付方式 2 固定选择值：00、10、11、12、13、14、15、17、19、21、22 与提交订单时的支付方式保持一致 bankId 银行代码 8 字符串 返回用户在实际支付时所使用的银行代码 orderId 商户订单号 30 与提交订单时的商户订单号保持一致 orderTime 商 户 订 单 提 交时间 14 数字串 与提交订单时的商户订单提交时间保持一致 orderAmount 商 户 订 单 金 额 10 整型数字 以分为单位。比方 10 元，提交时金额应为 1000
- 11. 快钱支付清算信息有限公司 版权所有 第 11 页 与提交订单时的商户订单金额保持一致 bindCard 已绑短卡号 10 数字串 可为空 信用卡快捷支付绑定卡信息后返回前六后四位信用卡号 bindMobile 已 绑 短 手 机 尾号 7 数字串 可为空 信用卡快捷支付绑定卡信息后返回前三位后四位手机号码 dealId 快钱交易号 30 数字串 该交易在快钱系统中对应的交易号 bankDealId 银行交易号 30 数字串 该交易在银行支付时对应的交易号，如果不是通过银行卡支付，则 为空 dealTime 快 钱 交 易 时 间 14 数字串 快钱对交易进行处理的时间,格式为：年[4 位]月[2 位]日[2 位]时[2 位]分[2 位]秒[2 位] payAmount 订 单 实 际 支 付金额 10 整型数字 返回在使用优惠券等情况后，用户实际支付的金额 以分为单位。比方 10 元，提交时金额应为 1000 fee 费用 10 整型数字 快钱收取商户的手续费，单位为分（CNP 支付、快捷支付等非实 时结算类交易，通知时值为 0）。 ext1 扩展字段 1 128 字符串 与提交订单时的扩展字段 1 保持一致 ext2 扩展字段 2 128 字符串 与提交订单时的扩展字段 2 保持一致 payResult 处理结果 2 10：支付成功 errCode 错误代码 10 失败时返回的错误代码，可以为空。 详细资料见下文参考资料。 signMsg 签名字符串 1024 对于所有值不为空的参数及对应值，按照如上顺序及如下规则组成 字符串 DSA 或 RSA 方式：参数 1={参数 1}&参数 2={参数 2}&……&参 数 n={参数 n}然后进行快钱证书加密形成密文后进行 1024 位的 Base64 转码。 2.3.3 短链接支付 商户采用短链接支付时，先向快钱服务器提交支付报文，收到快钱提交成功的响应报文后使用 短链接地址跳转到快钱支付。 短链接支付订单提交地址：
- 12. 快钱支付清算信息有限公司 版权所有 第 12 页 https://www.99bill.com/mobilegateway/recvMerchantBackendPostOrderAction.htm 提交成功返回的报文格式： <?xml version="1.0" encoding="utf-8"?> <res> <version>v2.0</version> <orderId>{orderId}</orderId> <merchantAcctId>{merchantAcctId}</merchantAcctId> <orderAmount>{orderAmount}</orderAmount> <requestResult>10</requestResult> <para>${para}</para> <orderTime>{yyyyMMDDHH24MIss}</orderTime> <errCode>00</errCode> <errMessage></errMessage> </res> 提交处理失败返回的报文格式 <?xml version="1.0" encoding="utf-8"?> <res> <version>v2.0</version> <orderId>{orderId}</orderId> <merchantAcctId>{merchantAcctId}</merchantAcctId> <orderAmount>{orderAmount}</orderAmount> <requestResult>11</requestResult> <para></para> <orderTime>{yyyyMMDDHH24MIss}</orderTime> <errCode>xxxx</errCode> <errMessage>xxxx</errMessage> </res> 支付订单提交成功之后，使用下面链接地址进支付，${para}为提交订单时快钱返回的短链接支付参 数。 https://www.99bill.com/mobilegateway/recvLinkPay.htm?para=${para} 短链接支付链接有效期为 7 天，超过 7 天的链接订单不允许支付。 2.4 开发提示 2.4.1 签名字符串 支付网关接口，在商户提交订单到快钱时和快钱返回结果给商户时都含有签名字符串 signMsg，但两个签名字符串并无直接联系。DSA 或 RSA 方式都是非对称的加密方式，商户 提交用商户私钥证书加密，快钱通过商户的公钥证书来解密；快钱返回时是通过快钱私钥证书 加密，商户用快钱公钥证书解密来验签。
- 13. 快钱支付清算信息有限公司 版权所有 第 13 页 . 当 signType=4 时，加密串为： inputCharset={inputCharset}&pageUrl={pageUrl}&bgUrl={bgUrl}&version={ version}&language={language}&signType={signType}&merchantAcctId={me rchantAcctId}&payerName={payerName}&payerContactType={payerContact Type}&payerContact={payerContact}&payerIdType={payerIdType}&payerId ={payerId}&payerIP={payerIP}&orderId={orderId}&orderAmount={orderAm ount}&orderTime={orderTime}&orderTimestamp={orderTimestamp}&produ ctName={productName}&productNum={productNum}&productId={product Id}&productDesc={productDesc}&ext1={ext1}&ext2={ext2}&payType={payT ype}&bankId={bankId}&cardIssuer={cardIssuer}&cardNum={cardNum}&rem itType={remitType}&remitCode={remitCode}&redoFlag={redoFlag}&pid={pi d}&submitType={submitType}&orderTimeOut={orderTimeOut}&mobileGate way={mobileGateway}&extDataType={extDataType}&extDataContent={extD ataContent} 注：商户使用商户生成的商户私钥进行加密。 l 快钱返回给商户时的组成加密串的示例如下（假定全部参数值都不为空）： 当 signType=4 时，加密串为： merchantAcctId={merchantAcctId}&version={version}&language={language }&signType={signType}&payType={payType}&bankId={bankId}&orderId={o rderId}&orderTime={orderTime}&orderAmount={orderAmount}&bindCard= {bindCard}&bindMobile={bindMobile}&dealId={dealId}&bankDealId={bank DealId}&dealTime={dealTime}&payAmount={payAmount}&fee={fee}&ext1=
- 14. 快钱支付清算信息有限公司 版权所有 第 14 页 {ext1}&ext2={ext2}&payResult={payResult}&errCode={errCode} 注：商户使用快钱生成的快钱公钥进行加密。 所有参与签名的参数及其值的大小写必须与示例保持一致。 2.4.2 使用 PKI-应用安全认证开发工具包（PKI-ASAP-SDK） 快钱目前支持三种数据安全策略,分别为:签名[Key]、签名[证书]、签名-加密[证书]。 三种安全策略比较: 安全策略 描述 安全级别 签名[Key] 将数据和 Key(自定义契 约密钥)组合后进行摘要 安全级别低，契约密钥安全性比较低。 在契约密钥安全情况下能保障数据不可 篡改性。--不建议使用 签名[证书] 使用证书和非对称签名算 法对数据进行签名 安全级别中，能够保障数据的不可篡改 性和不可抵赖性。 签名-加密[证书] 使用证书和非对称算法对 数据签名，使用一次一密 的密钥和对称算法对数据 进行加密 安全级别高，能够保障数据的不可篡改 性和不可抵赖性，而且能够保障数据的 私密性。 PKI-ASAP-SDK 工具包可以方便实现这三种安全策略。 1、从快钱获取最新的 pki-asap-sdk 包。 2、确定您使用的安全策略，我们推荐使用最高安全级别的方式签名-加密[证书]。 3、确定您使用的证书生成方式:DSA 或 RSA。请参考《ASAP-OpenSSL 证书生成手册.doc》。 4、生成商户数字证书后，请登录快钱系统 www.99bill.com/安全中心上传人民币网关商户数字
- 15. 快钱支付清算信息有限公司 版权所有 第 15 页 证书（公钥），并下载快钱公钥证书。 5、根据《ASAP 应用程序开发包操作手册》完成程序的配置和开发。 提醒：如果商户接入了快钱的多个应用或通过多个帐号接入网关，需要为不同的应用和每个帐号 配置不同的商户应用安全策略，并在不同的应用中调用相应的商户应用安全策略配置。 2.4.3 通知支付结果 快钱提供了两个参数用于商户指定接收支付结果页面。一个是 pageUrl，一个是 bgUrl， 两个参数不能同时为空。如果两个参数同时填写，会优先按照 bgUrl 的方式。现分别描述 如下： l 只填写 pageUrl 时，快钱会将支付结果直接以 GET 方式发送到 pageUrl 对应的地址， 确定连接到接受地址后只发送一次通知。商户接收到支付结果之后，根据支付结果进 行相应的处理，并且给支付人显示页面提示信息。商户仍然需要对重复接收支付结果 进行判断，以防止因刷新引起重复接收支付结果而进行误处理。 l 如果填写了 bgUrl，快钱会将支付结果以 GET 方式发送到 bgUrl 对应的地址，商户 接收到支付结果，并且进行相应处理之后，需要按照指定的方式输出内容，告诉 快钱已经成功接收并处理完毕。示例如下： <result>1</result><redirecturl>http://www.yoursite.com/show.asp</redire cturl> 如果 result 标签里面的值为数字 1 时，快钱会认为商户已经接收到支付结果并成功处 理，快钱会按照 redirecturl 标签里面提供的地址，跳转到新的页面，同时把支付信 息参数再次带过来。用户可以在新的页面里面看到商户给出的页面提示信息。 如果 result 标签里面的值不为数字 1 时，快钱会在 18 小时内，不断按照如上方式给
- 16. 快钱支付清算信息有限公司 版权所有 第 16 页 商户发送支付结果并判断 result 的值，直到 result 的值为 1 为止。在历次重复发送 中，初期快钱发送时间间隔为 5 秒，以后发送的时间间隔会逐步加长。 快钱可能会根据需要调整支付结果通知的频率和次数。 2.4.4 商户对支付结果的处理 l 商户在接收到快钱的支付结果之后，基于安全的考虑，请务必要判断同一订单号是否 已经针对支付成功的情况进行过处理。特别是对于一些使用快钱提供充值功能的商户， 必须严格防止对同一订单对用户多次进行充值。如果同一订单号，已经按照支付成功 的情况进行过处理，商户再次接收到时则不要重复处理。 l 因网络或银行服务器原因，快钱可能第一次发送支付失败的结果给商户，但后来会对 同一订单号发送支付成功的信息给商户。商户应在保证对加密验证串等信息严格验证 的前提下，对相同订单号按照支付成功的业务逻辑进行处理。即商户收到的支付结果 通知有失败也有成功，以成功信息为准进行支付成功相关业务处理。 l 可能会由于网络或者用户刷新页面的原因，商户的页面可能短时间内会多次接收到支 付结果信息，而支付人看到的只能是最后的页面。商户最好能在后续的提示中，给出 让支付人不易误解的提示信息。 2.5 安全要点 2.5.1 数据校验 商户在接收快钱系统交易通知后，除了对签名字符串进行校验以外，还应当对返回数据中的关 键数据与提交前的相应数据进行对比校验，如将快钱返回的订单金额与提交时对应的订单金额 进行对比，防止恶意欺骗。
- 17. 快钱支付清算信息有限公司 版权所有 第 17 页 2.5.2 对账 对快钱已经提供查询接口的产物，商户请尽量接入查询接口，以便通过查询接口对账及时发现 和处理异常交易。 商户如果无法使用查询接口，可以登陆快钱系统直接查询或下载交易记录，与商户自身网关交 易记录进行对账。 如果发现异常情况，请及时和快钱人员联系处理。 2.6 特殊定制 2.6.1 绑定快钱服务器 IP 对于高风险性商户（如提供虚拟服务及数字卡的商户），在接收快钱支付结果通知页面对数据 来源服务器 IP 进行判断，拒收非快钱 IP 源的通知数据，避免因虚假数据造成误处理。 绑定快钱服务器 IP 时，推荐使用 bgUrl 方式接收快钱支付结果通知。 快钱服务器 IP 地址请向快钱技术支持人员索取。 3. 参考资料 3.1 常见问题 3.1.1 如何获取收款账户的账号 商户使用快钱账户 Email 以及密码登陆快钱网站 www.99bill.com 之后，依次点击【我 的快钱】“账户首页”的中上位置显示了快钱的“用户编号”。 商户如果需要使用人民币支付网关，那么商户的人民币账户号{merchantAcctId}就为
- 18. 快钱支付清算信息有限公司 版权所有 第 18 页 用户编号后面附加数字 01，即{用户编号}01 3.1.2 如何查询网关交易记录 商户使用快钱账户 Email 以及密码登陆快钱网站 http://www.99bill.com 之后，依次 点击【我的快钱】“查询”“交易查询”，选择账户为“人民币账户”，“交易类型”为 “支付网关”，然后点击查询按钮，即可查询到网关交易记录列表。 点击每条交易记录后面的“查看”，可以查看该交易的详细信息。 3.1.3 如何自助补发支付结果 商户如果发现有交易记录在快钱系统显示为成功，但是却并未收到快钱返回的支付结果， 且时间已经超过快钱系统的自动补发时间范围。在这样的情况下，商户程序如果支持后台 接收快钱返回的支付结果，并会根据支付结果由程序自动进行处理，商户完全可以自助操 作，使该笔交易结果在商户网站和快钱网站之间同步。 商户可参照如上“如何查询网关交易记录”问题解答的步骤，使用快钱账户登陆并查看人 民币支付网关交易的详细信息。在交易详细信息页面的“状态”栏后面，如果状态为“交 易成功”，系统会自动显示“通知商户付款成功”链接。当商户点击“通知商户付款成功” 链接之后，快钱系统会通过后台方式，给商户网站重新发送一遍该交易的支付结果，商户 程序可以进行接收并进行后续处理。如果交易状态不为成功，则不显示“通知商户付款成 功”链接。
- 19. 快钱支付清算信息有限公司 版权所有 第 19 页 3.2 银行代码表 银行代码列表： 银行代码 银行名称 银行代码 银行名称 CMB 招商银行 SRCB 上海农村商业银行 ICBC 中国工商银行 BOB 北京银行 ABC 中国农业银行 CBHB 渤海银行 CCB 中国建设银行 BJRCB 北京农商银行 BOC 中国银行 NJCB 南京银行 SPDB 浦发银行 CEB 中国光大银行 BCOM 中国交通银行 BEA 东亚银行 CMBC 中国民生银行 NBCB 宁波银行 SDB 深圳发展银行 HZB 杭州银行 GDB 广东发展银行 PAB 平安银行 CITIC 中信银行 HSB 徽商银行 HXB 华夏银行 CZB 浙商银行 CIB 兴业银行 SHB 上海银行 GZCB 广州银行 PSBC 中国邮政储蓄银行 UPOP 银联在线支付 DLB 大连银行 JSB 江苏银行
- 20. 快钱支付清算信息有限公司 版权所有 第 20 页 3.3 错误代码表 代码 描述 00000 未知错误 10001 不支持的字符编码格式,系统支持的字符编码格式为 1.UTF-8,2.GBK,3.GB2312 10002 不支持的返回类型,系统支持的返回类型为 1.页面返回,2.后台返回,3.同时 支持页面和后台返回 10003 页面返回地址和后台返回地址不能同时为空,请使用符合 URL 规则的 http 或者 https 地址 10004 页面返回地址和后台返回地址不能同时为空,请使用符合 URL 规则的 http 或者 https 地址 10005 不支持的网关接口版本号,目前系统支持的版本号为 v2.0 10006 商户号不存在 10007 付款方用户名不正确 10008 不支持的付款方联系方式,系统支持的联系方式为 1.电子邮件,2.电话.当联 系内容不为空时联系方式不能为空. 10009 付款方的联系内容不正确,请输入合法的联系地址 10010 订单号不正确,系统只支持以字母,数字组合的订单号,最大长度不能超过 30 10011 订单金额不正确,请输入以分为单位的金额 10012 订单提交时间不正确,请输入以 yyyyMMddhhmmss 格式的时间字符串
- 21. 快钱支付清算信息有限公司 版权所有 第 21 页 10013 商品名称不正确 10014 商品数量不正确 10015 商品 ID 不正确 10016 商品的描述不正确 10017 扩展参数一不正确 10018 扩展参数二不正确 10019 指定的支付方式不正确 10020 指定的支付服务代码不正确 10021 指定的银行 ID 不正确 10022 不支持的语言类型,系统支持的语言为 1.中文,2.英文 10023 不支持的签名类型,系统支持的签名类型为 1.MD5 10024 商户未开通人民币网关 10025 商户未开通国际卡人民币网关 10026 商户未开通电话支付人民币网关 10027 不正确的 pid 值 10028 不正确的国际卡支付参数,组合支付方式和支付方式必须为国际卡对应的 参数 10029 不正确的神州行支付参数,组合支付方式和支付方式必须为神州行支付对 应的参数 10030 不正确的代理商帐户代码 10031 商户未开通代理网关
- 22. 快钱支付清算信息有限公司 版权所有 第 22 页 10032 原始交易不存在 10033 订单金额不正确,请输入以元为单位的金额,最多允许两位小数 10034 手续费金额不正确,请输入以元为单位的金额,最多允许两位小数 10035 手续费总额大于或等于订单金额 10036 同一订单号禁止重复提交标志不正确 10037 对不起，该订单不允许重复提交，请重新下订单提交！ 10038 超过允许支付的时间范围 10042 卡号格式不正确 10043 不支持的发卡机构 10044 接口参数不正确，缺少发卡机构 10045 接口参数不正确 10046 商户没有定制支持的发卡机构 10047 商户没有定制支持的卡种 10053 平台返回地址不能为空 10054 商户签名数据不能为空 10055 扩展参数类型无效 10056 扩展参数内容格式错误 10057 不支持外币提交 10058 不支持的外币币种 10059 身份证格式不正确 10060 外币金额超过最大限制
- 23. 快钱支付清算信息有限公司 版权所有 第 23 页 10061 订单时间戳格式不正确,请输入以 yyyyMMddHHmmss 格式的时间戳 10062 您的订单已超时，请到商户网站重新提交订单 10063 付款人 IP 地址格式不正确 10064 未提供订单时间戳，请联系商户网站支持人员 10065 未提供付款人 IP 地址，请联系商用户网站支持人员 20001 订单信息的签名内容不正确 20002 商户账号已被冻结 20003 商户交易金额已超过限制 20004 商户制定的银行直连参数不正确 20005 不能使用优惠券 20006 商户账户不允许收款 20007 账户已注销 20008 订单金额小于支付手续费,不能支付 20009 商户不允许银行直连,可能商户没有对网关定制或者定制中没有选择银行 直连,请联系快钱客服 20010 您通过快钱向此商户的支付金额超过支付限额,请联系快钱客服 20011 您通过快钱向此商户的支付金额超过单笔订单的支付限额,请联系快钱客 服 20012 您通过快钱向此商户的支付金额超过单日的支付总限额,请联系快钱客服 20013 您通过快钱向此商户的支付金额超过单月的支付总限额,请联系快钱客服 20028 您使用的商户编号没有对 ATA 属性配置,请
- 24. 快钱支付清算信息有限公司 版权所有 第 24 页 30001 银行不可用 30002 线下支付不可用 30003 电话银行不可用 30004 订单已支付成功,请勿重新支付. 30005 请填写您的电子邮箱 50001 验证码不正确 50002 用户不存在 50003 用户被冻结 50004 登录次数过多,用户已被锁定 50005 付款人不能和收款人相同 50006 你的操作已超时，请重新提交 50007 账户不正确 50008 密码不正确 50009 余额不足 50010 没有付款权限 50011 不能向个人会员付款 50012 复核错误 50013 您的快钱盾已挂失,无法登录.您可以通过取消挂失或更换后再登录 50014 您输入的快钱盾数据不正确 50015 使用快钱盾遇到未知错误，请联系快钱客服 50016 请使用您的默认用户名登录!
- 25. 快钱支付清算信息有限公司 版权所有 第 25 页 50017 复核重试次数超过 3 次,您不能重新复核 60001 货币种类不正确! 提示 1：人民币网关；3：预付费卡网关. 60002 定单号不能为空,不能超过 30 位长度 60003 定单号只能包含数字或字母以及中划线和下划线 60004 该笔交易金额格式不正确,必须为整数或者小数 60005 该笔交易金额格式不正确,必须为整数 70001 您输入的用户不能使用此优惠券 70002 您尝试使用优惠错误次数超过 3 次,请与快钱客服联系 70003 您验证优惠券的用户错误次数超过 3 次,请与快钱客服联系 80001 当前交易属于非法交易，请与商户网站联系 80002 当前交易属于非法交易，请与商户网站联系 81000 商户提供的汇款充值码不符合规则，请联系您的商户 81001 商户提供的汇款充值码重复，请联系您的商户 81004 商家单笔交易金额超过限制，需上传身份证影印件。 81005 商家本月累计交易金额超过限制，需上传身份证影印件 82001 收款方账户非实名 82002 付款方账户非实名 4 附录 4.1 版权说明 此文档的版权归上海快钱信息服务有限公司所有，作为本系统的最终用户，可以拥有该份
- 26. 快钱支付清算信息有限公司 版权所有 第 26 页 文档的使用权，但未征得上海快钱信息服务有限公司的书面批准，不得修改、公布本文档，不 得向第三方借阅、出让、出版本文档。 4.1 快钱资源 快钱网站：http://www.99bill.com 快钱帮助中心：http://help.99bill.com 快钱支付图片下载：https://www.99bill.com/x/index.html 银行 logo 下载：http://www.99bill.com/seashell/html/corp/banks.html ** 如果您对本文档及快钱有任何建议或意见，请发送邮件至 support@99bill.com 快钱衷心感谢您的支持！
- 27. 快钱支付清算信息有限公司 版权所有 第 27 页 上海 SHANGHAI SHANGHAI 上海市浦东新区浦电路 360 号陆家嘴投资大厦 12 楼 TEL: 86-2161871299 FAX: 86-21-60877099 北京 BEIJING 北京市东城区东长安街 1 号东方广场西一办公楼 1001 室 TEL: 86-10-57322888 FAX: 86-10-85182124 广州 GUANGZHOU 广州市天河区林和西路 9 号耀中广场 B 座 716 室 TEL: 86-20-85237919 FAX: 86-20-38399032 深圳 SHENZHEN 深圳市福田中心区福华三路 168 号深圳国际商会中心 3102-3103 室 TEL: 86-755-82020299 FAX: 86-755-82020799 天津 TIANJIN 南京路 219 号天津中心写字楼 1801 室 TEL: 86-022-58965099 FAX: 86-20-58366881 南京 NANJING 庐山路 188 号新地中心 7 楼 TEL: 86-25-83509099 FAX: 86-25-68523499