Query
Method POSTURL
https://xxx.finexusgroup.com/upp/faces/upp/requery0780.xhtml?
If the UPP payment response (0290) is not received within 30 seconds, retry query every 5 seconds for up to 30 minutes. Abort if no Approved or Failed status is returned.
- Request Parameters
- Response Parameters
Mandatory Fields
| Field Name | Type | Length | Description | Example |
|---|---|---|---|---|
h001_MTI | String | 4 | Message type identifier. | 0780 |
h002_VNO | String | 2 | Version number. | 06 |
h003_TDT | String | 8 | Transmission date (YYYYMMDD). | 20010831 |
h004_TTM | String | 8 | Transmission time. | 12432905 |
f001_MID | String | 15 | Merchant number (MID). | 120567801561128 |
f260_ServID | String | 3 | Service ID. | FNX |
f263_MRN | String | 1–40 | Merchant reference number (same as prior UPP payment). | 2012121912345 |
t001_SHT | String | 3 | Secure hash algorithm type. | SH2 |
t002_SHV | String | 64 | Secure hash value. Appendix 1 | 61936D1EF085FF70CA9682234B7D9159 |
Optional Fields
| Field Name | Type | Length | Description | Example |
|---|---|---|---|---|
f284_RURL_UPPPQ | String | 1–512 | UPP payment query return URL. If omitted, result returns to the same session. | https://xxx/txnquery.jsp |
Mandatory Fields
| Field Name | Type | Length | Description | Example |
|---|---|---|---|---|
h001_MTI | String | 4 | Message type identifier. | 0790 |
h002_VNO | String | 2 | Version number. | 06 |
h003_TDT | String | 8 | Transmission date. | 20010831 |
h004_TTM | String | 8 | Transmission time. | 12432908 |
f001_MID | String | 15 | Merchant number. | 120567801561128 |
f004_PAN | String | 12–19 | Conditional. Primary account number (card payment). | 4512123412340000 |
f006_TxnDtTm | String | 14 | Transaction date & time. | 200108311124329 |
f007_TxnAmt | String | 12 | Transaction amount. | 000000058030 |
f009_RespCode | String | 2 | Conditional. Credit card response code. | 00 |
f010_CurrCode | String | 3 | Currency code. | 458 |
f011_AuthIDResp | String | 6 | Conditional. Authorization ID response. | 12882J |
f019_ExpTxnAmt | String | 1 | Conditional. Exponent of transaction amount. | 2 |
f023_RRN | String | 12 | Conditional. Retrieval reference number. | 102812345678 |
f024_OrgRespCode | String | 1–8 | Conditional. Original CC response code. | 00 |
f247_OrgTxnAmt | String | 12 | Conditional. Original transaction amount. | 000000019026 |
f248_OrgCurrCode | String | 3 | Conditional. Original currency code. | 840 |
f249_TxnCh | String | 3 | Conditional. Transaction channel. | "WEB" - Web Channel (default) |
f254_DDRespCode | String | 2 | Conditional. Direct debit response code. | 00 |
f256_FICode | String | 20 | Conditional. Financial institution code. | CIMB |
f257_PGRN | String | 20 | Conditional. Payment gateway reference number. | AJ789EG07S0012012022 |
f260_ServID | String | 3 | Service ID. | FNX |
f261_HostID | String | 8 | Conditional. Merchant host ID. | AAMWEB02 |
f262_SessID | String | 1–256 | Conditional. Merchant session ID. | 2012121956789 |
f263_MRN | String | 1–40 | Merchant reference number. | 2001083100001 |
f270_ORN | String | 2–34 | Conditional. Order reference number. | ECT-01-20010831-00380 |
f274_QRespCode | String | 2 | Query response code — examine for query outcome. | 00 |
f277_DDRN | String | 1–30 | Conditional. Direct debit reference number. | CIMBDD7890 |
f283_UPP_PM | String | 2 | UPP payment mode. | "00" - Credit card payment, "01" - Debit card payment, "02" - FPX payment, "03" - QR payment, "99" - Unknown or error |
f286_OrgDDRespCode | String | 1–8 | Conditional. Original DD response code. | 00 |
f287_ExpOrgTxnAmt | String | 1 | Conditional. Exponent of original amount. | 2 |
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 |
f350_CrdTyp | String | 3 | Card type (version 07 and above). | "VSA" - Visa Card, "MST" - Mastercard, "AMX" - American Express, "JCB" - Japan Credit Bureau, "CUP" - China Union Pay, "DNR" - Diners Club International, "WLT" - Wallet, "FPX" - Molpay FPX |
f398_CrdProduct | String | 1 | Card product (version 07 and above). | "C" - Credit Card, "D" - Debit Card, "P" - Prepaid Card |
Example Message
- Request
- Response
UPP Payment Query Request (0780)
curl -X POST \
"https://xxx.finexusgroup.com/upp/faces/upp/requery0780.xhtml?h001_MTI=0780&h002_VNO=03&h003_TDT=20010831&h004_TTM=12432905&f001_MID=120567801561128&f260_ServID=FNX&f263_MRN=2012121912345&f284_RURL_UPPPQ=https%3A%2F%2Fxxx%2Ftxnquery.jsp&t001_SHT=SH2&t002_SHV=61936D1EF085FF70CA9682234B7D9159"
UPP Payment Query Response
https://xxx/txnquery.jsp?h001_MTI=0790&h002_VNO=03&h003_TDT=20010831&h004_TTM=12432908&f001_MID=120567801561128&f006_TxnDtTm=200108311124329&f007_TxnAmt=000000058030&f010_CurrCode=458&f019_ExpTxnAmt=2&f254_DDRespCode=00&f256_FICode=CIMB&f257_PGRN=AJ789EG07S0012012022&f258_TxnStatDetCde=0000&f259_TxnStatMsg=OK&f260_ServID=FNX&f263_MRN=2012121912345&f274_QRespCode=00&f277_DDRN=CIMBDD7890&f283_UPP_PM=00&f350_CrdTyp=VSA&f398_CrdProduct=C&t001_SHT=SH2&t002_SHV=...