Skip to main content

OBW Payment Parameters

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

info

The following parameters provided to PayMaster for payment processing. Upon completion of the OBW payment process, PayMaster shall redirect the customer browser back to the specified return URL per the completion status.

Mandatory / Conditional Fields

Field NameTypeLengthDescriptionExample
PaymentIDString3Payment method / function."D01" - Normal Sales 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)
MerchRefNoString40Unique merchant reference number."2021061414062021072"
CountryCodeString2ISO 3166-1 alpha-2 country code."MY"
CurrCodeString3ISO 4217 currency numeric code."458"
TxnAmtString (Numeric)12Transaction amount with two decimals and thousand symbols.

Note: Maximum length includes the digit(s) after the decimal place.		"1280.99"
ExpTxnAmtString1Exponent of transaction amount."2"
TokenFlagString1Card tokenization."Y" – Agree to store the card details used for the payment into PayMaster system,
"N" – Disagree/FPX payment
MerchUserIDString50Conditional field
Merchant user ID.

Note: Optional if TokenFlag is "N".		"D1022012123"
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. Appendix 5

Note: Mandatory if PromoCode is "49" or "60". For more than 1 value; use “|” as separator.		"MXX", "43220400|52685200|432206"
FICodeString20Financial insitution code. Appendix 4"RPP"
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.		"..."
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."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
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​

OBW Payment Authorization Request
curl -X GET "https://xxx.finexusgroup.com/upp/faces/ddpayment.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=CIMB&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" \

CONNECT WITH US

© 2000 - 2024 FINEXUS group