返回支付接口V1.0   支付接口V2.0

请求说明

form表单请求方式:post
http://api.tlinx.cn/out/paySub

参数说明

参数 是否必须 说明
pass_token 获取到的凭证
tradeno 第三方交易号(不能重复提交)
tradeamount 交易金额(最多保留小数点后两位)
tradedetail 交易明细(非必传,若传值格式如:<input type="hidden" name="tradedetail" value='{"list":[{"name":"商品名称1","url":"商品链接1","num":"商品数量1","price":"商品价格1"},{"name":"商品名称2","url":"商品链接2","num":"商品数量2","price":"商品价格2"}]}' />,必须进行转义处理,不传值则用""代替,参与签名时也必须一致,详情可查看交易明细说明)
tradeurl 交易完成同步回调地址(交易完成后的异步结果通知进行成功或失败提示的页面跳转链接地址,必须使用URLEncoder.encode("http://www.123.com","UTF-8")进行处理,签名时也必须一致,交易完成后T-Linx会以form表单post请求方式请求该链接地址,并将返回的JSON数据包以参数"data"回传给开发者)
sign 签名字符串(MD5加密签名,编码格式UTF-8,生成32位小写字符串)
requrl 请求完成异步回调通知地址(支付请求完成时的同步结果通知链接地址,必须使用URLEncoder.encode("http://www.123.com","UTF-8")进行处理,无需参与签名,若传入该参数则请求完成后后T-Linx会以http协议post请求方式请求该链接地址,并将返回的JSON数据包以参数"data"回传给开发者)
revokeurl 交易撤销完成异步回调地址(交易撤销完成后的异步结果通知链接地址,必须使用URLEncoder.encode("http://www.123.com","UTF-8")进行处理,无需参与签名,若传入该参数则交易撤销完成后T-Linx会以http协议post请求方式请求该链接地址,并将返回的JSON数据包以参数"data"回传给开发者)
v 版本号(默认为1.0)
isverify 是否开启收银台卡券包(1是0否)
printdetail 收银台小票打印明细(非必传,若传值格式如:<input type="hidden" name="printdetail" value='{"list":[{"linetext":"行标题1:标题内容1","doublehight":"0"},{"linetext":"行标题2:标题内容2","doublehight":"1"}]}' />,必须进行转义处理,详情可查看打印明细说明)

交易明细说明

格式如:{"list":[{"name":"商品名称1","url":"商品链接1","num":"商品数量1","price":"商品价格1"},{"name":"商品名称2","url":"商品链接2","num":"商品数量2","price":"商品价格2"}]},参数说明如下:

参数 说明
list
参数 说明
name 商品名称
url 商品链接
num 商品数量
price 商品价格

打印明细说明

格式如:{"list":[{"linetext":"行标题1:标题内容1","doublehight":"0"},{"linetext":"行标题2:标题内容2","doublehight":"1"}]},参数说明如下:

参数 说明
list
参数 说明
linetext 行内容(标题:内容)
doublehight 行样式(0普通1加高加粗)

签名机制(开发者可下载TLinxMd5Encrypt加密_Java版进行参考)

1、需要参与签名的参数:在请求参数列表中,除去sign、requrl、revokeurl参数外,其他参数都需要参与签名,其中非必传参数没有传值时用""代替,如下:

String[] parameters={
	"pass_token=5c411t725a3k3g1d630x583v6j1a5h3",
	"tradeno=000000000000000",
	"tradeamount=0.01",
	"tradedetail=",
	"tradeurl=http%3A%2F%2Fwww.123.com"
};
					

2、生成待签名字符串:对数组里的每一个值按以下顺序进行排序,并以"&"字符连接起来,格式如下:pass_token=5c411t725a3k3g1d630x583v6j1a5h3&tradeno=000000000000000&tradeamount=0.01&tradedetail=&tradeurl=http%3A%2F%2Fwww.123.com,以上字符串便是待签名字符串,注意顺序必须按规则保持一致,否则校验无法通过,签名之后的结果为:88799a8792687d063472742213ab39dd。

请求完成异步回调通知

若开发者在访问支付请求接口时传入了requrl参数则当支付请求完成时T-Linx会以http协议post请求方式请求requrl(支付请求完成时的同步结果通知链接地址),并将返回的JSON数据包以参数"data"回传给开发者。

正常情况下,T-Linx会返回下述JSON数据包给开发者:

{
	"ret":"0",
	"msg":"ok",
	"errcode":"0"
}
					
参数 说明
ret 标识(值为0或1,为0表示当前没有错误,为1表示当前有错误)
msg 错误描述
errcode 错误代码

交易完成同步回调通知

当交易完成后T-Linx会以form表单post请求方式请求tradeurl(交易完成后的异步结果通知进行成功或失败提示的页面跳转链接地址),并将返回的JSON数据包以参数"data"回传给开发者。

交易撤销完成异步回调通知

若开发者在访问支付请求接口时传入了revokeurl参数则交易撤销完成后T-Linx会以http协议post请求方式请求revokeurl(交易撤销完成后的异步结果通知链接地址),并将返回的JSON数据包以参数"data"回传给开发者。

正常情况下,T-Linx会返回下述JSON数据包给开发者:

{
	"ret":"0",
	"msg":"ok",
	"errcode":"0",
	"list":[{
		"orderid":"11111111111111111111",
		"tradeno":"000000000000000",
		"tradedetail":"",
		"tradetype":"消费",
		"trstatus":"1",
		"payname":"现金支付",
		"tramount":"100.00",
		"isproof":"0",
		"prooftype":"",
		"proofid":"",
		"prcontent":"",
		"mlamount":"0.00",
		"realamount":"100.00",
		"tradedate":"2014-10-30 09:19:16",
		"revokedate":"",
		"mlamount":"0.00",
		"oldorderid":"",
		"notpriamount":"0.00",
		"gjamount":"0.00"
	}]
}
					
参数 说明
pass_token 获取到的凭证
tradeno 第三方交易号
tradeamount 交易金额
tradedetail 交易明细
tradeurl 交易完成异步回调地址
sign 签名字符串
requrl 请求完成同步回调地址
revokeurl 交易撤销完成异步回调地址
data 获取返回JSON数据包参数
参数 说明
ret 标识(值为0或1,为0表示当前没有错误,为1表示当前有错误)
msg 错误描述
errcode 错误代码
list
参数 说明
orderid 交易订单号
tradeno 第三方交易号
tradedetail 交易明细(若有值则返回JSON数据包,否则为空字符)
list
参数 说明
name 商品名称
url 商品链接
num 商品数量
price 商品价格
tradetype 交易类型(消费/消费撤销)
trstatus 交易状态(0支付失败1支付成功2未支付)
payname 支付方式名称(如:现金支付、支付宝支付、微信支付、百度支付等)
tramount 交易金额
isproof 是否使用优惠凭证(1是0否)
prooftype 优惠凭证类型(1优惠券2会员卡)
proofid 优惠凭证编号
prcontent 优惠凭证权益
realamount 实际交易金额(交易金额-卡券优惠金额-抹零优惠金额-改价优惠金额)
tradedate 交易时间
revokedate 撤销时间
mlamount 抹零优惠金额
oldorderid 原交易订单号(交易撤销时有值)
notpriamount 不参与优惠金额
gjamount 改价优惠金额