资源描述
中国电信股份有限公司 统一支付平台测试模拟客户端接口协议
中国电信统一支付平台测试
模拟客户端接口协议
(征求意见稿)
版本号:0.5
中国电信集团公司上海院
2007-7
前 言
本测试模拟客户端(含服务器)接口协议描述中国电信集团统一支付平台测试所需的模拟客户端所需的测试环境、测试接口、承载协议的要求。
本测试模拟客户端接口协议根据《中国电信统一支付平台业务规范》制定。
本规范由中国电信集团公司上海院提出并撰写。
本方案起草单位: 中国电信股份有限公司上海研究院
本方案主要起草人:
本方案解释单位: 中国电信股份有限公司上海研究院
目录
目录 iii
1 目的 4
2 测试内容 5
3 模拟客户端 6
4 模拟客户端接口协议 7
4.1 固网POS接入平台与支付平台接口协议 7
4.1.1 消息头定义 8
4.1.2 建链消息体定义(暂不测试) 9
4.1.3 链路查询消息体定义(暂不测试) 9
4.1.4 支付接口消息体定义 9
4.1.5 查询银行卡余额消息体定义 11
4.1.6 平台订单下发消息体定义 13
4.2 网厅模拟客户端 14
4.2.1 重定向跳转订单下发: 14
4.2.2 查询余额 18
4.2.3 绑定接口: 19
4.2.4 授权接口: 22
4.3 IVR模拟客户端 25
4.3.1 消息头定义 26
4.3.2 建链消息体定义(暂不测试) 27
4.3.3 链路查询消息体定义(暂不测试) 28
4.3.4 支付接口消息体定义 28
4.3.5 查询电信卡余额消息体定义 30
4.4 SP模拟客户端 31
4.4.1 Http重定向下发接口 31
4.4.2 SP订单下发接口 33
4.4.3 冲正接口: 35
4.5 银行模拟服务端 37
4.5.1 网银支付接口: 37
4.5.2 查询接口 39
4.5.3 支付接口 41
4.6 BOSS模拟服务端 43
4.6.1 客户资料同步接口: 43
4.7 现网帐务中心销帐接口 47
4.8 附录:默认代码 48
53
1 目的
上海院为统一支付平台测试提供了6种模拟客户端,为有助于测试厂商的原型搭建,现把这些模拟客户端所采用的协议发给厂商参考,并欢迎你们在原型系统搭建过程中到上海院进行调试、联调,请你们对这部分材料保密。
2 测试内容
1. 测试内容
包括平台侧接口,但不包括终端、接入系统、外围系统等。
1).固网POS与网厅部分相关功能纳入测试范围,后面加以标注。
2).与银行、CRM的接口只测业务功能流程,不单测接口协议。
3).漫游功能暂不测。
4). 请依据附录的默认代码填写各接口字段。
5)除SP下发采用短连接外,其它socket接口采用长连接通信方式;
6)由于网厅上缴话费是今年重点业务,帐务中心的销帐接口采用现网平台来测试,请你们给予重视。
2.功能/接口测试
参见功能测试规范中测试用例
3.性能测试
参见性能测试规范中测试用例
3 模拟客户端
上海院提供的模拟客户端/服务器包括:
1. 模拟终端/接入系统: IVR、固网POS、网厅;
2. 模拟SP
3.模拟银行
4.模拟CRM
注:此处的模拟客户端是软终端,不单指硬终端,包括终端与接入系统。
请你们自己准备数据库,数据规则请参考模拟客户端协议中附录部分,并请提供数据输入界面,测试人员将在测试前输入数据到你们的数据库中。
4 组网方式
1. 功能测试
2. 性能测试
5 模拟客户端接口协议
5.1 固网POS接入平台与支付平台接口协议
支付能力平台与接入平台间通信在TCP 网络连接上基于协议数据单元(PDUs)的交换。双方互为客户端和服务端,分别建立两条链路通信。当在连接上没有信息交换的时候,双方应该每C 分钟相互发送EnquireLinkReq PDUs,以保持连接。如果在T 秒之后,仍然没有响应信息回复,发送方应该再一次发送EnquireLinkReq PDUs。如果在发送方发送N-1 条EnquireLinkReq PDUs 到另一方之后,仍然没有响应信息回复,发送方应该关闭连接。
在提供的系统中应该可以设定C,T,N 的值。C 的典型值为60 秒,T 是60 秒,N 是3次。如果在T 秒之后等候响应信息是超时或者在N-1 次重试之后停止发送,发送方应该立即发送请求。T 的典型值为60 秒,N 为3 次。
5.1.1 消息头定义
字段名称
类型
字段含义
长度
备注
mlen
String
报文长度
4
总长度(包含本身),右对齐,不足添‘0’
connecttype
String
接入方式
2
填 ‘01’,见附录1)接入方式定义
msgcode
String
消息类型
4
0001-BindReq
1001-BindResp
0002-EnquireLinkReq
1002-EnquireLinkResp
0003-Pstn_Pay_Req
1003-Pstn_Pay_Resp
0004-Pstn_CardQuery_Req
1004-Pstn_CardQuery_Resp
0005-Pstn_PlatOrder_Req
1005-Pstn_PlatOrder_Resp
tradetype
String
业务类型(交易类型)
4
见代码表
sndcode
String
发端代码
4
见附录收发端代码表
rcvcode
String
收端代码
4
见附录收发端代码表
msgseq
String
消息流水号
22
格式YYYYMMDDH24MISS+8,请求方生成,响应方回填消息流水号
resversed1
String
保留字段1
14
全部填空格
resversed2
String
保留字段2
8
全部填空格
5.1.2 建链消息体定义(暂不测试)
5.1.2.1 BindReq定义
BindReq
srcdevid
String
发端设备ID
10
由系统分配,遵循设备编码规范
AuthenticatorSource
String
认证字
36
该域用来对发端进行鉴权(16进制表示的字符串)。
它生成的MD5加密算法如下:
发端认证号码=发端设备ID+共享密钥+时间戳
共享的密钥部分由统一支付平台和接入平台分配,时间戳由发端设备生成,格式是:YYYYMMDDHH24MISS,年月日时分秒。
TimeStamp
String
时间戳
14
时间戳由发端设备生成,格式是月日时分秒(YYYYMMDDHH24MISS)
Version
String
版本号
4
版本号,两位主版本号+两位子版本好,本版本号为:0101
5.1.2.2 BindResp定义
BindResp
rspcode
String
响应码
2
00:成功 01:失败
5.1.3 链路查询消息体定义(暂不测试)
链路查询消息的请求和响应均没有消息体,只有消息头。
5.1.4 支付接口消息体定义
5.1.4.1 Pstn_Pay_Req定义
Pstn_Pay_Req
Tmnum
String
终端标识
40
终端号码,如果涉及终端该字段需要保存终端号,左对齐不足填空格
Psamnum
String
PSAM卡卡号
16
PSAM卡号,左对齐不足填空格
merchantcode
String
身份标识
20
身份标识,唯一标识SP
02+八位流水号
Ordertype
String
订单类型
2
00:普通流水号
01:条形码
02:二维条形码
03: 合同号
Transid
String
平台交易流水
20
平台交易流水,由平台产生
左对齐不足填空格
orderid
String
订单号
34
SP订单号,由SP产生(模拟客户端随机产生)
Orderdate
String
时间戳
14
由SP提供,长度14
YYYYMMDDHHMMSS格式
Needdate
String
订单缴费截止时间
14
缴费截止时间,用户必须在截止时间之前缴费,否则账单将自动失效
Paytype
String
支付方式
2
默认未授权‘00’
授权‘01’
Payorgtype
String
支付机构标识类型
2
标识是银行卡支付或电信账户支付
01 电信 02 银行
Payorg
String
支付机构标识
64
01 统一支付平台 02银行
左对齐不足填空格
Petype
String
支付账户类型
2
00 统一支付账户
01 银行卡号
Peid
String
支付账号
32
左对齐不足填空格
pesecurity
String
交易密码
32
用支付平台帐户填来自模拟终端的密码;
左对齐不足填空格
payment
String
支付金额(单位为分)
20
右对齐,不足填 ‘0’
curcode
String
币种
2
固定填01人民币
paralen
String
终端有效数据长度
4
右对齐,不足填 ‘0’
paracontent
String
终端有效数据(从接入获得的银行卡或终端的相关信息)
5.1.4.2 Pstn_Pay_Resp定义
Pstn_Pay_Resp
Orderid
String
订单流水号
34
SP订单号,由平台产生
Platid
String
统一支付平台标识
10
rspcode
String
响应码
2
见错误代码表
rspstringlen
String
响应字符串长度
4
(处理统一支付帐户相关业务时有效)
rspstring
String
响应字符串
(处理统一支付卡相关业务时有效)
您的XXXX卡号统一支付卡缴费XX.XX元成功。
paralen
String
终端有效数据长度
4
(处理银行卡相关业务时有效)
paracontent
String
终端有效数据
(处理银行卡相关业务时有效)
5.1.5 查询银行卡余额消息体定义
5.1.5.1 Pstn_CardQuery_Req定义
Pstn_CardQuery_Req
字段名称
类型
字段含义
长度
备注
Tmnum
String
终端标识
40
终端号码,如果涉及终端该字段需要保存终端号,左对齐不足填空格
Psamnum
String
PSAM卡卡号
16
PSAM卡号,左对齐不足填空格
payorgtype
String
支付机构标识类型
2
标识是银行卡支付或电信账户支付
01 电信 02 银行
Payorg
String
支付机构标识
64
01 统一支付平台 02银行
左对齐不足填空格
Petype
String
支付账户类型
2
00 统一支付账户
01 银行卡号
Peid
String
支付账号
32
左对齐不足填空格
pesecurity
String
交易密码
32
用支付平台帐户填来自模拟终端的密码;
左对齐不足填空格
curcode
String
币种
2
固定填01人民币
paralen
String
终端有效数据长度
4
右对齐,不足添 ‘0’
paracontent
String
终端有效数据
5.1.5.2 Pstn_CardQuery_Resp定义
Pstn_CardQuery_Resp
字段名称
类型
字段含义
长度
备注
rspcode
String
响应码
2
详见响应码定义表(消息类型为统一支付卡查询响应时有效)
rspstringlen
String
响应字符串长度
4
(消息类型为统一支付卡查询响应时有效)
rspstring
String
响应字符串
(消息类型为统一支付卡查询响应时有效)
banlance
String
余额
20
银行账户余额
paralen
String
终端有效数据长度
4
(消息类型为银行卡查询响应时有效)
paracontent
String
终端有效数据
5.1.6 平台订单下发消息体定义
5.1.6.1 Pstn_PlatOrder_Req定义
Pstn_PlatOrder_Req
字段名称
类型
字段含义
长度
备注
Tmnum
String
终端标识
40
终端号码,如果涉及终端该字段需要保存终端号,左对齐不足填空格
payorgtype
String
支付机构标识类型
2
标识是银行卡支付或电信账户支付
01 电信 02 银行
Payorg
String
支付机构标识
64
01 统一支付平台 02银行
左对齐不足填空格
merchantcode
String
SP身份标识
20
SP代码,唯一标识SP
左对齐不足填空格
Ordertype
String
订单类型
2
00:普通流水号
01:条形码
02:二维条码
03: 合同号
transid
String
平台交易流水
20
平台交易流水,由平台产生
左对齐不足填空格
orderid
String
SP订单号
34
SP订单号,由SP产生
左对齐不足填空格
Orderdate
String
SP订单创建时间
14
由SP提供,长度14
YYYYMMDDHHMMSS格式
Needdate
String
订单缴费截止时间
14
缴费截止时间,用户必须在截止时间之前缴费,否则账单将自动失效
Payment
String
支付金额
20
右对齐,不足填 ‘0’
curcode
String
币种
2
固定填01人民币
needreceipt
String
是否要收据或发票
1
’0’ 不需要
‘1’ 需要
paralen
String
终端有效数据长度
4
右对齐,不足填 ‘0’
paracontent
String
终端有效数据
订单内容
5.1.6.2 Pstn_PlatOrder_Resp定义
Pstn_PlatOrder_Res 平台定单下发响应
字段名称
类型
字段含义
长度
备注
rspcode
String
响应码
2
rspstringlen
String
响应字符串长度
4
rspstring
String
响应字符串
paralen
String
终端有效数据长度
4
paracontent
String
终端有效数据
5.2 网厅模拟客户端
5.2.1 重定向跳转订单下发:
5.2.1.1 接口描述
接口名称
重定向跳转订单下发接口
接口描述
通过调用支付接口向统一支付平台发出支付请求,统一支付平台通过支付Portal与用户进行交互,完成支付处理后,重定向回应用系统
接口提供者
统一支付平台
接口使用者
应用系统
5.2.1.2 请求参数:
参数名称
参数说明
流水号
应用系统产生的订单流水号
时间戳
支付请求发起的时间
身份标识
向统一支付平台表明支付请求发起者的身份,如哪个省的应用系统(SP编码)
业务类型
标识本次支付的业务类型
客户标识
标识通过应用系统进行支付的客户ID(可为空)
产品标识
标识通过应用系统进行支付的支付对象,对应中国电信的产品标识,如固话号码,宽带标识等
金额
需要完成支付的金额
返回地址
统一支付平台接受支付请求并完成支付处理后,需要重定向回应用系统的URL地址
终端号
Web绑定终端号
备注
其他需要扩展的信息
5.2.1.3 应答参数:
参数名称
参数说明
流水号
应用系统提交支付请求时携带的交易流水号
时间戳
支付应答返回的时间
操作标识
标识支付成功与否
失败原因
如果支付失败返回失败原因
5.2.1.4 接口定义
(HTTP跳转)
订单下发请求
字段
名称
类型
说明
CMDID
请求类型
String(10)
请求类型,各业务平台的请求默认填‘PAY’
MERCHANTID
SP身份标识
String (30)
由统一支付平台统一分配,’02’+8位流水
MERCHANTNAME
身份标识中文名称
String (64)
可不填
ORDERID
流水号 帐单号
String (34)
由SP提供,不小于8位,以日期时间(YYYYMMDDHHMMSS格式)加一固定长度流水号组成,如:
2007071115242500001
ORDERDATE
时间戳
String (14)
由SP提供,长度14
YYYYMMDDHHMMSS格式
PAYMENT
支付金额
String (10)
单位:分
CURTYPE
币种
String (10)
默认填 ‘01’
ENCODETYPE
加密方式
String (1)
0:不加密 默认
1:MD5摘要
ATTACH
附加信息
String (128)
SP附加信息
BUSINESSTYPE
业务类型
String (10)
默认0004
TMNUM
终端号码
String (40)
终端号码, 如果涉及终端该字段需要保存终端号(注:如果在Web上选择固网POS支付,需要在页面上填电话终端号码)
CUSTOMERID
应用系统客户标识
String (32)
默认
PRODUCTID
应用系统产品标识
String (20)
默认‘’
MAC
MAC校验域
String (32)
默认为0,不加密; 当为1时加密方式有意义,采用标准的MD5算法,由SP实现
MERCHANTURL
回调地址
响应
字段
名称
类型
说明
CMDID
请求类型
String (10)
请求类型,各业务平台的请求分类说明,默认填‘PAY’
TRADESEQUENCE
流水号
String (30)
由统一支付平台提供,SP必须保存该信息,SP需保存,作为对帐依据
MERCHANTID
身份标识
String (30)
从SP传送的信息中获得
ORDERID
订单号
String (34)
从SP传送的信息中获得,SP需保存,作为对帐数据
PAYMENT
金额
String (10)
从SP传送的信息中获得,单位为:分。SP需保存,作为对帐数据
RETNCODE
处理结果码
String (2)
由统一支付平台统一定义,SP需保存,作为对帐数据。结果码为“00” 表示支付成功,其他值则表示支付失败!
RETNINFO
处理结果中文说明
String (32)
由统一支付平台统一定义
PAYDATE
交易时间
String (14)
由统一支付平台提供
CURTYPE
币种
String (10)
默认填 RMB 01
ENCODETYPE
加密方式
String (1)
0:不加密 (默认)
1:MD5摘要
ATTACH
SP附加信息
String (32)
SP附加信息
SIGN
数字签名
String (256)
数字签名算法由统一支付平台统一提供,SP需保存,作为核查依据(为1时有效),默认为0
5.2.2 查询余额
5.2.2.1 查询请求消息
查询统一支付帐户余额,public QueryChargeRes QueryChargeReq() : (webservice接口)
参数
参数含义
数据类型
必填
说明
Ordered
查询流水号
String
必填可选
queryAccount
查询帐户
String
必填
统一支付帐户
Password
查询密码
String
必填
Note
交易备注
String
必填
Digest
数字签名
String
可选
5.2.2.2 查询响应消息
public class QueryChargeRes
{
String queryAccount;
String charge;
String param;
String note;
String digest;
String respCode;
}
参数
参数含义
数据类型
必填
说明
queryAccount
查询帐户
String
必填
统一支付帐户
Charge
余额
String
必填
余额,单位(分)
Param
返回参数
String
可选
Note
交易备注
String
可选
Digest
数字签名
String
可选
RespCode
查询结果
String
必填
见附录
5.2.3 绑定接口:
定义:两个账户之间建立关联,使绑定方可以非面柜方式直接被绑定方向进行账户转账
实现统一支付帐户与订单应用系统用户设定其应用系统客户ID与支付账户或支付终端间的绑定进行绑定,用户在网厅上进行绑定,实际绑定操作由统一支付平台完成。同步到应用系统。
可以用户主动、或应用系统发起、支付平台主动发起。
5.2.3.1 接口描述
接口名称
绑定接口
接口描述
应用系统用户设定其应用系统客户ID与支付账户或支付终端间的绑定关系
接口提供者
统一支付平台
接口使用者
应用系统
5.2.3.2 请求参数:
参数名称
参数说明
订单流水号
应用系统生成的订单流水号,用于标识一次绑定交易
时间戳
发起绑定请求的时间
身份标识
本次绑定发起方的身份标识(即应用系统在统一支付平台登记的使用支付业务的身份编号)
应用系统客户ID
用户在应用系统中的客户ID
支付机构标识
标识是银行卡支付或电信账户支付
分支机构标识
如是银行卡支付,标识从哪个银行进行支付
如是电信账户支付,标识是从虚拟账户支付还是产品帐号代收费
支付账户类型
如是银行卡支付,标识账户类型,如存折、借记卡、信用卡等
如是电信账户中的产品帐号代收费,标识产品帐号类型,如固话、小灵通、宽带帐号等
支付账号
用于扣款的账号
如是银行卡支付,输入银行账户号
如是电信虚拟账户支付,输入电信虚拟账户帐号
如是电信产品帐号支付,输入电信产品帐号
交易密码
账户的相应密码
交易提示信息
本次绑定的描述信息(如:用户将为某个客户ID绑定),金融机构可将该描述信息提示给用户
5.2.3.3 应答参数:
参数名称
参数说明
订单流水号
支付平台产生的订单流水号
统一支付平台标识
标识统一支付平台
支付结果
本次绑定是否成功
支付账号
绑定的支付账户
用户信息
支付账户对应的用户信息,如姓名等
错误描述
如果失败,返回错误编码或错误描述
5.2.3.4 接口定义
绑定请求:
Public BindReqResponse RequestBindReq()
字段
名称
类型
必填
说明
orderId
订单流水号
String
必填
应用系统生成的订单流水号,用于标识一次绑定交易
orderDate
时间戳
String
必填
发起绑定请求的时间
merchantId
身份标识
String
必填
本次绑定发起方的身份标识(即应用系统在统一支付平台登记的使用支付业务的身份编号)
customerId
应用系统客户ID
String
必填
用户在应用系统中的客户ID
payOrg
支付机构标识
String
必填可选
默认 ‘’
payOrgType
分支机构标识
String
必填可选
默认 ‘’
peType
支付账户类型
String
必填可选
默认 ‘’
peId
支付账号
String
必填
用于扣款的账号
银行帐号
peSecurity
交易密码
String
必填
账户的相应密码
Credit
信用卡有效期
String
默认为20091231
creditCvv2
信用卡CVV2码
String
默认为0
openName
账户开户名
String
可选
默认为‘支付’
Identity
身份证号码
String
可选
默认为‘00’
tipInfo
交易提示信息
String
本次绑定的描述信息(如:用户将为某个客户ID绑定),金融机构可将该描述信息提示给用户
响应:
public class BindReqResponse
{
public string orderId;
public string platId;
public string resultCode;
public string peId;
public string userInfo;
public string errorCode respCode;
public string platBindId;
}
字段
名称
类型
必填
说明
orderId
订单流水号
String
必填
应用系统产生的订单流水号
platBindId
平台流水号
string
必填
统一支付平台产生
platId
统一支付平台标识
String
必填
标识统一支付平台
resultCode
支付结果(绑定结果)
String
必填
本次绑定是否成功
peId
支付账号
String
必填
绑定的支付账户
userInfo
用户信息
String
支付账户对应的用户信息,如姓名等
errorCode respCode
错误描述
String
如果失败,返回错误编码或错误描述,见附录
5.2.4 授权接口:
授权:授权是资源的所有者或者控制者准许他人访问这种资源,这是实现访问控制的前提。授权是指客体授予主体一定的权力,通过这种权力,主体可以对客体执行某种行为,例如登陆,查看文件、修改数据、管理账户等。授权行为是指主体履行被客体授予权力的那些活动。因此,访问控制与授权密不可分。授权表示的是一种信任关系,需要建立一种模型对这种关系进行描述。
5.2.4.1 接口描述
接口名称
授权接口
接口描述
用户在应用系统上设定其应用系统客户ID与支付帐号的绑定关系后,授权应用系统可自动发起用户授权的支付操作
接口提供者
统一支付平台
接口使用者
应用系统
5.2.4.2 请求参数:
参数名称
参数说明
订单流水号
支付平台生成的订单流水号,用于标识一次授权交易
时间戳
发起授权请求的时间
身份标识
本次授权发起方的身份标识(即应用系统在统一支付平台登记的使用支付业务的身份编号)
应用系统客户ID
用户在应用系统中的客户ID
支付机构标识
标识是银行卡支付或电信账户支付
分支机构标识
如是银行卡支付,标识从哪个银行进行支付
如是电信账户支付,标识是从虚拟账户支付还是产品帐号代收费
支付账户类型
如是银行卡支付,标识账户类型,如存折、借记卡、信用卡等
如是电信账户中的产品帐号代收费,标识产品帐号类型,如固话、小灵通、宽带帐号等
支付账号
用于扣款的账号
如是银行卡支付,输入银行账户号
如是电信虚拟账户支付,输入电信虚拟账户帐号
如是电信产品帐号支付,输入电信产品帐号
交易密码
账户的相应密码
信用卡有效期
对于信用卡,需要提交有效期
信用卡CVV2码
对于信用卡,需要提交CVV2验证码
账户开户名
授权账户拥有者的姓名
身份证号
授权账户拥有者的身份证号
交易提示信息
扩展信息
5.2.4.3 应答参数:
参数名称
参数说明
订单流水号
支付平台产生的订单流水号
统一支付平台标识
标识统一支付平台
支付结果
本次授权是否成功
错误描述
如果失败,返回错误编码或错误描述
5.2.4.4 接口定义:
授权请求:
Public AuthorizeReqResponse RequestAuthorizeReq()
参数
名称
类型
必填
说明
orderId
订单流水号
String
必填
应用生成的订单流水号,用于标识一次授权交易
orderDate
时间戳
String
必填
发起授权请求的时间
merchantId
身份标识
String
必填
本次授权发起方的身份标识(即应用系统在统一支付平台登记的使用支付业务的身份编号)
customerId
应用系统客户ID
String
必填
用户在应用系统中的客户ID
payOrg
支付机构标识
String
必填可选
标识是银行卡支付或电信账户支付
payOrgType
分支机构标识
String
必填可选
如是银行卡支付,标识从哪个银行进行支付
如是电信账户支付,标识是从虚拟账户支付还是产品帐号代收费
peType
支付账户类型
String
必填可选
如是银行卡支付,标识账户类型,如存折、借记卡、信用卡等
如是电信账户中的产品帐号代收费,标识产品帐号类型,如固话、小灵通、宽带帐号等
peId
支付账号
String
必填
用于扣款的账号
如是银行卡支付,输入银行账户号
如是电信虚拟账户支付,输入电信虚拟账户帐号
如是电信产品帐号支付,输入电信产品帐号
peSecurity
交易密码
String
账户的相应密码
credit
信用卡有效期
String
默认为20091231
creditCvv2
信用卡CVV2码
String
默认为0
openName
账户开户名
String
可选
默认为‘支付’
Identity
身份证号码
String
可选
默认为‘00’
tipInfo
交易提示信息
String
扩展信息
授权响应:
public class AuthorizeReqResponse
{
public string orderId;
public string platId;
public string resultCode;
public string respCode;
public string platBindId;
}
字段
名称
类型
必填
说明
orderId
订单流水号
String
必填
应用系统产生的订单流水号
platBindId
平台流水号
string
必填
统一支付平台产生
platId
统一支付平台标识
String
必填
标识统一支付平台
resultCode
支付结果
String
必填
本次授权是否成功
errorCode respCode
错误描述
String
如果失败,返回错误编码或错误描述
5.3 IVR模拟客户端
支付能力平台与接入平台间通信在TCP 网络连接上基于协议数据单元(PDUs)的交换。双方互为客户端和服务端,分别建立两条链路通信。当在连接上没有信息交换的时候,双方应该每C 分钟相互发送EnquireLinkReq PDUs,以保持连接。如果在T 秒之后,仍然没有响应信息回复,发送方应该再一次发送EnquireLinkReq PDUs。如果在发送方发送N-1 条EnquireLinkReq PDUs 到另一方之后,仍然没有响应信息回复,发送方应该关闭连接。
在提供的系统中应该可以设定C,T,N 的值。C 的典型值为60 秒,T 是60 秒,N 是3次。如果在T 秒之后等候响应信息是超时或者在N-1 次重试之后停止发送,发送方应该立即发送请求。T 的典型值为60 秒,N 为3 次。
5.3.1 消息头定义
字段名称
类型
字段含义
长度
备注
mlen
String
报文长度
4
总长度(包含本身),右对齐,不足添‘0’
connecttype
String
接入方式
2
默认填 ‘01’
msgcode
String
消息类型
4
默认填‘0000’
0001-BindReq
1001-BindResp
0002-EnquireLinkReq
1002-EnquireLinkResp
0003-Pstn_Pay_Req
1003-Pstn_Pay_Resp
0004-Pstn_CardQuery_Req
1004-Pstn_CardQuery_Resp
0005-Pstn_PlatOrder_Req
1005-Pstn_PlatOrder_Resp
0010-IVR_Pay_Req
1010-IVR_Pay_Resp
0011-IVR_CardQuery_Req
1011-IVR_CardQuery_Resp
tradetype
String
业务类型(交易类型)
4
支付 0002
查询 0003
sndcode
String
发端代码
4
默认填‘0300’
rcvcode
String
收端代码
4
默认填‘0100’
msgseq
String
消息流水号
22
格式YYYYMMDDH24MISS+8,请求方生成,响应方回填消息流水号
resversed1
String
保留字段1
14
全部填空格
resversed2
String
保留字段2
8
全部填空格
5.3.2 建链消息体定义(暂不测试)
5.3.2.1 BindReq定义
BindReq 请求消息体
srcdevid
String
发端设备ID
10
由系统分配,遵循设备编码规范
AuthenticatorSource
String
认证字
36
该
展开阅读全文