付款
方法 GETURL
https://xxx.finexusgroup.com/upp/faces/upp/payment.xhtml?
- 请求参数
- 响应参数
必填字段
| 字段名 | 类型 | 长度 | 描述 | 示例 |
|---|---|---|---|---|
h001_MTI | String | 4 | Message type identifier. | 0280 |
h002_VNO | String | 2 | Version number. | 06 |
h003_TDT | String | 8 | Transmission date (YYYYMMDD). | 20221225 |
h004_TTM | String | 8 | Transmission time. | 15050500 |
f001_MID | String | 15 | Merchant number (MID). | 120567801561128 |
f007_TxnAmt | String | 12 | Transaction amount (12-digit, implied decimals per f019). | 000000128099 |
f010_CurrCode | String | 3 | Currency code (ISO 4217 numeric). | 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 (ISO 3166-1 alpha-2). | MY |
f260_ServID | String | 3 | Service ID. | FNX |
f263_MRN | String | 1–40 | Merchant reference number (unique per transaction). | 2021061414062021072 |
f264_Locale | String | 2–5 | Language locale for the UPP page. | en |
f325_ECommMercInd | String | 1 | E-commerce merchant indicator. | "0" - Non-E-Commerce merchant, "1" - E-Commerce (3D Secure), "2" - E-Commerce (Non-3D Secure/MOTO) |
f339_TokenFlg | String | 1 | Tokenisation flag. | "Y" - Agree to store the card details used for the payment into PayMaster system, "N" - Disagree/FPX payment |
f362_PreAuthFlg | String | 1 | Pre-auth flag. | "A" - Account verification transaction, "N" - Normal transaction, "Y" - Pre-authorization transaction |
t001_SHT | String | 3 | Secure hash algorithm type. | SH2 |
t002_SHV | String | 64 | 安全哈希值。附录 1 | E73CEDA9D9A8D1AAF59BDB919EF7C82D52671A4B457CE816BCE91AFF31485259 |
可选字段
| 字段名 | 类型 | 长度 | 描述 | 示例 |
|---|---|---|---|---|
f247_OrgTxnAmt | String | 12 | Original transaction amount. Required if f248_OrgCurrCode exists. | 000000029885 |
f248_OrgCurrCode | String | 3 | Original currency code. Required if f247_OrgTxnAmt exists. | 840 |
f250_CCProcFee | String | 12 | Credit card processing fee. | 000000000010 |
f251_DDProcFee | String | 12 | Direct debit processing fee. | 000000000010 |
f252_PromoCode | String | 2 | Promotion 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 |
f255_IssCode | String | 1–512 | Card issuer code or BIN list (| separator). Required for promo 49 / 60. | 43220400|52685200 |
f256_FICode | String | 20 | Financial institution code (promo / DD). | MXX |
f261_HostID | String | 8 | Merchant host ID. | M2022121 |
f262_SessID | String | 1–256 | Merchant session ID. | c8t3gprjtl35ms4sm937hj7s30 |
f270_ORN | String | 2–34 | Order reference number. | OTMEGASTORE-20010831-ONLINE-007 |
f271_ODesc | String | 1–256 | Order description. | Coffee Table |
f278_EMailAddr | String | 1–256 | Customer email. | customer123@gmail.com |
f279_HP | String | 1–20 | Customer mobile number. | 6012888888 |
f280_RURL_UPPPS | String | 1–512 | UPP successful return URL. | https://xxx/approved.jsp |
f281_RURL_UPPPU | String | 1–512 | UPP unsuccessful return URL. | https://xxx/declined.jsp |
f282_RURL_UPPPC | String | 1–512 | UPP cancel return URL. | https://xxx/cancel.jsp |
f285_IPAddr | String | 7–39 | Customer IP address. | 192.168.2.2 |
f287_ExpOrgTxnAmt | String | 1 | Exponent of original amount. Required if f247_OrgTxnAmt exists. | 2 |
f289_PortalCustId | String | 1–256 | Encrypted portal customer ID (excluded from hash). | ... |
f290_Signature | String | 1–512 | Signature when f289 present (excluded from hash). | ... |
f344_MercCustId | String | 1–50 | Merchant customer ID. | guest-finexus |
f347_TokenShrtNm | String | 1–20 | PAN profile short name. Required if f339_TokenFlg is Y. | ABC |
f350_CrdTyp | String | 3 | Pre-selected card type on UPP. | "VSA" - Visa card, "MST" - Mastercard, "CUP" - China Union Pay, "AP" - Alipay+ |
f354_TID | String | 8 | Terminal ID. | T2022121 |
f363_InvNum | String | 50 | Invoice number. | Inv202201120012 |
f364_Fee | String | 257 | Fee (TLV). | f00103200f0020250 |
f365_POSEnvFlg | String | 1 | POS environment flag. | "C" - Unscheduled credential on file, "I" - Installment, "R" - Recurring |
必填字段
| 字段名 | 类型 | 长度 | 描述 | 示例 |
|---|---|---|---|---|
h001_MTI | String | 4 | Message type identifier. | 0290 |
h002_VNO | String | 2 | Version number. | 06 |
h003_TDT | String | 8 | Transmission date. | 20230119 |
h004_TTM | String | 8 | Transmission time. | 11054420 |
f001_MID | String | 15 | Merchant number (same as request). | 120567801561128 |
f005_ExpDate | String | 4 | Card expiry (YYMM). | 2710 |
f006_TxnDtTm | String | 14 | Transaction date & time. | 20230119110544 |
f007_TxnAmt | String | 12 | Transaction amount. | 000000001000 |
f010_CurrCode | String | 3 | Currency code. | 458 |
f019_ExpTxnAmt | String | 1 | Exponent of transaction amount. | 2 |
f260_ServID | String | 3 | Service ID. | FNX |
f263_MRN | String | 1–40 | Merchant reference number. | 20230119110520FNX |
f283_UPP_PM | String | 2 | UPP payment mode chosen. Examine with f009 / f254. | "00" - Credit card payment, "01" - Debit card payment, "02" - FPX payment, "03" - QR payment, "99" - Unknown or error |
t001_SHT | String | 3 | Secure hash algorithm type. | SH2 |
t002_SHV | String | 64 | 安全哈希值。附录 1 | ... |
可选字段
| 字段名 | 类型 | 长度 | 描述 | 示例 |
|---|---|---|---|---|
f004_PAN | String | 12–19 | Card number (if returned). | 545301XXXXXX5323 |
f009_RespCode | String | 2 | Card response code (when f283 = card). | 00 |
f011_AuthIDResp | String | 6 | Authorization ID response. | 397939 |
f023_RRN | String | 12 | Retrieval reference number. | 301930987112 |
f024_OrgRespCode | String | 1–8 | Original card response code. | 00 |
f254_DDRespCode | String | 2 | Direct debit response code (when f283 = DD). | 00 |
f256_FICode | String | 20 | Financial institution code. | CIMB |
f257_PGRN | String | 20 | Payment gateway reference number. | 230119110548AC031FNX |
f258_TxnStatDetCde | String | 4 | Transaction status detail code. | 0000 |
f259_TxnStatMsg | String | 1–256 | Transaction status message. | SUCCESS |
f261_HostID | String | 8 | Merchant host ID. | |
f262_SessID | String | 1–256 | Merchant session ID. | |
f270_ORN | String | 2–34 | Order reference number. | |
f277_DDRN | String | 30 | Direct debit reference number. | |
f286_OrgDDRespCode | String | 1–8 | Original DD response code. | 22 |
f325_ECommMercInd | String | 1 | E-commerce merchant indicator. | "0" - Non-E-Commerce merchant, "1" - E-Commerce (3D Secure), "2" - E-Commerce (Non-3D Secure/MOTO) |
f339_TokenFlg | String | 1 | Tokenisation flag. | "Y" - Agree to store the card details used for the payment into PayMaster system, "N" - Disagree/FPX payment |
f344_MercCustId | String | 1–50 | Merchant customer ID. | guest-finexus |
f346_Token | String | 1–19 | Stored card token reference. | 8801923000216577863 |
f347_TokenShrtNm | String | 1–20 | PAN profile short name. | fnxcard1 |
f348_MaskPAN | String | 1–19 | Masked PAN. | |
f350_CrdTyp | String | 3 | Card type. | "VSA" - Visa card, "MST" - Mastercard, "CUP" - China Union Pay, "AP" - Alipay+ |
f352_AcqBank | String | 1–20 | Acquirer bank (installment). | |
f353_IPPTenure | String | 3 | Installment tenure. | |
f365_POSEnvFlg | String | 1 | POS environment flag. | "C" - Unscheduled credential on file, "I" - Installment, "R" - Recurring |
示例消息
- 请求
- 响应
UPP Payment Request (0280)
curl -X GET \
"https://xxx.finexusgroup.com/upp/faces/upp/payment.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=MXX&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"
UPP Payment Response (0290)
https://xxx/success?h001_MTI=0290&h002_VNO=06&h003_TDT=20230119&h004_TTM=11054420&f001_MID=000010000099939&f004_PAN=545301XXXXXX5323&f005_ExpDate=2710&f006_TxnDtTm=20230119110544&f007_TxnAmt=000000001000&f009_RespCode=00&f010_CurrCode=458&f011_AuthIDResp=397939&f019_ExpTxnAmt=2&f023_RRN=301930987112&f024_OrgRespCode=00&f254_DDRespCode=00&f256_FICode=&f257_PGRN=230119110548AC031FNX&f258_TxnStatDetCde=0000&f259_TxnStatMsg=SUCCESS&f261_HostID=&f262_SessID=20230113172620&f263_MRN=20230119110520FNX&f270_ORN=&f277_DDRN=&f283_UPP_PM=00&f286_OrgDDRespCode=22&f350_CrdTyp=MST&f352_AcqBank=&f353_IPPTenure=&f325_ECommMercInd=1&f339_TokenFlg=Y&f344_MercCustId=guest-finexus&f346_Token=8801923000216577863&f347_TokenShrtNm=fnxcard1&f348_MaskPAN=&f365_POSEnvFlg=R&t001_SHT=SH2&t002_SHV=0F3086E879F80EB6BFA8D0E3FFD2D489AE8F4DDFA7B8F8511151B0BE27CF3B79