UPP 支付查询参数

以下参数提供给 PayMaster 用于支付查询请求。一旦 PayMaster 从数据库中检索到支付交易状态，它就会将检索到的信息作为响应返回给商户的服务器。

请求参数
响应参数

必填字段

字段名称	类型	长度	描述	例子
`PaymentID`	String	3	付款方式/功能。	"U02" – UPP 支付状态查询
`MerchantID`	String	15	商户 ID。	"000010000099939"
`ServiceID`	String	3	服务 ID。	"FNX"
`MerchRefNo`	String	40	唯一的商户参考号。	"MYB2023030315435025LL"
`QueryRespURL`	String	512	查询响应页面。	"https://XXX.XXXXX.XXX/query.jsp"

必填字段

字段名称	类型	长度	描述	例子
`MerchantID`	String	15	商户 ID。	"000010000099939"
`TxnStatus`	String	2	付款状态。附录 3	"00"
`MerchRefNo`	String	40	唯一的商户参考号。	"MYB2023030315435025LL"
`QueryStatus`	String	2	查询状态。附录 3	"00"

可选字段

字段名称	类型	长度	描述	例子
`CardNo`	String	19	卡号。注意：仅适用于信用卡/借记卡付款方式。	"545301XXXXXX5323"
`TxnDtTm`	String	14	交易日期和时间。格式：yyyymmddhhmmss	"20230303154833"
`TxnAmt`	String (数字)	12	交易金额。	"100.00"
`CurrCode`	String	3	货币代码。	"458"
`AuthIDRespCode`	String	6	授权 ID 响应代码。注：由发行人生成并转发给收单机构以表明交易的批准。仅限支付成功。	"457180"
`ExpTxnAmt`	String	1	交易金额的指数。	"0"
`RetrievalRefNo`	String	12	检索参考号。注意：如果收单方在响应消息中返回该字段，则可用。	"306274008021"
`OrigTxnAmt`	String (数字)	12	原始交易金额。	"10000"
`OrigCurrCode`	String	3	原始交易货币数字代码。	"458"
`TxnChannel`	String	3	交易渠道。	"WEB" - 网络频道 (默认)， "API"- 通过 API， "DIR" - 直接的， "GDS" - 万国数据系统频道， "OTH" – 其他的
`FICode`	String	20	金融机构代码。注意：适用于 `UppPymtMode` = 01 的 FPX 付款。	"CIMB"
`PymtGwRefNo`	String	20	支付网关参考号。	"230303154349AC010FNX"
`TxnStatDetCde`	String	4	交易状态详细代码。	"0000"
`TxnStatMsg`	String	256	交易状态信息。	"Approved"
`ServiceID`	String	3	PayMaster 提供的服务标识符。	"FNX"
`MerchHostID`	String	8	商户主机标识符。	"M2022121"
`MerchSessionID`	String	256	商户会话 ID。	"2023030315435025"
`OrderRefNo`	String	34	订单参考号。	"OTMEGASTORE-20010831-ONLINE-007"
`FPXRefNo`	String	20	由 FI 生成的唯一 FPX 参考号。注意：可用于 FPX 支付，并存在于 FI 系统中，且 `UppPymtMode` = 01。	"3143323587217932"
`UppPymtMode`	String	2	在 UPP 页面选择付款方式。	"00" - 信用卡/借记卡付款, "01" - FPX 支付， "99" - 处理过程中发生未知或某些错误
`OrigRespCode`	String	8	原始响应代码。附录 3	" "
`ExpOrigTxnAmt`	String	1	原始交易金额的指数。	"2"

MerchRefNo、MerchantID、OrderRefNo、CardNo、TxnChannel、CurrCode、TxnAmt、ExpTxnAmt、OrigCurrCode、OrigTxnAmt、ExpOrigTxnAmt、MerchHostID 和 MerchSessionID 与先前付款请求中的值相同。

消息示例

请求
响应

UPP 付款查询请求
{
  "paymentID": "U02",
  "merchantID": "000010000099939",
  "serviceID": "",
  "merchRefNo": "MYB2023030315435025LL",
  "queryRespURL": ""
}

UPP 付款查询响应
{
  "merchantID": "000010000099939",
  "cardNo": "545301XXXXXX5323",
  "txnDtTm": "20230303154833",
  "txnAmt": "100.00",
  "txnStatus": "00",
  "currCode": "458",
  "authIDRespCode": "457180",
  "expTxnAmt": "2",
  "retrievalRefNo": "306274008021",
  "origRespCode": "",
  "pymtGwRefNo": "230303154349AC010FNX",
  "txnStatDetCde": "0000",
  "txnStatMsg": "Approved",
  "serviceID": "FNX",
  "merchHostID": "",
  "merchSessionID": "2023030315435025",
  "merchRefNo": "MYB2023030315435025LL",
  "orderRefNo": "",
  "uppPymtMode": "00",
  "queryStatus": "00",
  "origCurrCode": "458",
  "origTxnAmt": "10000",
  "expOrigTxnAmt": "0",
  "FICode": "",
  "FPXRefNo": "",
  "txnChannel": "WEB"
}

UPP 支付查询参数

消息示例​

消息示例