UPP 支付查询参数

信息

以下参数提供给 PayMaster 作为支付查询请求。 在从数据库检索支付交易状态后，PayMaster 将返回检索到的信息作为响应发送给商户服务器。

请求参数

强制字段

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

返回参数

强制字段

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

可选字段

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

信息

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

示例消息

请求

UPP Payment Query Request

{
    "paymentID": "U02",
    "merchantID": "000010000099939",
    "serviceID": "",
    "merchRefNo": "MYB2023030315435025LL",
    "queryRespURL": ""
}

响应

UPP Payment Query Response

{
    "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"
}