银行列表参数

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

信息

以下参数提供给PayMaster用于获取银行列表。 完成流程后，PayMaster将根据完成状态将客户浏览器重定向回指定的返回URL。

请求参数

强制 / 有条件的字段

字段名	类型	长度	描述	示例
PaymentID	字符串	3	支付方式 / 功能。	"B01" - 银行列表
EcommMerchInd	字符串	1	电子商务商户指示符。	"0" - 非电子商务商户， "1" - 电子商务（3D安全）， "2" - 电子商务（非3D安全/MOTO）
MerchRefNo	字符串	40	唯一的商户参考号。	"2021061414062021072"
CountryCode	字符串	2	ISO 3166-1 alpha-2 国家代码。	"MY"
CurrCode	字符串	3	ISO 4217 货币数字代码。	"458"
TxnAmt	字符串 (数值)	12	带有两位小数和千位符号的交易金额。 注意：最大长度包括小数点后的数字。	"1280.99"
ExpTxnAmt	字符串	1	交易金额的指数。	"2"
TokenFlag	字符串	1	卡令牌化。	"Y" - 同意将用于支付的卡详细信息存储到PayMaster系统中， "N" - 不同意/FPX支付
MerchUserID	字符串	50	有条件的字段 商户用户ID。 注意：如果TokenFlag是"N"，则可选。	"D1022012123"
PreAuthFlag	字符串	1	预授权交易。	"A" - 账户验证交易， "N" - 普通交易， "Y" - 预授权交易
TokenShrtName	字符串	20	有条件的字段 PAN（卡号）配置文件参考名称。 注意：如果TokenFlag是“Y”，则必填。	"ABC"
CardIssuerCode	字符串	512	有条件的字段 卡发行方代码用于指示哪个卡发行方的卡或BINs/IINs有资格进行促销。 注意：如果PromoCode是"49"或"60"，则必填。 如有多个值，则使用“	”作为分隔符。
FICode	字符串	20	有条件的字段 有资格进行促销的金融机构代码。 注意：如果PromoCode是"51"，则必填。	"RPP"
OrigCurrCode	字符串	3	有条件的字段 原始交易的ISO 4217货币数字代码。 注意：如果存在OrigTxnAmt，则必填。	"840"
OrigTxnAmt	字符串 (数值)	12	有条件的字段 原始交易金额。 注意：如果存在OrigCurrCode，则必填。	"298.85"
ExpOrigTxnAmt	字符串	1	有条件的字段 原始交易金额的指数。 注意：如果存在OrigTxnAmt，则必填。	"2"
Signature	字符串	8	有条件的字段 签名。 附录 2 注意：如果PortalUserID存在，则必填。	"..."

可选字段

字段名	类型	长度	描述	示例
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	客户联系号码	"6012888888"
UserIPAddress	字符串	30	用户 IP 地址	"192.168.2.2"
PromoCode	字符串	2	促销代码	"01" – VISA 卡, "02" – MasterCard, ...
CardType	字符串	3	卡类型	"VSA" – Visa 卡, "MST" - Mastercard, "CUP" – China Union Pay
CCProcFee	字符串（数值型）	12	信用卡处理费	"010"
DDProcFee	字符串（数值型）	12	直接借记处理费	"010"
InvoiceNo	字符串	50	发票编号	"Inv202201120012"
Fee	字符串	257	扩展费用	"f00103200f0020250"

Fee 字段采用了以下 TLV 格式。

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

SuccRespURL	字符串	512	成功支付页面	"https://xxx.xxxxx.xxx/approved.jsp"
UnsuccRespURL	字符串	512	失败支付页面	"https://xxx.xxxxx.xxx/declined.jsp"
CancelRespURL	字符串	512	取消支付页面	"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	条件性字段 金融机构代码。	"RPP"
MerchRefNo	字符串	40	商户参考号。	"20230119110520FNX"
FPXRefNo	字符串	20	条件性字段 唯一的FPX参考号。	"3143323587217932"
OrgDDRespCode	字符串	8	条件性字段 原始直接借记响应代码。 注意：如果 UPP_PM = 00，则可用。	"22"
CardType	字符串	3	条件性字段 卡类型。	"VSA" – Visa卡, "MST" - 万事达卡, "CUP" – 中国银联卡
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 支付, "99" – 未知或错误
AcqBank	字符串	20	提供分期支付银行的收单行。	"EBXX"
IPPTenure	字符串	3	分期支付计划期限。	"3"
EcommMerchInd	字符串	1	电子商务商户指示器。	"0" - 非电子商务商户, "1" - 电子商务（3D Secure）, "2" - 电子商务（非3D Secure/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 的值与之前的支付请求相同。

示例消息

请求

OBW Payment Authorization Request

curl -X GET "https://xxx.finexusgroup.com/upp/faces/ddpayment.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=BXX&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" \

响应

OBW 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"