预授权完成参数

Method : GET
URL： https://xxx.finexusgroup.com/upp/faces/upp/payment.xhtml?

信息

以下参数由PayMaster提供进行支付处理。 完成UPP支付流程后，PayMaster将根据完成状态将客户浏览器重定向回指定的返回URL。

请求参数

必填 / 有条件字段

字段名	类型	长度	描述	示例
PaymentID	字符串	3	支付方式 / 功能。	"U01" - UPP 交易, "U02" - UPP 交易状态查询
MerchRefNo	字符串	40	唯一的商户参考号。	"2021061414062021072"
CurrCode	字符串	3	ISO 4217 货币数字代码。	"458"
TxnAmt	字符串（数字）	12	两位小数和千分符的交易金额。 注意： 最大长度包括小数点后的数字。	"1280.99"
ExpTxnAmt	字符串	1	交易金额的指数。	"2"
CardNo	字符串	19	卡号。 注意： 参考支付参数中的CardNo字段。	"545301XXXXXX5323"
EcommMerchInd	字符串	1	电子商务商户指示。	"0" - 非电子商务商户, "1" - 电子商务（3D 安全）, "2" - 电子商务（非3D 安全/MOTO）
CountryCode	字符串	2	ISO 3166-1 alpha-2 国家代码。	"MY"
TokenFlag	字符串	1	卡令牌化。	"Y" – 同意将用于支付的卡详情存储到 PayMaster 系统中, "N" – 不同意/FPX 支付
MerchUserID	字符串	50	条件性字段 商户用户 ID。 如果TokenFlag为"Y"，则为必填字段。	"D1022012123"
PreAuthFlag	字符串	1	预授权交易。	"A" – 账户验证交易, "N" – 正常交易, "Y" – 预授权交易
TokenShrtName	字符串	20	条件性字段 PAN（卡号）概要参考名称。 注意：如果TokenFlag为“Y”，则为必填字段。	"ABC"
CardIssuerCode	字符串	512	条件性字段 卡发行方代码用于指示哪个卡发行方的卡或 BIN/IIN 有资格获得促销活动。附录 5 注意：如果PromoCode为"49"或"60"，则为必填字段。对于多个值，请使用“|”作为分隔符。	"CIMB", "43220400|52685200|432206"
FICode	字符串	20	条件性字段 有资格获得促销活动的金融机构代码。附录 4 注意：如果PromoCode为"51"，则为必填字段。	"CIMB"
OrigCurrCode	字符串	3	条件性字段 原始交易 ISO 4217 货币数字代码。 注意：如果存在OrigTxnAmt，则为必填字段。	"840"
OrigTxnAmt	字符串（数字）	12	条件性字段 原始交易金额。 注意：如果OrigCurrCode存在，则为必填字段。	"298.85"
ExpOrigTxnAmt	字符串	1	条件性字段 原始交易金额的指数。 注意：如果OrigTxnAmt存在，则为必填字段。	"2"
Signature	字符串	8	条件性字段 签名。附录 2 注意：如果存在PortalUserID，则为必填字段。	"71800248"

可选字段

字段名	类型	长度	描述	示例
OrderRefNo	字符串	34	订单参考号	"OTMEGASTORE-20010831-ONLINE-007"

OrderRefNo字段具有以下格式。

前两个字符表示使用类型，后跟32个字符的订单参考号。

支持的格式如下，可能会在未来进行扩展：
EC – 电子商务
MT – 邮购/电话订购
OF – 线下交易
OT – 其他
AT – 航空票；第3到第16位是航空票号；第17到第19位是航空公司的3字母代码。

对于 EC、MT、OF 和 OT - 位置 3 到 34 由商户服务器自由格式化。

OrderDesc	字符串	256	订单描述	"咖啡桌"
UserEmail	字符串	256	客户电子邮件地址	"customer123@gmail.com"
UserContact	字符串	20	客户联系电话 注意： 以6开头	"6012888888"
UserIPAddress	字符串	30	用户 IP 地址	"192.168.2.2"
PromoCode	字符串	2	促销代码	"01" – VISA 卡, "02" – MasterCard, ...
CardType	字符串	3	卡类型	"VSA" – Visa 卡, "MST" - Mastercard, ...
CCProcFee	数字字符串	12	信用卡处理费	"010"
DDProcFee	数字字符串	12	直接借记处理费	"010"
InvoiceNo	字符串	50	发票号	"Inv202201120012"
Fee	字符串	257	扩展费用	"f00103200f0020250"

以下是 Fee 字段的 TLV 格式说明：

字段	类型	长度	描述
Tag	字符串	4	包含标识费用类型的标签。
Length	数字字符串	2	指定费用金额的长度。
Value	数字字符串		包含标签中识别的实际费用金额。

以下是其他字段的中文翻译：

