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 |
|
格式如:{"list":[{"linetext":"行标题1:标题内容1","doublehight":"0"},{"linetext":"行标题2:标题内容2","doublehight":"1"}]},参数说明如下:
参数 | 说明 | |||||||
---|---|---|---|---|---|---|---|---|
list |
|
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数据包参数 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|