Bank Listing
Method GETURL
https://xxx.finexusgroup.com/upp/faces/banklisting.xhtml?
Run Bank Listing first. Parse f351_AcqBankList and use the selected bank’s code in f352_AcqBank (and f256_FICode) for the Payment request.
- Request Parameters
- Response Parameters
Mandatory Fields
| Field Name | Type | Length | Description | Example |
|---|---|---|---|---|
h001_MTI | String | 4 | Message type identifier. | 0360 |
h002_VNO | String | 2 | Version number. | 01 |
h003_TDT | String | 8 | Transmission date (YYYYMMDD). | 20010831 |
h004_TTM | String | 8 | Transmission time. | 12432908 |
f001_MID | String | 15 | Merchant number (MID). | 120567801561128 |
f010_CurrCode | String | 3 | Currency code. | 458 |
f249_TxnCh | String | 3 | Transaction channel. | B2C |
f256_FICode | String | 20 | Financial institution code. | "RPP" - Retail Payment Platform, "FPX" - FPX |
f260_ServID | String | 3 | Service ID. | FNX |
t001_SHT | String | 3 | Secure hash algorithm type. | SH2 |
t002_SHV | String | 64 | Secure hash value. Appendix 1 | E036CA5001C6FA93C827D5EAD5928241 |
Mandatory Fields
| Field Name | Type | Length | Description | Example |
|---|---|---|---|---|
h001_MTI | String | 4 | Message type identifier. | 0370 |
h002_VNO | String | 2 | Version number. | 01 |
h003_TDT | String | 8 | Transmission date. | 20010831 |
h004_TTM | String | 8 | Transmission time. | 12432908 |
f001_MID | String | 15 | Merchant number. | 120567801561128 |
f249_TxnCh | String | 3 | Transaction channel. | B2C |
f256_FICode | String | 20 | Financial institution code. | "RPP" - Retail Payment Platform, "FPX" - FPX |
f260_ServID | String | 3 | Service ID. | FNX |
f351_AcqBankList | String | 1–400 | Acquirer bank list (comma-separated). | See format below |
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 |
|---|---|---|---|---|
f258_TxnStatDetCde | String | 4 | Transaction status detail code. | 0000 |
f259_TxnStatMsg | String | 1–256 | Transaction status message. | OK |
f351_AcqBankList format
Each bank entry is separated by a comma. See Appendix 2 - Bank List for bank codes and names. Use the bank code value when setting f352_AcqBank on the payment request.
Example Message
- Request
- Response
Bank Listing Request
curl -X GET \
"https://xxx.finexusgroup.com/upp/faces/banklisting.xhtml?h001_MTI=0360&h002_VNO=01&h003_TDT=20010831&h004_TTM=12432908&f001_MID=120567801561128&f010_CurrCode=458&f249_TxnCh=B2C&f256_FICode=RPP&f260_ServID=FNX&t001_SHT=SH2&t002_SHV=E036CA5001C6FA93C827D5EAD5928241"
Bank Listing Response
h001_MTI=0370&h002_VNO=01&h003_TDT=20010831&h004_TTM=12432908&f001_MID=120567801561128&f249_TxnCh=B2C&f256_FICode=RPP&f258_TxnStatDetCde=0000&f259_TxnStatMsg=OK&f260_ServID=FNX&f351_AcqBankList=BIMBMYKL~Bank+Islam~A~RET~https%3A%2F%2F...%2CIBBGMYKL~RHB+Bank~A~RET~https%3A%2F%2F...&t001_SHT=SH2&t002_SHV=...