SuccRespURL	字符串	512	成功支付页面 URL	"https://xxx.xxxxx.xxx/approved.jsp"
UnsuccRespURL	字符串	512	未成功支付页面 URL	"https://xxx.xxxxx.xxx/declined.jsp"
CancelRespURL	字符串	512	取消支付页面 URL	"https://xxx.xxxxx.xxx/cancel.jsp"
LangLocale	字符串	5	显示页面的语言	"en"
MerchHostID	字符串	8	商家主机标识符	"M2022121"
MerchSessionID	字符串	256	商家会话 ID	"c8t3gprjtl35ms4sm937hj7s30"
TerminalID	字符串	8	终端 ID	"T2022121"
PortalUserID	字符串	256	门户用户 ID	"O5ACzHbvQNm3iNAwdvi1Sg=="
POSEnvFlag	字符串	1	POS 环境标志	"C" – 未安排的文件凭证， "I" – 分期， "R" – 循环性

返回参数

必填/有条件的字段

字段名称	类型	长度	描述	示例
MerchantID	字符串	15	商家 ID。 注意：与属性文件中的 MerchantID 相同。	"000010000099939"
CardNo	字符串	19	条件性字段 卡号。	"545301XXXXXX5323"
ExpiryYear	字符串	2	条件性字段 卡有效期年份。	"27"
ExpiryMth	字符串	2	条件性字段 卡有效期月份。	"10"
TxnStatus	字符串	2	交易状态。附录3	"00"
AuthIDRespCode	字符串	6	条件性字段 授权 ID 响应代码。 注意：成功支付时为必填项。	"397939"
RetrievalRefNo	字符串	12	条件性字段 检索参考号。 注意：如果该字段由收单方在响应消息中返回，则可用。	"301930987112"
OrigRespCode	字符串	8	条件性字段 原始响应代码。附录3	"00"
DDRespCode	字符串	8	条件性字段 直接借记响应代码。 注意：如果 UPP_PM = 00，则可用。	"00"
FICode	字符串	20	条件性字段 金融机构代码。 附录4	"MXX"
MerchRefNo	字符串	40	商家参考号。	"20230119110520FNX"
FPXRefNo	字符串	20	条件性字段 独特的 FPX 参考号。	"3143323587217932"
OrgDDRespCode	字符串	8	条件性字段 原始直接借记响应代码。 注意：如果 UPP_PM = 00，则可用。	"22"
CardType	字符串	3	条件性字段 卡类型。	"VSA" – Visa 卡, "MST" - Mastercard, "CUP" – 中国银联, "AP" – 支付宝+
Token	字符串	19	条件性字段 新卡的参考号。 注意：如果 TokenFlag 是 "Y" 则必填。	"8801923000216577863"
MaskCardNo	字符串	19	条件性字段 掩码卡号。 注意：如果 TokenFlag 是 "Y" 则必填。	"84415977423665"
SHAlgorithmType	字符串	3	安全哈希算法类型。	"SH2"
SHValue	字符串	64	安全哈希值。附录1	"..."

可选字段

字段名称	类型	长度	描述	示例
TxnDtTm	字符串	14	交易日期和时间。 格式：yyyymmddhhmmss	"20230119110544"
TxnAmt	字符串（数值型）	12	交易金额。	"000000001000"
CurrCode	字符串	3	货币代码。	"458"
ExpTxnAmt	字符串	1	交易金额的指数。	"2"
PymtGwRefNo	字符串	20	支付网关参考编号。	"230119110548AC031FNX"
TxnStatDetCde	字符串	4	交易状态详细代码。	"0000"
TxnStatMsg	字符串	256	交易状态消息。	"SUCCESS"
MerchHostID	字符串	8	商家主机标识符。	"M2022121"
MerchSessionID	字符串	256	商家会话ID。	"20230113172620"
OrderRefNo	字符串	34	订单参考编号。	"OTMEGASTORE-20010831-ONLINE-007"
UppPymtMode	字符串	2	支付模式。	"00" – 信用卡/借记卡支付, "01"  – FPX支付, "02"  – 二维码支付, "99" – 未知或错误
AcqBank	字符串	20	提供分期支付银行的收单银行。	"CIMBCLICKS"
IPPTenure	字符串	3	分期支付计划期限。	"3"
EcommMerchInd	字符串	1	电子商务商家指示器。	"0" - 非电子商务商家, "1" - 电子商务（3D安全）, "2" - 电子商务（非3D安全/MOTO）
TokenFlag	字符串	1	卡片令牌化。	"Y" – 同意将用于支付的卡片详细信息存储到PayMaster系统中, "N" – 不同意/FPX支付
MerchUserID	字符串	50	商家用户ID。	"guest-finexus"
TokenShrtName	字符串	20	档案引用名称。	"fnxcard1"
POSEnvFlag	字符串	1	POS环境标志。	"C" – 非计划凭据存档, "I" – 分期, "R" – 循环

信息

MerchRefNo、SHAlgorithmType、OrderRefNo、CurrCode、TxnAmt、ExpTxnAmt、CardType、MerchUserID、TokenFlag、TokenShrtName、MerchHostID、MerchSessionID、EcommMerchInd 和 POSEnvFlag 的值与之前的支付请求中相同。

示例消息

请求

UPP Payment Authorization Request

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=CIMB&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 Authorization Response

"https://xxx.finexusgroup.com/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"