退货-扫码支付
该交易处理流程为,商家收银应用确认要为客户扫码支付进行退款后,向USDK发起退货-扫码支付交易请求,并同时将退款金额、原收款交易的参考号、原收款交易日期等要素发送到USDK。退货交易可受理退货周期内(一般为30个自然日)的部分或全额退款。
注:扫码支付未收到应答或超时(应答码:98)时,建议反复发起末笔查询或提取指定交易明细进行查询,直至接收到扫码支付交易的实际支付结果。若最终未获取到交易状态,该笔交易的相关信息将在下笔扫码支付交易发起时清除,若有争议按差错流程处理。
接口调用说明
http请求方式:POST
http://YOUR_POS_IP:9801/trans
[YOUR_POS_IP]为通联智能终端的本机IP地址,若应用在终端上运行可直接使用localhost。
调用示例
{
"business_id":"300300001"
"amount":"000000000001",
"orig_ref_no":"181340979176"
"orig_date":"1206"
"orig_trace_no":"170445505"
"trans_check":“YOUR_TRANS_CHECK”
}
请求参数说明
| 参数 | 是否必须 | 说明 |
|---|---|---|
| business_id | 是 | 业务类型 |
| amount | 否 | 退款金额(12位以分为单位) |
| orig_ref_no | 否 | 原收款交易-通联系统交易参考号(ref_no),自主收单模式下必填 |
| orig_date | 否 | 原收款交易-交易日期MMDD(date),自主收单模式下必填 |
| orig_trace_no | 否 | 原收款交易返回的交易单号(trace_no),收银宝模式下必填 |
| trans_check | 否 | 交易唯一标识(30位以内,只支持数字+字母):由收银端生成,指向具体一笔交易,便于后续查询。 |
返回示例
{
"rejcode":"00",
"rejcode_cn":"交易成功",
"business_id":"300300001"
"amount":"000000000001",
"trans_check":"YOUR_TRANS_CHECK",
"merch_name":"通联支付测试商户",
"merch_id":"990581048996000",
"ter_id":"10000018",
"batch_no":"000002",
"trace_no":"000381",
"ref_no":"151756937016",
"orig_ref_no":"151756937016",
"date":"1206",
"time":"182219",
"orig_date":"1206",
"trans_channel":"006",
"oper_no":"01"
}
返回参数说明
| 参数 | 是否必须 | 说明 |
|---|---|---|
| rejcode | 是 | 交易应答码(最长6位字符串) |
| rejcode_cn | 是 | 交易应答码中文解释(最长40位字符串) |
| business_id | 是 | 业务类型 |
| amount | 否 | 退款金额(12位以分为单位) |
| trans_check | 否 | 交易唯一标识(30位以内,只支持数字+字母):由收银端生成,指向具体一笔交易,便于后续查询。 |
| merch_name | 是 | 通联支付特约商户中文名称 |
| merch_id | 是 | 通联支付特约商户编码 |
| ter_id | 是 | 通联支付特约商户终端编码 |
| batch_no | 否 | 终端交易批次号 |
| trace_no | 否 | 终端交易凭证号 |
| orig_trace_no | 否 | 原收款交易返回的交易单号(trace_no |
| ref_no | 否 | 通联系统交易参考号 |
| orig_ref_no | 否 | 原收款交易-通联系统交易参考号(ref_no) |
| date | 否 | 交易日期MMDD |
| time | 否 | 交易时间HHMMSS |
| orig_date | 否 | 原消费交易-交易日期MMDD(date) |
| trans_channel | 是 | 终端交易渠道 |
| oper_no | 否 | 终端操作员号(默认01) |
正常情况下交易成功时,rejcode将为“00”,收到应答成功后再解析其他响应字段。