http://www.ChinaPay.com NetPayClient用户手册
currencycode:交易币种 (3位数字) transdate: 交易日期 (8位数字) transtype:交易类型(4位数字) status:交易状态(4位数字) checkvalue:数字签名(256位字符) GateId:交易网关号(4位字符) Priv1:商户私有域 失败应答各域段名称含义:
ResponeseCode: 应答码 (失败应答为3位数字) Message:应答码的中文含义
? 应答数据的签名验证
当查询交易完成时,ChinaPay会将查询信息发送给商户, NetPayClient的“验证交易应答函数”。方法名称为:
NetPayClient for Java :verifyTransResponse (详细内容参见3.5.2章节) NetPayClient for Win32 :check(详细内容参见3.5.3章节) NetPayClient for C :verifyTransResponse (详细内容参见3.5.4章节)
附录A 常见接入问题及解答
附录B 应答码说明
ChinaPay交易状态码
表3 ChinaPay交易状态代码表
状态码 1001 1003 其他 状态信息 消费交易成功 退货交易成功 其他均为交易失败,具体信息请登录ChinaPay交易控台查询,或查询各银行出第 31 页 共 27 页
http://www.ChinaPay.com NetPayClient用户手册
错信息文档。
NetPayClient API函数错误代码
表4 NetPayClient API函数出错代码表
状态码 所有方法 -111 签名方法 -100 -101 -102 -103 -130 -112 -113 -114 -118 -134
环境变量\未设置 商户密钥文件不存在或无法打开 密钥文件格式错误 秘钥商户号和用于签名的商户号不一致 用于签名的字符串长度为空 ChinaPay公钥文件不存在或无法打开 公钥文件格式错误 公钥文件出错 签名验证失败 公钥文件的设置路径有错误 没有设置秘钥文件路径,或者没有设置“NPCDIR”环境变量 状态信息 验证签名方法 查询,单笔退款错误代码
ERROR CODE 101 102 103 104 105 106 107 108 109 110 ERROR MESSAGE 商户号错误或者为空 交易应答查询的订单号为空 交易日期为空 请求交易类型错误 商户号长度错误 订单号长度错误 交易日期长度错误 交易类型为空或者长度不正确 版本号不能为空 版本号不正确 第 32 页 共 27 页
http://www.ChinaPay.com NetPayClient用户手册
111 112 116 117 118 121 122 123 201 201 202 203 204 205 301 302 303 304 305 307 404
商户请求非法 交易类型不合法 金额为空 商户私有域段长度出错 签名域段出错 退款金额不等于原支付订单金额 退款金额应该小于原支付订单金额 总退款金额大于了原支付订单金额 明文数据为空 签名数据不存在 签名不合法 验签失败 验签数据不合法 重复提交该笔交易 查询的交易不存在 查询数据库出错 应答数据封装出错 应答数据字符串转换出错 超出流量控制范围 未查到匹配的数据 其它内部错误 上海银联电子支付服务有限公司 2007-09-03
http://www.ChinaPay.com
第 33 页 共 27 页