Ver2.0.107A
快钱
快钱快钱
快钱【
【【
【人民币支付网关
人民币支付网关人民币支付网关
人民币支付网关】
】】
】
商户接口规范
（
（（
（高级版
高级版高级版
高级版）
））
）
上海快钱信息服务有限公司
上海快钱信息服务有限公司 版权所有 第 2 页
目 录
1. 文档说明
文档说明文档说明
文档说明...........................................................................................................................................................3
1.1 文档目标.........................................................................................................................................3
1.2 阅读对象.........................................................................................................................................3
1.3 相关约定.........................................................................................................................................3
1.4 技术支持.........................................................................................................................................3
2. 接口开发
接口开发接口开发
接口开发...........................................................................................................................................................4
2.1 功能说明及流程.............................................................................................................................4
2.2 开发准备.........................................................................................................................................4
2.3 参数说明.........................................................................................................................................4
2.3.1 商户提交到快钱..................................................................................................................4
2.3.2 快钱返回到商户..................................................................................................................6
2.4 开发提示.........................................................................................................................................7
2.4.1 签名字符串..........................................................................................................................7
2.4.2 通知支付结果......................................................................................................................8
2.4.3 商户对支付结果的处理......................................................................................................9
2.5 安全要点.........................................................................................................................................9
2.5.1 密钥管理..............................................................................................................................9
2.5.2 数据校验..............................................................................................................................9
2.5.3 对账......................................................................................................................................9
2.6 特殊定制.......................................................................................................................................10
2.6.1 绑定快钱服务器 IP ............................................................................................................10
2.6.2 直连银行............................................................................................................................10
2.6.3 企业网银支付....................................................................................................................10
3. 参考资料
参考资料参考资料
参考资料.........................................................................................................................................................10
3.1 常见问题.......................................................................................................................................10
3.1.1 如何获取收款账户的账号................................................................................................10
3.1.2 如何获取或修改网关商户密钥........................................................................................11
3.1.3 如何查询网关交易记录....................................................................................................11
3.1.4 如何自助补发支付结果....................................................................................................11
3.2 银行代码表...................................................................................................................................11
3.3 错误代码表...................................................................................................................................12
4 附录
附录附录
附录..................................................................................................................................................................14
4.1 版权说明.......................................................................................................................................14
4.2 快钱资源.......................................................................................................................................14
上海快钱信息服务有限公司 版权所有 第 3 页
1. 文档说明
文档说明文档说明
文档说明
1.1 文档目标
文档目标文档目标
文档目标
本文档的目的是为快钱人民币支付网关平台定义一个接口规范，以帮助商户技术人员接入快
钱人民币支付网关，并快速掌握快钱人民币支付网关相关功能，便于尽快投入使用。
1.2 阅读对象
阅读对象阅读对象
阅读对象
快钱人民币支付网关商户的网上应用开发人员、维护人员和管理人员。
他们应具备以下基本知识：
了解 MICROSOFT WINDOWS/NT、WINDOWS9X、WINDOWS 2000、HP-UX、AIX、SUN SOLARIS、
LINUX、BSD 等操作系统的其中一种；
了解上述系统上的网站设置和网页制作方法；
了解 HTML 语言以及 CGI（COMMON GATEWAY INTERFACE）或 ASP（ACTIVE SERVER PAGES）或
PHP 或 JAVA 等开发语言；
了解信息安全的基本概念。
1.3 相关
相关相关
相关约定
约定约定
约定
商户：指已注册成为快钱用户、并使用快钱产品实现其收付费功能需求、为其用户提供各类产
品或者相关服务的企业或个人。
用户：指在商户网站等系统购物的企业或个人。
购物：指用户在商户网站购买相关产品或服务。
{XXX}：XXX 前后分别加{和}，表示名称为 XXX 的变量所对应的值。
1.4 技术支持
技术支持技术支持
技术支持
如果您有任何技术上的疑问，可按如下方式寻求帮助：
技术支持热线：86 -21 - 58777299 / 58777399 - 8163 / 8161
技术支持邮箱：support@99bill.com
技术支持时间：周一到周五 9:00-18:00
上海快钱信息服务有限公司 版权所有 第 4 页
2. 接口开发
接口开发接口开发
接口开发
2.1 功能说明及流程
功能说明及流程功能说明及流程
功能说明及流程
用户向商户购物时，需要通过一定方式向商户支付相关费用。商户网站系统如果集成了快钱人
民币支付网关，可以让用户很方便向商户支付相关款项，并且商户也可以很容易了解到款项的
到帐情况及用户购买的产品或服务。
整体流程如下：
用户在商户选择产品或服务，在下订单完成后，商户网站等系统会将该订单号及对应订单金额
以及收款方信息等相关资料提交到快钱，然后跳转到快钱页面进行支付。当支付完成后，快钱
通知商户支付结果，并且根据商户指定的地址跳转到商户指定页面。商户在接收到支付结果之
后，可以对数据库进行相应更新，然后在显示给用户的页面中作出相应提示。
2.2 开发准备
开发准备开发准备
开发准备
商户开发人员应该仔细阅读本协议以及注意事项，并准备好如下信息：
商户在快钱的用于收款的人民币账号
商户的人民币网关密钥
2.3 参数说明
参数说明参数说明
参数说明
2.3.1 商户
商户商户
商户提交
提交提交
提交到快钱
到快钱到快钱
到快钱
提交地址 https://www.99bill.com/gateway/recvMerchantInfoAction.htm (推荐！）
或 http://www.99bill.com/gateway/recvMerchantInfoAction.htm
参数名称 参数含义 长度 可否为空 参数说明
协议参数
inputCharset 字符集 2 可为空 固定选择值：1、2、3
1 代表 UTF-8; 2 代表 GBK; 3 代表 GB2312
默认值为 1
pageUrl 接 受 支 付 结
果 的 页 面 地
址
256 可为空 需要是绝对地址，与 bgUrl 不能同时为空
当 bgUrl 为空时，快钱直接将支付结果 GET到 pageUrl
当 bgUrl 不为空时，按照 bgUrl 的方式返回
bgUrl 服 务 器 接 受
支 付 结 果 的
后台地址
256 可为空 需要是绝对地址，与 pageUrl 不能同时为空
快钱将支付结果发送到 bgUrl 对应的地址，并且获取
商户按照约定格式输出的地址，显示页面给用户
version 网关版本 10 不可空 固定值：v2.0
上海快钱信息服务有限公司 版权所有 第 5 页
注意为小写字母
language 网 关 页 面 显
示语言种类
2 不可空 固定值：1
1 代表中文显示
signType 签名类型 2 不可空 固定值：1
1 代表 MD5 加密签名方式
买卖双方信息参数
merchantAcctId 人民币账号 30 不可空 数字串
本参数用来指定接收款项的人民币账号
payerName 支付人姓名 32 可为空 英文或中文字符
payerContactType
支 付 人 联 系
方式类型
2 可为空 固定值：1
1 代表电子邮件方式
payerContact 支 付 人 联 系
方式
50 可为空 字符串
根据 payerContactType 的方式填写对应字符
业务参数
orderId 商户订单号 50 不可空 字符串
只允许使用字母、数字、
-
、
_,
并以字母或数字开头
每商户提交的订单号，必须在自身账户交易中唯一
orderAmount 商 户 订 单 金
额
10 不可空 整型数字
以分为单位。比方 10 元，提交时金额应为 1000
orderTime 商 户 订 单 提
交时间
14 不可空 数字串，一共 14 位
格式为：年[4 位]月[2 位]日[2 位]时[2 位]分[2 位]秒[2
位]
例如：20071117020101
productName 商品名称 256 可为空 英文或中文字符串
productNum 商品数量 8 可为空 整型数字
productId 商品代码 20 可为空
字母、数字或
-
、
_
的组合
如商户发布了优惠券，并只想对指定的某商品或某类
商品进行优惠时，请将此参数与发布优惠券时设置的
“适用商品”保持一致。只可填写一个代码。
如果不使用优惠券，本参数不用填写
productDesc 商品描述 400 可为空 英文或中文字符串
ext1 扩展字段 1 128 可为空 英文或中文字符串
支付完成后，按照原样返回给商户
ext2 扩展字段 2 128 可为空 英文或中文字符串
支付完成后，按照原样返回给商户
payType 支付方式 2 不可空 固定选择值：00、10、11、12、13、14
00 代表显示快钱各支付方式列表；10 代表只显示银
行卡支付方式；11 代表只显示电话银行支付方式；12
代表只显示快钱账户支付方式；13 代表只显示线下支
