退款

方法 GET

URL

https://xxx.finexusgroup.com/upp/faces/reversal0400.xhtml?

请求参数
响应参数

必填字段

字段名	类型	长度	描述	示例
`h001_MTI`	String	4	消息类型标识符。	`0400`
`h002_VNO`	String	2	版本号。	`06`
`h003_TDT`	String	8	传输日期（`YYYYMMDD`）。	`20010831`
`h004_TTM`	String	8	传输时间。	`12432905`
`f001_MID`	String	15	商户编号（MID）。	`120567801561128`
`f003_ProcCode`	String	6	处理代码。使用 `993000` – 按 RRN 退款。	`993000`
`f006_TxnDtTm`	String	14	交易日期和时间（`YYYYMMDDhhmmss`）。	`20010831124329`
`f007_TxnAmt`	String	12	交易金额（与原始交易相同）。	`000000057080`
`f008_POSCond`	String	2	POS 条件代码（与原始交易相同）。	`59`
`f010_CurrCode`	String	3	货币代码。	`458`
`f019_ExpTxnAmt`	String	1	交易金额指数。	`2`
`f023_RRN`	String	12	原始交易的检索参考号。	`102812345678`
`f260_ServID`	String	3	服务 ID。	`FNX`
`f263_MRN`	String	1–40	商户参考号。按 RRN 退款（`993000`）时需提供新的 MRN。	`2012121912345`
`t001_SHT`	String	3	安全哈希算法类型。	`SH2`
`t002_SHV`	String	64	安全哈希值。附录 1	`61936D1EF085FF70CA9682234B7D9159`

可选字段

字段名	类型	长度	描述	示例
`f004_PAN`	String	12–19	条件字段。卡号/账号。当原始付款使用消息 `0200` 时必填。	`4966230077888877`
`f011_AuthIDResp`	String	6	条件字段。原始交易的授权 ID 响应。	`12882J`
`f257_PGRN`	String	20	条件字段。支付网关参考号。	`AJ789EG07S0012012022`
`f261_HostID`	String	8	可选。商户主机 ID。	`AAMWEB02`
`f262_SessID`	String	1–256	可选。商户会话 ID。	`2012121956789`
`f264_Locale`	String	2–5	可选。语言区域设置。	`en`
`f270_ORN`	String	2–34	可选。订单参考号。	`ECT-01-20010830-00380`
`f272_RURL_CCR`	String	1–512	可选。返回 URL。若省略，响应将返回到同一会话。	`https://xxx/refund.jsp`
`f354_TID`	String	8	可选。终端 ID。	`10001112`

必填字段

字段名	类型	长度	描述	示例
`h001_MTI`	String	4	消息类型标识符。	`0410`
`h002_VNO`	String	2	版本号。	`06`
`h003_TDT`	String	8	传输日期。	`20010831`
`h004_TTM`	String	8	传输时间。	`12432905`
`f001_MID`	String	15	商户编号（与请求相同）。	`120567801561128`
`f003_ProcCode`	String	6	处理代码（与请求相同）。	`993000`
`f004_PAN`	String	12–19	主账号。	`4966230077888877`
`f006_TxnDtTm`	String	14	交易日期和时间。	`20010831124329`
`f007_TxnAmt`	String	12	交易金额。	`000000057080`
`f009_RespCode`	String	2	响应代码。	`00`
`f010_CurrCode`	String	3	货币代码。	`458`
`f011_AuthIDResp`	String	6	条件字段。授权 ID 响应。	`12882J`
`f019_ExpTxnAmt`	String	1	交易金额指数。	`2`
`f257_PGRN`	String	20	条件字段。支付网关参考号。	`AJ789EG07S0012012022`
`f258_TxnStatDetCde`	String	4	交易状态详细代码。	`0000`
`f260_ServID`	String	3	服务 ID。	`FNX`
`f263_MRN`	String	1–40	商户参考号。	`20230119110520FNX`
`t001_SHT`	String	3	安全哈希算法类型。	`SH2`
`t002_SHV`	String	64	安全哈希值。附录 1	`...`

可选字段

字段名	类型	长度	描述	示例
`f259_TxnStatMsg`	String	1–256	交易状态消息。	`Approved`
`f261_HostID`	String	8	商户主机 ID。
`f262_SessID`	String	1–256	商户会话 ID。
`f270_ORN`	String	2–34	订单参考号。

f258_TxnStatDetCde — 常用值

代码	类别	含义
`0000`	成功	收单方已批准退款
`0021`	成功	交易此前已退款/冲销
`0076`	成功	对不存在交易的退款已确认
`0022`	重试	退款进行中 — 请查询或稍后重试
`0091`	重试	收单方资源暂时不可用
`0096`	重试	PayMaster 资源暂时不可用
`0013`	致命	无效退款金额
`0014`	致命	授权 ID 不匹配
`0030`	致命	无效消息格式
`0090`	致命	收单方拒绝退款

示例消息

请求
响应

DuitNow Pay 退款请求

curl -X GET \
"https://xxx.finexusgroup.com/upp/faces/reversal0400.xhtml?h001_MTI=0400&h002_VNO=06&h003_TDT=20230526&h004_TTM=15050500&f001_MID=120567801561128&f003_ProcCode=993000&f006_TxnDtTm=20230526112551&f007_TxnAmt=000000000100&f008_POSCond=59&f010_CurrCode=458&f019_ExpTxnAmt=2&f023_RRN=102812345678&f260_ServID=FNX&f263_MRN=20230526150505001&f264_Locale=en&f272_RURL_CCR=http%3A%2F%2Flocalhost%2Fclient%2F&t001_SHT=SH2&t002_SHV=E73CEDA9D9A8D1AAF59BDB919EF7C82D52671A4B457CE816BCE91AFF31485259"

DuitNow Pay 退款响应

https://xxx.finexusgroup.com/payment/refund?h001_MTI=0410&h002_VNO=06&h003_TDT=20230526&h004_TTM=09192100&f001_MID=120567801561128&f003_ProcCode=993000&f006_TxnDtTm=20230526091921&f007_TxnAmt=000000001000&f009_RespCode=00&f010_CurrCode=458&f019_ExpTxnAmt=2&f023_RRN=102812345678&f257_PGRN=&f258_TxnStatDetCde=0000&f259_TxnStatMsg=Approved&f260_ServID=FNX&f263_MRN=20230526150505001&t001_SHT=SH2&t002_SHV=0F3086E879F80EB6BFA8D0E3FFD2D489AE8F4DDFA7B8F8511151B0BE27CF3B79

退款

示例消息​

示例消息