对接浦发银行支付（五）-- 主动查询支付结果

news2024/12/23 22:59:02

一、背景

上一篇我们介绍了支付回调接口的对接情况，当回调出现网络等异常情况，导致用户的支付订单未及时处理或处理失败的时候，商户则需要自己主动向浦发银行发起查询支付结果。
主动查询支付结果，发挥补偿重试的重要作用，在对接支付的流程中，是不可缺少的一个环节。

支付回调是被动接收“消息”，查询支付结果则是主动去获取“消息”。（这里的消息是指订单支付的结果通知）

共同点是：它们的业务逻辑处理相同，触发更新支付订单。

本文仅对主动查询支付结果的接口介绍，后文将要对接查询退款结果接口所使用的是同一个接口。支付和退款的处理逻辑大差不差，处理对象不同而已。（前者是支付订单，后者是退款订单）

二、流程图

在这里插入图片描述

三、接口说明

接口名称：对公收款交易查证
接口URI：/api/corporateAccounts/payments/status
调用方式：GET
必填的请求参数：

浦发银行官方提供的文档不准确，详细见下文。

- tranOrdrNo：实际是非必填参数，文档也即下面的截图不对，它和后面的mrchOrdrNo两者二选一的关系。
- mrchOrdrNo：平台支付流水号，它和上一个参数tranOrdrNo二者是二选一的关系。
- tranDate：必填参数，还是那句话，画蛇添足的一个字段。如果不传，则报错–“errInfo”: “输入交易日期不能为空”
- mrchId：商户号，必填参数
  订正文档：tranOrdrNo和mrchOrdrNo的必填选项应该是C，表示某条件成立时必须填写的域。

报文示例

请求报文

交易日期tranDate，是在发起支付请求接口中，和银行支付流水号tranOrdrNo一起保存在支付订单里。只因为它是必传参数，可是其他支付渠道并无此要求，所以我把tranDate保存在字段–支付成功时间payOkDate。

1、以平台支付流水号为依据发起主动查询（建议）

{
    "mrchId": "310319982990001",
    # 平台支付流水号
    "mrchOrdrNo": "0624041809544B0018534",
    "tranDate": "20240418"
}

2、以浦发银行支付流水号为依据发起主动查询（文档说tranOrdrNo字段是必填，说法不对，这里再次提醒）

{
    "mrchId": "310319982990001",
    # 银行支付流水号
    "tranOrdrNo": "1901041809532900122081065712",
    "tranDate": "20240418"
}

响应报文

并不会返回商户支付流水号！！！关键返回字段：{ “ordrSt”: “00”,
“tranAmt”: “0.01”,
“ordrSt”: “00”,
“tranTimep”: “20240418095400”,
“frmrMrchOrdrNo”: “1901041809532900122081065712” }

{
    "statusCode": "0000",
    "transNo": "04972404186851005317430509",
    "usrFlgId": "",
    "isSbscrbFlg": "",
    "usrChildFlg": "",
    "isFlag": "",
    "transAmt": "",
    "busnPckt": "",
    "clueDtl": "",
    "totalAmt": "",
    "ordrAmt": "",
    "wthdrwnUsAmtCnl": "",
    "retGdsAmt": "",
    "rfdAmt": "",
    "vcherNum": "",
    "fundSource": "",
    "inAcctName": "",
    "rfndRlst": "",
    "byrOfAlipayAcctNO": "",
    "actRcvAmt": "",
    "byrPayAmt": "",
    "usPntsPayAmt": "",
    "toUsEstbInvAmt": "",
    "clientID": "",
    "inrChlCnlNo": "",
    "mrchStrNm": "",
    "userId": "",
    "addItInNal": "",
    "infoDsc": "",
    "fldData": "",
    "bussRetCd": "",
    "returnInfo": "",
    "trdMerMechNo": "",
    "weChatSubMechNo": "",
    "errCode1": "",
    "errInfo": "",
    "terminalNo": "",
    "tranType": "",
    "ordrSt": "00",
    "pyBnkInfo": "",
    "cmdtyInfo": "",
    "tranAmt": "0.01",
    "ccy": "",
    "thdPltfrmTm": "",
    "thdPtySeq": "",
    "tranOrdrNo": "",
    "tranDate": "20240418",
    "clrgDate": "",
    "tranTimep": "20240418095400",
    "mrchTm": "",
    "bussLstNo": "",
    "frmrMrchDate": "",
    "frmrMrchOrdrNo": "1901041809532900122081065712",
    "orgClrgDt": "",
    "tranCode": "OOPY",
    "mrchId": "310319982990001",
    "openBrNo": "",
    "instId": "",
    "mrchDvlpmBnkNo": "",
    "mrchDvlpmBnkBrId": "",
    "strNo": "",
    "cshrNo": "",
    "mrchlInfmAdr": "",
    "channelNo": "",
    "hvWthdrwnAmt": "0.00",
    "rfndblAmt": "0.01",
    "hvThdChrgAmt": "",
    "reserveAmt": "",
    "chrgAmt": "",
    "charges": "",
    "prjPrdTp": "",
    "ordrPcsSt": "",
    "trdRtCd": "00",
    "feeRtId": "",
    "cmdtyDsc": "",
    "crdType": "",
    "bussTrm": "",
    "thdPtyObjNo": "",
    "remark1": "",
    "remark2": "11",
    "dcnRfdDtl": "",
    "crtTm": "",
    "cashRfndAmt": "",
    "pblcAcctId": "",
    "bussRetInfo": "",
    "trdStInfo": "",
    "bussStatusDsc": "",
    "weRfndStatus": "",
    "aLTrnCrc": "",
    "pymtMd": "",
    "dscntAmnt": "",
    "mdsctAmnt": "",
    "byUserType": "",
    "acceptEndTime": "",
    "pftSt": "",
    "errCode2": "",
    "byrRfndAmnt": "",
    "dscntRfndAmnt": "",
    "mdsctRfndAmnt": "",
    "trdChnl": "",
    "rsrvFld1": "",
    "rsrvFld2": "",
    "rsrvFld3": "",
    "rsrvFld4": "",
    "rsrvFld5": "",
    "rsrvFld6": "",
    "rsrvFld7": "",
    "remark3": "",
    "tranVrfyInfo": [

    ]
}