交易关单¶
当发起一笔支付订单以后,如长时间未支付,可通过此接口对此笔交易进行关单处理。
用于对超过1分钟还未支付的订单进行关闭操作。此接口目前只支持微信和支付宝,不支持银联二维码,发起关单操作的订单必须距离发起下单操作60S以上。
发起关单时,返回的原交易状态 org_trans_stat
仅供参考,保险起见,关单成功后商户应该再次通过交易查询接口获取原交易的支付信息详情。
请求参数¶
- 请求地址
https://spin.cloudpnr.com/toprrc/close
- 公共请求参数
请求报文头HEADER - 「接口规则-参数规定-报文头」 ,请求报文体BODY - 「接口规则-参数规定-报文体」 ,响应报文体 - 「接口规则-参数规定-响应报文体」
- 请求参数(data)
参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
---|---|---|---|---|---|
req_seq_id | 请求流水号 | String | Y | 128 | 请求流水号 |
req_date | 请求时间 | String | Y | 8 | 请求时间 |
huifu_id | 商户号 | String | Y | 32 | 汇付分配的商户号 |
org_req_seq_id | 原交易请求流水号 | String | Y | 128 | 原交易请求流水号 |
org_req_date | 原交易请求日期 | String | Y | 8 | 原请求时间YYYYMMDD |
响应参数¶
- 同步响应参数(data)
参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
---|---|---|---|---|---|
sub_resp_code | 业务返回码 | String | Y | 8 | 见附录 业务返回码 |
sub_resp_desc | 业务返回描述 | String | Y | 512 | 业务返回描述 |
req_seq_id | 请求流水号 | String | N | 128 | 请求流水号 |
req_date | 请求日期 | String | N | 8 | 请求日期 |
hf_seq_id | 汇付流水号 | String | N | 128 | 汇付流水号 |
org_req_seq_id | 原交易请求流水号 | String | Y | 128 | 原交易请求流水号 |
org_req_date | 原交易请求日期 | String | Y | 8 | 原请求时间YYYYMMD |
huifu_id | 商户号 | String | Y | 32 | 汇付分配的商户号 |
trans_stat | 关单状态 | String | Y | 1 | S—成功 F – 失败 P–处理中 |
org_trans_stat | 原交易状态 | String | N | 1 | I—初始 S—成功 F – 失败 P–处理中 |
请求示例¶
{
"sign_type": "RSA2",
"sys_id": "test",
"sign": "TEST_SIGN",
"data": "{\"orgReqDate\": \"20191221\",\"req_seq_id\": \"20191221104750E82396\",\"sys_id\": "test",\"req_date\": \"20191223\",\"req_seqId\": \"20191223E82951\",\"huifuId\": \"00125416332665\"}"
}
响应示例¶
{
"resp_code":"10000",
"resp_desc":"成功调用",
"sign": "TEST_SIGN",
"data": "\"org_req_date\": \"20191212\",\"org_req_seqId\": \"20191212093153E67145\",\"org_trans_stat\": \"F\",\"trans_stat\": \"S\",\"req_date\": \"20191202\",\"req_seq_id\": \"20191202112111269\",\"sub_resp_code\": \"00000000\",\"sub_resp_desc\": \"成功\",\"huifu_id\": \"00125416332665\",\"hf_seq_id\": \"00310000000191202172103Pea77df66c3f23035\""
}
- 接口调用实例