Skip to main content

Pre-Auth Payment Parameters

Method GET

URL

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

The following parameters are provided to PayMaster for payment processing. Upon completion of the UPP payment process, PayMaster will redirect the customer's browser to the specified return URL according to the completion status.

Mandatory / Conditional Fields

Field NameTypeLengthDescriptionExample
PaymentIDString3Payment method / function."U01" - UPP Transaction,
"U02" - UPP Transaction Status Query
EcommMerchIndString1Ecommerce merchant indicator."0" - Non-E-Commerce merchant,
"1" - E-Commerce (3D Secure),
"2" - E-Commerce (Non-3D Secure/MOTO)
TxnAmtString (Numeric)12Transaction amount with two decimals and thousand symbols.

Note: Maximum length includes the digit(s) after the decimal place.		"1280.99"
CurrCodeString3ISO 4217 currency numeric code."458"
ExpTxnAmtString1Exponent of transaction amount."2"
MerchUserIDString50Conditional field
Merchant user ID.

Note: Mandatory if TokenFlag is "Y".		"D1022012123"
CountryCodeString2ISO 3166-1 alpha-2 country code."MY"
MerchRefNoString40Unique merchant reference number."2021061414062021072"
TokenFlagString1Card tokenization."Y" – Agree to store the card details used for the payment into PayMaster system
"N" – Disagree/FPX payment
PreAuthFlagString1Pre-authorization transaction."A" – Account verification transaction,
"N" – Normal transaction,
"Y" – Pre-authorization transaction
TokenShrtNameString20Conditional field
PAN (Card Number) Profile reference name.

Note: Mandatory if TokenFlag is “Y”.		"ABC"
CardIssuerCodeString512Conditional field
Card Issuer Code is used to indicate which Card Issuer’s card or BINs/IINs is entitled for the promotion.

Note: Mandatory if PromoCode is "49" or "60". For more than 1 value; use “|” as separator.		"XXB", "43220400|52685200|432206"
FICodeString20Conditional field
Financial insitution code that entitled for the promotion. Appendix 4

Note: Mandatory if PromoCode is "51".		"XXB"
OrigCurrCodeString3Conditional field
Original transaction ISO 4217 currency numeric code.

Note: Mandatory if OrigTxnAmt exists.		"840"
OrigTxnAmtString (Numeric)12Conditional field
Original transaction amount.

Note: Mandatory if OrigCurrCode exists.		"298.85"
ExpOrigTxnAmtString1Conditional field
Exponent of original transaction amount.

Note: Mandatory if OrigTxnAmt exists.		"2"
SignatureString8Conditional field
Signature. Appendix 2

Note: Mandatory if PortalUserID is present.		"71800248"
Optional Fields
Field Name  TypeLengthDescriptionExample  
OrderRefNo String34 Order reference number."OTMEGASTORE-20010831-ONLINE-007"

OrderRefNo field has the following format.

First two characters indicate the Usage type and followed by 32 characters of order reference number.

Supported format are as below and subject to future expansion:
EC – eCommerce
MT – Mail Order/Telephone Order
OF – Offline Transaction
OT – Others
AT – Airline Ticket; position 3 to 16 are the Airline Ticket Number; position 17-19 is the Airline 3 alpha code.

For EC, MT, OF and OT - position 3 to 34 are freely formatted by merchant server.

OrderDesc String256Order description."Coffee Table"
UserEmail String256Customer email address."customer123@gmail.com"
UserContact String20Customer contact number.

Note: Starting with 6		"6012888888"
UserIPAddress String30User IP address."192.168.2.2"
PromoCode String2Promotion code."01" – VISA card,
"02" – MasterCard,
"49" – Specific card issuer,
"60" – Specific list of BINs/IINs of card issuer,
"50" – Direct Debit only,
"51" – Specific direct debit bank
CardType String3Card type."VSA" – Visa card,
"MST" - Mastercard,
"CUP" – China Union Pay,
"AP" – Alipay+
CCProcFee String (Numeric)12Credit card processing fee."010"
DDProcFee String (Numeric)12Direct debit processing fee."010"
InvoiceNo String50Invoice number."Inv202201120012"
Fee String257Extended fee."f00103200f0020250"

Fee field has the following TLV format.

FieldTypeLengthDescription
TagString4Contains the tag identifying the fee type.
LengthString (Numeric)2Specifies the length of the fee amount.
ValueString (Numeric)Contains the actual fee amount as identified in the tag.
SuccRespURLString512Successful payment page."https://xxx.xxxxx.xxx/approved.jsp"
UnsuccRespURLString512Unsuccessful payment page."https://xxx.xxxxx.xxx/declined.jsp"
CancelRespURLString512Cancel payment page."https://xxx.xxxxx.xxx/cancel.jsp"
LangLocaleString5Language of displayed page."en"
MerchHostIDString8Merchant host identifier."M2022121"
MerchSessionIDString256Merchant session ID."c8t3gprjtl35ms4sm937hj7s30"
TerminalIDString8Terminal ID."T2022121"
PortalUserIDString256Portal user ID."O5ACzHbvQNm3iNAwdvi1Sg=="
POSEnvFlagString1POS environment flag."C" – Unscheduled credential on file,
"I" – Installment,
"R" – Recurring

Example Message​

UPP Payment Authorization Request
curl -X GET 
"https://xxx.finexusgroup.com/upp/faces/upp/payment.xhtml?h001_MTI=0280&h002_VNO=06&h003_TDT=20221225&h004_TTM=150505000&f001_MID=D1022012123&f007_TxnAmt=000000128099&f010_CurrCode=458&f019_ExpTxnAmt=2&f247_OrgTxnAmt=000000029885&f248_OrgCurrCode=840&f249_TxnCh=API&f250_CCProcFee=000000000010&f251_DDProcFee=000000000010&f252_PromoCode=01&f253_CntyCode=MY&f255_IssCode=43220400|52685200|432206&f256_FICode=MXX&f260_ServID=FNX&f261_HostID=M2022121&f262_SessID=c8t3gprjtl35ms4sm937hj7s30&f263_MRN=2021061414062021072&f264_Locale=en&f270_ORN=OTMEGASTORE-20010831-ONLINE-007&f271_ODesc=Coffee+Table&f278_EMailAddr=customer123%40gmail.com&f279_HP=6012888888&f280_RURL_UPPPS=http%3A%2F%2Fxxx.xxxxx.xxx%2Fapproved.jsp&f281_RURL_UPPPU=http%3A%2F%2Fxxx.xxxxx.xxx%2Fdeclined.jsp&f282_RURL_UPPPC=http%3A%2F%2Fxxx.xxxxx.xxx%2Fcancel.jsp&f285_IPAddr=192.168.2.2&f287_ExpOrgTxnAmt=2&f350_CrdTyp=VSA&f354_TID=T2022121&f325_ECommMercInd=1&f339_TokenFlg=N&f344_MercCustId=&f347_TokenShrtNm=ABC&f362_PreAuthFlg=N&f363_InvNum=Inv202201120012&f364_Fee=f00103200f0020250&f365_POSEnvFlg=C&t001_SHT=SH2&t002_SHV=E73CEDA9D9A8D1AAF59BDB919EF7C82D52671A4B457CE816BCE91AFF31485259" \

© 2024 Finexus Group. All rights reserved.