二维码支付查询参数
在查询属性文件中配置查询属性。
- 请求参数
- 响应参数
必填字段
字段名称 | 类型 | 长度 | 描述 | 例子 |
---|---|---|---|---|
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" OrgRespCode
String 8 原始响应代码。
注意: 如果原始银行响应代码不超过 8 个字符,则此字段可用。 " " OrigTxnAmt
String(数值) 12 原始交易金额。 "10000" OrigCurrCode
String 3 原始交易货 币数字代码。 "458" TxnChannel
String 3 交易渠道。 "WEB" - 网络渠道(默认),
"API"- 通过 API,
"DIR" - 直接,
"GDS" - GDS 渠道,
"OTH" – 其他 FICode
String 20 金融机构代码。 附录 4
注意: 仅适用于 UppPymtMode
= 01 的 FPX 支付。 "CIMB" PymtGwRefNo
String 20 支付网关参考号。 "230303154349AC010FNX" TxnStatDetCde
String 4 交易状态详细代码。 "0000" TxnStatMsg
String 256 交易状态消息 "已批准" ServiceID
String 3 PayMaster 提供的服务标识符。 "FNX" MerchHostID
String 8 商户主机标识符。 "M2022121" MerchSessionID
String 256 商户会话 ID。 "2023030315435025" OrderRefNo
String 34 订单参考号。 "OTMEGASTORE-20010831-ONLINE-007" FPXRefNo
String 20 金融机构生成的唯一 FPX 参考号。
注意: 仅适用于 UppPymtMode
= 01 的 FPX 支付并存在于金融机构系统中。 "3143323587217932" UppPymtMode
String 2 在 UPP 页面选择的支付方式。 "00" - 信用卡/借记卡支付,
"01" - FPX 支付,
"99" - 未知或在处理过程中发生了某些错误 ExpOrigTxnAmt
String 1 原始交易金额的指数。 "2"
CardNo
注意: 仅适用于信用卡/借记卡支付方式。
TxnDtTm
格式: yyyymmddhhmmss
TxnAmt
CurrCode
AuthIDRespCode
注意: 由发卡方生成并转发给收单方,指示交易的批准。仅适用于成功支付。
ExpTxnAmt
RetrievalRefNo
注意: 如果收单行在响应消息中返回此字段,则此字段可用。
OrgRespCode
注意: 如果原始银行响应代码不超过 8 个字符,则此字段可用。
OrigTxnAmt
OrigCurrCode
TxnChannel
"API"- 通过 API,
"DIR" - 直接,
"GDS" - GDS 渠道,
"OTH" – 其他
FICode
注意: 仅适用于
UppPymtMode
= 01 的 FPX 支付。PymtGwRefNo
TxnStatDetCde
TxnStatMsg
ServiceID
MerchHostID
MerchSessionID
OrderRefNo
FPXRefNo
注意: 仅适用于
UppPymtMode
= 01 的 FPX 支付并存在于金融机构系统中。UppPymtMode
"01" - FPX 支付,
"99" - 未知或在处理过程中发生了某些错误
ExpOrigTxnAmt
MerchRefNo
、MerchantID
、OrderRefNo
、CardNo
、TxnChannel
、CurrCode
、TxnAmt
、ExpTxnAmt
、OrigCurrCode
、OrigTxnAmt
、ExpOrigTxnAmt
、MerchHostID
和 MerchSessionID
与先前付款请求中的值相同。
消息示例
- 请求
- 回复
二维码支付查询请求
{
"paymentID": "U02",
"merchantID": "000010000099939",
"serviceID": "",
"merchRefNo": "MYB2023030315435025LL",
"queryRespURL": ""
}
二维码支付查询响应
{
"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"
}