二维码支付查询参数
在查询属性文件中配置查询属性。
- 请求参数
- 响应参数
必填字段
| 字段名称 | 类型 | 长度 | 描述 | 例子 |
|---|---|---|---|---|
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" |
可选字段
字段名称 类型 长度 描述 示例 CardNoString 19 卡号。
注意: 仅适用于信用卡/借记卡支付方式。 "545301XXXXXX5323" TxnDtTmString 14 交易日期和时间。
格式: yyyymmddhhmmss "20230303154833" TxnAmtString(数值) 12 交易金额。 "100.00" CurrCodeString 3 货币代码。 "458" AuthIDRespCodeString 6 授权 ID 响应代码。
注意: 由发卡方生成并转发给收单方,指示交易的批准。仅适用于成功支付。 "457180" ExpTxnAmtString 1 交易金额的指数。 "0" RetrievalRefNoString 12 检索参考号。
注意: 如果收单行在响应消息中返回此字段,则此字段可用。 "306274008021" OrgRespCodeString 8 原始响应代码。
注意: 如果原始银行响应代码不超过 8 个字符,则此字段可用。 " " OrigTxnAmtString(数值) 12 原始交易金额。 "10000" OrigCurrCodeString 3 原始交易货币数字代码。 "458" TxnChannelString 3 交易渠道。 "WEB" - 网络渠道(默认),
"API"- 通过 API,
"DIR" - 直接,
"GDS" - GDS 渠道,
"OTH" – 其他 FICodeString 20 金融机构代码。 附录 4
注意: 仅适用于 UppPymtMode = 01 的 FPX 支付。 "CIMB" PymtGwRefNoString 20 支付网关参考号。 "230303154349AC010FNX" TxnStatDetCdeString 4 交易状态详细代码。 "0000" TxnStatMsgString 256 交易状态消息 "已批准" ServiceIDString 3 PayMaster 提供的服务标识符。 "FNX" MerchHostIDString 8 商户主机标识符。 "M2022121" MerchSessionIDString 256 商户会话 ID。 "2023030315435025" OrderRefNoString 34 订单参考号。 "OTMEGASTORE-20010831-ONLINE-007" FPXRefNoString 20 金融机构生成的唯一 FPX 参考号。
注意: 仅适用于 UppPymtMode = 01 的 FPX 支付并存在于金融机构系统中。 "3143323587217932" UppPymtModeString 2 在 UPP 页面选择的支付方式。 "00" - 信用卡/借记卡支付,
"01" - FPX 支付,
"99" - 未知或在处理过程中发生了某些错误 ExpOrigTxnAmtString 1 原始交易金额的指数。 "2"
CardNo注意: 仅适用于信用卡/借记卡支付方式。
TxnDtTm格式: yyyymmddhhmmss
TxnAmtCurrCodeAuthIDRespCode注意: 由发卡方生成并转发给收单方,指示交易的批准。仅适用于成功支付。
ExpTxnAmtRetrievalRefNo注意: 如果收单行在响应消息中返回此字段,则此字段可用。
OrgRespCode注意: 如果原始银行响应代码不超过 8 个字符,则此字段可用。
OrigTxnAmtOrigCurrCodeTxnChannel"API"- 通过 API,
"DIR" - 直接,
"GDS" - GDS 渠道,
"OTH" – 其他
FICode注意: 仅适用于
UppPymtMode = 01 的 FPX 支付。PymtGwRefNoTxnStatDetCdeTxnStatMsgServiceIDMerchHostIDMerchSessionIDOrderRefNoFPXRefNo注意: 仅适用于
UppPymtMode = 01 的 FPX 支付并存在于金融机构系统中。UppPymtMode"01" - FPX 支付,
"99" - 未知或在处理过程中发生了某些错误
ExpOrigTxnAmtMerchRefNo、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"
}