代付

简介

加解密及签名

1. 生成随机密钥，将随机密钥使用RSA公钥加密
2. 将交易接口中的数据组装成json，要求值为字符串
3. 使用随机密钥对上一步生成的json字符串进行AES加密
4. 使用RSA私钥对json字符串进行签名

统一返回结果

参数	备注	说明
success	接口是否调用成功	true/false
result_code	系统级结果码	详见服务系统级结果码
result_code_msg	结果详情
random_key	加密后的随机密钥	使用RSA私钥进行解密
biz_content	加密后的业务数据	使用随机密钥AES解密
sign	签名

交易接口

代付

代付下单Y2001

请求参数

参数	备注	Min	Max	是否必填	说明
PartnerId	合作伙伴编号			Y
MerchantId	商户号			N	暂时不填
TradeCode	交易码			Y	Y2001
Version	版本号			Y	统一填1.0.0
OutOrderId	订单号	1	30	Y	每笔交易必须唯一
GmtOutCreate	订单创建时间			Y	时间格式：yyyyMMddHHmmss
Description	订单描述	1	50	Y
Currency	币种			Y	暂时只支持人民币，填156
Amount	交易金额			Y	最小单位为分，如1.23元填123
AccountType	账户类型			Y	1.公司 2.个人
CardType	卡类型			Y	信用卡：CC 借记卡：DC
BankCardHolderName	持卡人姓名	2	10	Y
BankCardNo	卡号	5	20	Y
BankCode	银行编号			N	详见附录银行编号
BankName	银行名称	1	30	N
Province	省份	2	2	N	不包含”省”，如”浙江”、”新疆”、”西藏”
City	城市	2	5	N	需包含”市”、”县”等，如”杭州市”、”淳安县”等
BranchCode	联行号	1	12	N
BranchName	联行名称	1	50	N
ExtraData	拓展数据	0	50	N	暂时不填
Remark	备注	0	50	N
Memo	回显数据	0	100	N	通知结果时该字段内容会不加密原样返回
NotifyUrl	交易结果通知地址	0	100	N	通知地址

返回参数(解密后的业务数据)

参数	备注	Min	Max	是否必填	说明
orderId	机构订单号			Y
outOrderId	商户订单号			Y
amount	交易金额			N
fee	手续费			N
bizStatus	业务状态			Y	详见附录代付业务状态
resultCode	结果码			Y	详见代付结果码
resultDetail	结果详情			Y

交易查询Y2002

请求参数

参数	备注	Min	Max	是否必填	说明
PartnerId	合作伙伴编号			Y
MerchantId	商户号			N	暂时不填
TradeCode	交易码			Y	Y2002
Version	版本号			Y	统一填1.0.0
OutOrderId	订单号	1	30	Y	下单时的订单号
GmtOutCreate	订单创建时间			Y	时间格式：yyyyMMddHHmmss

返回参数(解密后的业务数据)

参数	备注	Min	Max	是否必填	说明
orderId	机构订单号			Y
outOrderId	商户订单号			Y
amount	交易金额			N
fee	手续费			N
bizStatus	业务状态			Y	详见附录代付业务状态
resultCode	结果码			Y	详见代付结果码
resultDetail	结果详情			Y

通知

在交易完成后，系统将会通知下单接口中提交的通知地址，最多通知8遍，或接受到“SUCCESS”后停止。

参数

参数	备注	Min	Max	是否必填	说明
random_key	加密后的随机密钥			Y	使用提供的公钥进行RSA解密
biz_content	加密后的业务数据			N	使用随机密钥进行AES解密
memo	回显字段	0	100	N	下单时提交的回显字段原样返回
result_code	结果码			Y	0000表示成功，9999表示失败
result_detail	结果详情			Y

解密后的业务数据

参数	备注	Min	Max	是否必填	说明
orderId	机构订单号			Y
outOrderId	商户订单号			Y
amount	交易金额			Y
fee	手续费			Y
bizStatus	业务状态			Y	详见附录对应业务状态

附录

银行编码

系统级结果码定义

结果码	含义
0000	成功
9999	失败
0001	系统异常
0002	RSA公钥尚未配置
0003	RSA解密失败
0004	数据签名验证不通过
0005	报文格式不合法
0006	交易类型错误
0007	验证码不存在
0008	订单号不存在
0009	参数错误
0010	外部订单号已存在
0011	DES解密失败
0012	没有数据
0013	计算收费失败
0014	没有配置结算类型

代付结果码定义

结果码	含义
0000	成功
9999	失败
0001	通道异常

代付业务状态

结果码	含义
I	已预下单
P	付款成功
A	已申请
S	交易成功
F	交易失败
C	银行退票

公钥

MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCOxOjh/1dxibWJumJThn8OkrKgTWMsCpy/5tLQ52oDyahvbLu2e7eNOj4+06clOKJReE7touHsTpNxh7ZCNCUEhRxQbsBF0KELjhaRHs2QGVtI4KDofsFhHG/6zHnNo1RP6jsfBFnZENo3PCbT6O0wdOyS1Yg6vYJJM7LIaiT5gQIDAQAB