Bank Listing Parameters

Method GET

URL

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

Run the Bank Listing request first to retrieve available banks. Use the returned FICode and AcqBank values in the Payment request.

Request Parameters

Mandatory Fields

Field Name	Type	Length	Description	Example
MerchantID	String	15	Assigned merchant ID (MID).	"000010000099939"
PaymentID	String	3	Payment method / function.	"B01" - Bank Listing
MerchRefNo	String	40	Unique merchant reference number.	"MYB2023030315435025LL"
CurrCode	String	3	ISO 4217 currency numeric code.	"458"
FICode	String	20	Financial institution code.	"RPP" - Retail Payment Platform
CountryCode	String	2	ISO 3166-1 alpha-2 country code.	"MY"

Response Parameters

Mandatory / Conditional Fields

Field Name	Type	Length	Description	Example
MerchantID	String	15	Merchant ID.	"000010000099939"
MerchRefNo	String	40	Merchant reference number.	"MYB2023030315435025LL"
TxnStatus	String	2	Transaction status. Appendix 3	"00"
TxnStatMsg	String	256	Transaction status message.	"SUCCESS"
QueryStatus	String	2	Query status. Appendix 3	"00"
CardNo	String	19	Card number.	"545301XXXXXX5323"
TxnDtTm	String	14	Transaction date and time. Format: yyyymmddhhmmss	"20230119110544"
TxnAmt	String (Numeric)	12	Transaction amount.	"000000001000"
CurrCode	String	3	Currency code.	"458"
VersionNo	String	2	Version number.	"06"
RetrievalRefNo	String	12	Retrieval reference number.	"301930987112"
UppPymtMode	String	2	Payment mode.	"01" – FPX payment
SuccRespURL	String	512	Successful payment page.	"https://xxx.xxxxx.xxx/approved.jsp"
TxnStatDetCde	String	4	Transaction status detail code.	"0000"
PreAuthFlag	String	1	Pre-authorization flag.	"N"
PymtGwRefNo	String	20	Payment Gateway reference number.	"230119110548AC031FNX"
FICode	String	20	Financial institution code returned from the bank listing.	"RPP"
AcqBank	String	20	Acquirer bank code returned from the bank listing.	"FNXSMYNB"