提取指定交易明细
该交易处理流程为,商家收银应用向USDK发起提取指定交易明细交易请求,USDK将查询该笔交易状态并返回。
注:使用场景一般为:
- 客户确认银行卡交易成功,而商家收银应用未收到成功应答
- 终端异常,商家收银应用未获取到交易结果
USDK查询完成后:如返回成功,判定该笔交易成功,USDK默认会打印该笔交易的签购单;如返回失败,判定该笔交易为失败,若有争议按差错流程处理。
接口调用说明
http请求方式:POST
http://YOUR_POS_IP:9801/trans
[YOUR_POS_IP]为通联智能终端的本机IP地址,若应用在终端上运行可直接使用localhost。
调用示例
{
"business_id":"900100004"
"trans_check":“YOUR_TRANS_CHECK”
}
请求参数说明
| 参数 | 是否必须 | 说明 |
|---|---|---|
| business_id | 是 | 业务类型 |
| trans_check | 是 | 待提取交易的交易唯一标识(30位以内,只支持数字+字母)。 |
返回示例
{
"rejcode":"00",
"rejcode_cn":"交易成功",
"business_id":"100100001"
"amount":"000000000001",
"trans_check":"YOUR_TRANS_CHECK",
"merch_name":"通联支付测试商户",
"merch_id":"990581048996000",
"ter_id":"10000018",
"cardno":"6226880057559585",
"exp_date":"2008"
"batch_no":"000001",
"trace_no":"000026",
"ref_no":"151756937016",
"auth_no":"936015",
"date":"1206",
"time":"151756",
"trans_channel":"006",
"oper_no":"01"
}
返回参数说明
| 参数 | 是否必须 | 说明 |
|---|---|---|
| rejcode | 是 | 交易应答码(最长6位字符串) |
| rejcode_cn | 是 | 交易应答码中文解释(最长40位字符串) |
| business_id | 是 | 业务类型 |
| amount | 否 | 收款金额(12位以分为单位) |
| trans_check | 否 | 交易唯一标识(30位以内,只支持数字+字母):由收银端生成,指向具体一笔交易,便于后续查询。 |
| merch_name | 是 | 通联支付特约商户中文名称 |
| merch_id | 是 | 通联支付特约商户编码 |
| ter_id | 是 | 通联支付特约商户终端编码 |
| cardno | 否 | 交易卡号 |
| exp_date | 否 | 卡片有效期 |
| batch_no | 否 | 终端当前交易批次号 |
| trace_no | 否 | 该笔交易终端凭证号 |
| ref_no | 否 | 通联支付系统交易参考号 |
| auth_no | 否 | 该笔交易发卡行授权号 |
| date | 否 | 交易日期MMDD |
| time | 否 | 交易时间HHMMSS |
| trans_channel | 是 | 终端交易渠道 |
| oper_no | 否 | 终端操作员号(默认01) |
正常情况下交易成功时,rejcode将为“00”,收到应答成功后再解析其他响应字段。