OBW 支付查询

信息

在 查询属性文件 中配置用于查询的属性文件。

请求参数

必填字段

字段名	类型	长度	描述	示例
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"
OrgRespCode	字符串	8	原始响应代码。附录3 注意：如果原始银行响应代码不超过8个字符，则可用。	" "
OrigTxnAmt	字符串（数字）	12	原始交易金额。	"10000"
OrigCurrCode	字符串	3	原始交易货币数字代码。	"458"
TxnChannel	字符串	3	交易渠道。	"WEB" - 网络渠道（默认）， "API" - 通过 API， "DIR" - 直接， "GDS" - GDS 渠道， "OTH" – 其他
FICode	字符串	20	金融机构代码。 附录4 注意：适用于 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" - 未知或处理过程中发生了某些错误
ExpOrigTxnAmt	字符串	1	原始交易金额的指数部分。	"2"

信息

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

示例消息

请求

OBW Payment Query Request

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

响应

OBW Payment Query Response

{
    "merchantID": "000010000099939",
    "cardNo": "545301XXXXXX5323",
    "txnDtTm": "20230303154833",
    "txnAmt": "100.00",
    "txnStatus": "00",
    "currCode": "458",
    "authIDRespCode": "457180",
    "expTxnAmt": "2",
    "retrievalRefNo": "306274008021",
    "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",
    "orgRespCode": ""
}