湖南电信IPTV+智能机顶盒SP业务接入接口说明20160317



湖南电信IPTV+智机顶盒SP接入
支付接口规范说明












项目信息
项目名称
湖南电信IPTV+智机顶盒支付接口规范说明
项目编号

项目理
李超
文件标识



增值业务接入接口说明
1 安卓应支付接口
根IPTV业务理台提供接口文档 湖南电信IPTV业务理台_SP业务接入接口说明20150603见附件针安卓应特点支付时序流程


11 接口应答调方式
接口方：SP台 à 支付APP
接口功：SP台调支付APP进行统鉴权订购
承载方式：android intent
调包名cncombellmannpayment
调类名 cncombellmannpaymentPayActivity
12 接口请求消息
名称
说明
数类型
长度（字节）
否必选

transactionID
事务编号具体定义详见附件
String
40
M
SPID
SP厂商编码
String
8
M
userId
户登录名 (已加密)
String
32
M
userToken
户登录Token(已加密)
String
32
M
key
解密密钥格式：n2中0果填值加解密字段密文
果填值加解密字段明文
String

O
productID
产品编号
String
32
M
price
扣费金额单位：分
值产品定价费
String

M
productName
产品名称订购描述信息
String
64
O
backPackage
返回包名
String

M
backClass
返回类名
String


notifyUrl
SP系统订购消息接收址果该字段空订购接口机动订购支付结果http方式时告知SP系统该址
url中允许出现特殊字符
String
256
O
optFlag
标志位扩展：
VAS ：增值业务
EPG ：广电EPG
String
10
M
purchaseType
optFlag取值EPG时生效
0：包月支付
1：次m元n时 （m000两位数 n0整型）
2：产品包时段支付
Int
4
M
categoryID
optFlag取值EPG时生效
栏目ID(purchaseType1必填)
String
32
O
contentID
optFlag取值EPG时生效
容ID(purchaseType1必填 contentType123时contentID填频道ID)
String
32
O
contentType
optFlag取值EPG时生效
0：vod（普通节目）1：channel（频道）2：tvod（回）(purchaseType1必填)
int
1
O
sign
数字签名
Md5(transactionID+SPID+userId+userToken+key+productID+price+productName+backPackage+backClass+notifyUrl+optFlag+purchaseType+categoryID+contentID+contentType
String
256



)




事例：
Intent intent new Intent()
设置启动app（包名完整类名）
intentsetClassName(cncombellmannpayment cncombellmannpaymentPayActivity )
intentputExtra(transactionID 1234567)String类参数
intentputExtra(SPID 1000023)
intentputExtra(userID 19000021)
intentputExtra(userIDType 1)Int参数
startActivity(intent)

通json方式传递
Intent intent new Intent()
设置启动app（包名完整类名）
intentsetClassName(cncombellmannpayment cncombellmannpaymentPayActivity )
intentputExtra(jsonData data)String类参数
data {purchaseType0backPackagecomtestsendmessagetransactionIDspa
0002320151226003113151677461048039337productIDproductIDa3000000000000
000000314backClasscomtestsendmessageMainActivityoptFlagVAS
signd9507647ffead8cda5fb06107ae1defdprice100SPIDspa00023
userToken＼51235212159334066714
＼4032userIdcvxgr|notifyUrlproductName亚信测试产品1元
次key02}

13 接口应答调方式
接口方：支付APP à SP台
接口功：SP台返回进行统鉴权订购
承载方式：android intent
调包名 backPackage（支付接口返回）
调类名 backClass（支付接口返回）
14 接口应答消息
名称
说明
数类型
长度（字节）
否必选
transactionID
事务编号具体定义详见附件
String
40
M
result
0：成功
：失败
String
4
M
description
结果描述
String
256
O
sign
数字签名
String
256
M

实例
String json getIntent()getStringExtra(jsonData)String
notifyUrl 返回事例：
httpxxxxxxxxxxxnotifyUrlINFO6789430650000010

2 业务鉴权接口
承载协议：SOAP
接口方：增值业务台↔ 业务理台
接口功：业务鉴权
调接口：httpipportservicesSPSysInterface
21 接口请求消息
名称
说明
数类型
长度（字节）
否必选
transactionID
事务编号具体定义详见附件
String
40
M
SPID
SP唯标示基业务鉴权时效
String
8
M
userID
户帐号
String
20
M
userIDType
户帐号类型
0：普通户（需绑定机顶盒）
1：测试户(需绑定机顶盒)
int
4
O
userToken
该户分配时身份证明EPG页面调时必填
String
32
M
productID
产品编号
String
32
M
timeStamp
时间戳格式：
YYYYMMDDHHMISS
String
14
M

22 接口应答消息
名称
说明
数类型
长度（字节）
否必选
transactionID
事务编号具体定义详见附件
String
40
M
result
0成功 ：失败
String
4
M
userID
户帐号
String
20
M

userIDType
户帐号类型
0：普通户（需绑定机顶盒）
1：测试户(需绑定机顶盒)
int
4
M
productID
产品编号
String
32
M
productName
产品名称
String
100
M
expiredTime
定购关系鉴权失效时间绝时间表示格式：YYYYMMDDHHMISS参数空表示该定购关系鉴权长期效
String
14
O
purchaseType
0：包月
1：次
int
4
O
changingPolicyDesc
计费信息描述
String
256
M
subscriptionExtend
否动续定
0：
1：否
int
4
O
附录 B：事务编号transactionID
事务编号具体定义详见附件定义：
spid(8)+ YYYYMMDDHHMISS(14)+增字符串序号(18)
sp编码定义：
亚信理台：99999999
应理台：99999998
台：90000001
二台：90000002
（谁请求谁创建响应请求相）

附件C：加解密算法


说明：
1．userIduserToken通调ContentProvider获取
2．事务编号：spid(8)+ YYYYMMDDHHMISS(14)+增字符串序号(18)拼接出spid需申请spidspa00030
3．工具类里面封装生成事物编号获取keyuserIduserToken加密方法附：androiddemo里面工具类UserTools通contentprovider获取userIduserToken方法
文档香网(httpswwwxiangdangnet)户传

《香当网》用户分享的内容，不代表《香当网》观点或立场，请自行判断内容的真实性和可靠性！
该内容是文档的文本内容，更好的格式请下载文档