Payment

Method GET

URL

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

Obtain f256_FICode and f352_AcqBank from the Bank Listing response before sending the payment request.

Request Parameters

Mandatory Fields

Field Name	Type	Length	Description	Example
h001_MTI	String	4	Message type identifier.	0880
h002_VNO	String	2	Version number.	06
h003_TDT	String	8	Transmission date (YYYYMMDD).	20260824
h004_TTM	String	8	Transmission time.	12432905
f001_MID	String	15	Merchant number (MID).	120567801561128
f003_ProcCode	String	6	Processing code.	000000
f006_TxnDtTm	String	14	Transaction date & time (YYYYMMDDhhmmss).	20010831124329
f007_TxnAmt	String	12	Transaction amount.	000000057080
f010_CurrCode	String	3	Currency code.	458
f019_ExpTxnAmt	String	1	Exponent of transaction amount.	2
f249_TxnCh	String	3	Transaction channel.	"WEB" - Web Channel (default)
f253_CntyCode	String	2	Country code.	MY
f256_FICode	String	20	Financial institution code from bank listing.	"RPP"
f260_ServID	String	3	Service ID.	FNX
f263_MRN	String	1–40	Merchant reference number.	2012121912345
f264_Locale	String	2–5	Language locale.	en
f268_CHName	String	1–100	Customer name.	Thomson
t001_SHT	String	3	Secure hash algorithm type.	SH2
t002_SHV	String	64	Secure hash value. Appendix 1	E036CA5001C6FA93C827D5EAD5928241

Optional Fields

Field Name	Type	Length	Description	Example
f247_OrgTxnAmt	String	12	Optional. Original transaction amount. Required if f248_OrgCurrCode exists.	000000019026
f248_OrgCurrCode	String	3	Optional. Original currency code. Required if f247_OrgTxnAmt exists.	840
f261_HostID	String	8	Optional. Merchant host ID.	AAMWEB02
f262_SessID	String	1–256	Optional. Merchant session ID.	2012121956789
f270_ORN	String	2–34	Optional. Order reference number.	ECT01-20010830-00380
f271_ODesc	String	1–256	Optional. Order description.	Digital
f275_RURL_DD	String	1–512	Optional. DD return URL. If omitted, response returns to the same session.	https://xxx/done.jsp
f276_URL_VMPS	String	1–512	Optional. View merchant payment status URL.	https://xxx/view.jsp
f278_EMailAddr	String	1–256	Optional. Customer email.	thomson8899@yahoo.com
f279_HP	String	1–20	Optional. Customer mobile number.	60128888888
f285_IPAddr	String	7–39	Conditional. Customer IP address (subject to payment provider).	11.11.88.88
f287_ExpOrgTxnAmt	String	1	Conditional. Exponent of original amount. Required if f247_OrgTxnAmt exists.	2
f352_AcqBank	String	1–20	Optional. Acquirer bank from bank listing (seamless channel).	"FNXSMYNB"
f400_AddData	String	1–400	Optional. Additional data (encrypt before use; see gateway appendix).	1011306170000506|201907
f340_MercPromoCde	String	105	Optional. Merchant promotion code.	CYBERSALES|GIVEME
f341_MercPromoAmt	String	65	Optional. Merchant promotion amount.	000000000190|000000000299
f342_PromoAmtAcqCst	String	65	Optional. Promotion amount (acquirer cost).	000000000100|000000000160
f343_PromoAmtMercCst	String	65	Optional. Promotion amount (merchant cost).	000000000090|000000000139
f363_InvNum	String	50	Optional. Invoice number.	123456
f364_Fee	String	257	Optional. Fee (TLV).	017F00103200F0020250

Response Parameters

Mandatory Fields

Field Name	Type	Length	Description	Example
h001_MTI	String	4	Message type identifier.	0890
h002_VNO	String	2	Version number.	06
h003_TDT	String	8	Transmission date.	20260824
h004_TTM	String	8	Transmission time.	12432905
f001_MID	String	15	Merchant number (same as request).	120567801561128
f003_ProcCode	String	6	Processing code (same as request).	000000
f006_TxnDtTm	String	14	Transaction date & time.	20120831124329
f007_TxnAmt	String	12	Transaction amount.	000000057080
f010_CurrCode	String	3	Currency code.	458
f019_ExpTxnAmt	String	1	Exponent of transaction amount.	2
f254_DDRespCode	String	2	Direct debit response code. Examine this for outcome.	00
f256_FICode	String	20	Financial institution code.	PUBLICBANK
f257_PGRN	String	20	Conditional. Payment gateway reference number.	AJ789EG07S0012012022
f258_TxnStatDetCde	String	4	Transaction status detail code.	0000
f260_ServID	String	3	Service ID.	FNX
f263_MRN	String	1–40	Merchant reference number.	2012121912345
f270_ORN	String	2–34	Conditional. Order reference number.	ECT-01-20010830-00380
f277_DDRN	String	30	Conditional. Direct debit reference number.	DD200108301234
f286_OrgDDRespCode	String	1–8	Conditional. Original DD response code from FI.	00
f407_PayerAccType	String	10	Payer account type.	TBH
t001_SHT	String	3	Secure hash algorithm type.	SH2
t002_SHV	String	64	Secure hash value. Appendix 1	...

Optional Fields

Field Name	Type	Length	Description	Example
f259_TxnStatMsg	String	1–256	Transaction status message.	OK
f261_HostID	String	8	Merchant host ID.	AAMWEB02
f262_SessID	String	1–256	Merchant session ID.	2012121956789
f269_IssName	String	1–150	Captured issuer bank name.	CITIBANK

Example Message

Request

DuitNow Pay Payment Request

curl -X GET \
"https://xxx.finexusgroup.com/upp/faces/duitnowpaypayment.xhtml?h001_MTI=0880&h002_VNO=06&h003_TDT=20260824&h004_TTM=12432905&f001_MID=120567801561128&f003_ProcCode=000000&f006_TxnDtTm=20010831124329&f007_TxnAmt=000000057080&f010_CurrCode=458&f019_ExpTxnAmt=2&f249_TxnCh=WEB&f253_CntyCode=MY&f256_FICode=RPP&f260_ServID=FNX&f263_MRN=2012121912345&f264_Locale=en&f268_CHName=Thomson&f275_RURL_DD=https%3A%2F%2Fwww.megastore.com%2Fdd%2Fdone.jsp&f278_EMailAddr=thomson8899%40yahoo.com&f279_HP=60128888888&f285_IPAddr=11.11.88.88&f352_AcqBank=FNXSMYNB&t001_SHT=SH2&t002_SHV=E036CA5001C6FA93C827D5EAD5928241"

Response

DuitNow Pay Payment Response

https://xxx/done.jsp?h001_MTI=0890&h002_VNO=06&h003_TDT=20260824&h004_TTM=12432905&f001_MID=120567801561128&f003_ProcCode=000000&f006_TxnDtTm=20120831124329&f007_TxnAmt=000000057080&f010_CurrCode=458&f019_ExpTxnAmt=2&f254_DDRespCode=00&f256_FICode=RPP&f257_PGRN=AJ789EG07S0012012022&f258_TxnStatDetCde=0000&f259_TxnStatMsg=OK&f260_ServID=FNX&f263_MRN=2012121912345&f277_DDRN=DD200108301234&f286_OrgDDRespCode=00&f407_PayerAccType=TBH&t001_SHT=SH2&t002_SHV=...