跳到主要内容

QR 支付参数

Method: GET
URL : https://xxx.finexusgroup.com/upp/faces/generateQrPayload.xhtml?

信息

向 PayMaster 提供以下参数进行支付处理。

完成 QR 交易请求后,PayMaster 将向商家服务器发送响应。商家服务器应检查交易状态 TxnStat 以获取所进行的 QR 交易请求的处理结果。

必填 / 有条件字段

字段名称类型长度描述示例
PaymentID字符串3支付方式 / 功能。"Q01" - QR 负载生成,
"C05" - 电子商务交易退款,
"C15" - 电子商务交易的撤销
MerchantID字符串15分配的商户 ID(MID)。"000010000099939"
ProcCode字符串6流程代码。附录 6"003000"
SndrID字符串34条件字段
发送者身份。

注意: 对于 PaymentID = "Q01" 是可选的。SndrID 可以是主帐号;LOC 帐号;URN;LOC 帐号 + PAN 的最后 4 位数或用于唯一标识呈现 QR 的消费者的 Token。
"FNXSMYNX"
TxnAmt字符串(数字)12交易金额。"1280.99"
POSCond字符串2销售点或服务点条件代码。"67"
CurrCode字符串3ISO 4217 货币数字代码。"458"
ExpTxnAmt字符串1交易金额的指数。"2"
OrigTxnAmt字符串(数字)12条件字段
原始交易金额。

注意: 仅适用于 PaymentID = "Q02"。如果 OrigCurrCode 存在,则为必填项。
"298.85"
OrigCurrCode字符串3条件字段
原始交易的 ISO 4217 货币数字代码。

注意: 如果存在 OrigTxnAmt,则为必填项。
"840"
CountryCode字符串2条件字段
ISO 3166-1 alpha-2 国家代码。

注意: 仅适用于 PaymentID = "Q02"。
"MY"
FICode字符串20享有促销活动的金融机构代码。附录 4"CIMB"
ServiceID字符串3服务 ID。"FNX"
MerchRefNo字符串40唯一的商户参考号。"2021061414062021072"
SuccRespURL字符串512支付成功的页面。"https://xxx.xxxxx.xxx/approved.jsp "
BizNm字符串35条件字段
商业名称。

注意: 仅适用于 PaymentID = "Q02"。
"Inside Scoop Sdn. Bhd"
BizAddrZIPCode字符串10条件字段
商业地址邮政编码。

注意: 仅适用于 PaymentID = "Q02"。
"63000"
BizAddrStateCode字符串4条件字段
商业地址州代码。

注意: 仅适用于 PaymentID = "Q02"。
"10"
TerminalID字符串8终端 ID。

注意: 少于 8 个位置的标识代码必须向左对齐,其余字段需要填充空格。
"T2022121"
PayloadInd字符串2QR 负载指示符。"12" – 商家呈现动态 QRC
PANInd字符串2PAN 指示符。"26" – DuitNow RPP,
"97" – 支付宝+
SndrIDType字符串1条件字段
发送者身份类型。

注意: 对于 PaymentID = "Q01" 是可选的。
"2" - 唯一参考号 (URN)
QRPayload字符串512条件字段
QR 负载。

注意: 仅适用于 PaymentID = "Q02"。指的是先前 PaymentID = "Q01" 的响应消息中的 QRPayload
"…"
TxnFlag字符串2条件字段
交易响应反应指示。

注意: 仅适用于 PaymentID = "Q02"。
"CP" – 消费者呈现支付
MerchPAN字符串31条件字段
商户 PAN。

注意: 仅适用于 PaymentID = "Q02"。
"4322071003601010"
信息

字段格式

  • TxnAmtOrigTxnAmt - 带有两位小数和千位分隔符的交易金额。最大长度包括小数点后的数字。
可选字段
字段名类型长度描述例子
AuthIDRespCode字符串6前一个PaymentID为"Q01"的响应消息的授权 ID 响应代码(AuthIDRespCode)。

注意: 仅适用于PaymentID为"Q02"的情况。
"000000"
RetrievalRefNo字符串12检索参考号。

注意: 仅适用于PaymentID为"Q02"的情况。
"306274008021"
UserContact字符串20客户联系号码。"6012888888"
UserIPAddress字符串30用户 IP 地址。

注意: 受支付提供商要求影响。
"192.168.2.2"
PortalUserID字符串256门户用户 ID。O5ACzHbvQNm3iNAwdvi1Sg==
DeviceID字符串64客户设备 ID。"463508442328857/02"
MCC字符串4商户类别代码或商户分类代码。

注意: 仅适用于PaymentID为"Q02"的情况。
"5411"
TxnID字符串50交易 ID。

注意: 仅支持 UnionPay URL QR。仅适用于PaymentID为"Q02"的情况。
"9205845"

示例消息

QR Payload Generation Request
curl -X GET "https://xxx.finexusgroup.com/upp/faces/generateQrPayload.xhtml?h001_MTI=0180&h002_VNO=06&h003_TDT=20230619&h004_TTM=09593634&f001_MID=000010000012639&f003_ProcCode=000000&f004_PAN=&f007_TxnAmt=000000000100&f008_POSCond=67&f010_CurrCode=458&f019_ExpTxnAmt=2&f256_FICode=&f260_ServID=FNX&f263_MRN=20230619085230QR&f265_RURL_CCPS=https%3A%2F%2Fsandbox.finexusgroup.com%2Fdevserver%2Fadmin%2Fapi%2Fpaymaster%2Fintrx&f279_HP=&f285_IPAddr=&f289_CustId=&f354_TID=10004028&f366_PayloadInd=12&f367_PANInd=26&f368_AcctInd=&f369_DevID=&t001_SHT=SH2&t002_SHV=C00365DC7FFF64961D86CA44D203A3C3E6727910259CA1F15E43FD61D8B01243