交易关单

当发起一笔支付订单以后,如长时间未支付,可通过此接口对此笔交易进行关单处理。

用于对超过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\""
}
  • 接口调用实例

Demo参考