Skip to main content

QR Payment Parameters

Method GET

URL

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

The following parameters are provided to PayMaster for payment processing.

Upon completion of the QR Transaction Request, PayMaster will send a response to the merchant server. The merchant server should then examine the transaction status (TxnStat) to determine the outcome of the QR Transaction Request.

Mandatory / Conditional Fields

Field NameTypeLengthDescriptionExample
PaymentIDString3Payment method / function."Q01" - QR Payload Generation,
"C05" - E-Commerce Transaction Refund,
"C15" - Reversal for E-Commerce Transaction
MerchantIDString15Assigned merchant ID (MID)."000010000099939"
ProcCodeString6Procedure Code."003000"
SndrIDString34Conditional field
Sender Identification.

Note: Optional for PaymentID = "Q01". SndrID can be a Primary Account Number; LOC Account number; URN; LOC Account Number + last 4 digits PAN or Token to use to uniquely identify the consumer presented QR.		"FNXSMYNX"
TxnAmtString (Numeric)12Transaction amount."1280.99"
POSCondString2Point-of-sale or Point-of-service condition code."67"
CurrCodeString3ISO 4217 currency numeric code."458"
ExpTxnAmtString1Exponent of transaction amount."2"
OrigTxnAmtString (Numeric)12Conditional field
Original transaction amount.

Note: Applicable to PaymentID = "Q02" only. Mandatory if OrigCurrCode exists.		"298.85"
OrigCurrCodeString3Conditional field
Original transaction ISO 4217 currency numeric code.

Note: Mandatory if OrigTxnAmt exists.		"840"
CountryCodeString2Conditional field
ISO 3166-1 alpha-2 country code.

Note: Applicable to PaymentID = "Q02" only.		"MY"
FICodeString20Conditional field
Financial insitution code that entitled for the promotion. Appendix 4		"CIMB"
ServiceIDString3Service ID."FNX"
MerchRefNoString40Unique merchant reference number."2021061414062021072"
SuccRespURLString512Successful payment page."https://xxx.xxxxx.xxx/approved.jsp "
BizNmString35Conditional field
Business Name.

Note: Applicable to PaymentID = "Q02" only.		"Inside Scoop Sdn. Bhd"
BizAddrZIPCodeString10Conditional field
Business Address ZIP Code.

Note: Applicable to PaymentID = "Q02" only.		"63000"
BizAddrStateCodeString4Conditional field
Business Address State Code.

Note: Applicable to PaymentID = "Q02" only.		"10"
TerminalIDString8Terminal ID.

Note: An identification code of fewer than 8 positions must be left-justified and the remainder of the field space-filled.		"T2022121"
PayloadIndString2QR Payload Indicator."12" – Merchant Presented Dynamic QR Code
PANIndString2PAN Indicator."26" – DuitNow RPP,
"97" – Alipay+
SndrIDTypeString1Conditional field
Sender Identification Type.

Note: Optional for PaymentID = "Q01".		"2" - Unique Reference Number (URN)
QRPayloadString512Conditional field
QR Payload.

Note: Applicable to PaymentID = "Q02" only. Refers to QRPayload in response message of the previous PaymentID = "Q01".		"…"
TxnFlagString2Conditional field
Indication of the transaction response reaction.

Note: Applicable to PaymentID = "Q02" only.		"CP" – Consumer Presented Payment
MerchPANString31Conditional field
Merchant PAN.

Note: Applicable to PaymentID = "Q02" only.		"4322071003601010"

Fields formats

  • TxnAmt and OrigTxnAmt - Transaction amount with two decimals and thousand symbols. Maximum length includes the digit(s) after the decimal place.
Optional Fields
Field NameTypeLengthDescriptionExample
AuthIDRespCodeString6Authorisation ID Response Code (AuthIDRespCode) of the response message of the previous PaymentID = "Q01".

Note: Applicable to PaymentID = "Q02" only.		"000000"
RetrievalRefNoString12Retrieval Reference Number.

Note: Applicable to PaymentID = "Q02" only.		"306274008021"
UserContactString20Customer contact number."6012888888"
UserIPAddressString30User IP address.

Note: Subjected to Payment Provider requirement.		"192.168.2.2"
PortalUserIDString256Portal user ID.O5ACzHbvQNm3iNAwdvi1Sg==
DeviceIDString64Customer Device ID."463508442328857/02"
MCCString4Merchant category code or merchant classification code.

Note: Applicable to PaymentID = "Q02" only.		"5411"
TxnIDString50Transaction ID.

Note: Only supported for UnionPay URL QR. Applicable to PaymentID = "Q02" only.		"9205845"

Example Message​

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

© 2024 Finexus Group. All rights reserved.