支付参数
方法: GET
URL:https://xxx.finexusgroup.com/upp/faces/ccpayment.xhtml?
- 请求参数
- 返回参数
信息
定期支付请求消息 用于请求卡发卡机构批准从持卡人账户转账资金至商家账户。
商家服务器应在规定的超时时间内期望从 PayMaster 收到相应的响应消息。
必填字段
字段名称 | 类型 | 长度 | 描述 | 示例 |
---|---|---|---|---|
PaymentID | 字符串 | 3 | 支付方法 / 功能。 | "C04" |
MerchRefNo | 字符串 | 40 | 唯一的商家参考号。 | "2021061414062021072" |
CurrCode | 字符串 | 3 | ISO 4217 货币数字代码。 | "458" |
TxnAmt | 字符串 (数值) | 12 | 具有两位小数和千分符的交易金额。 注意: 最大值为 12 位数字;其中包括小数点后的数字。 | "1280.99" |
ExpTxnAmt | 字符串 | 1 | 交易金额的指数。 | "2" |
CardNo | 字符串 | 19 | 令牌号。 | "8815023000256377XXX" |
ExpiryYear | 字符串 | 2 | 卡片到期年份 格式:YY。 | "27" |
ExpiryMth | 字符串 | 2 | 卡片到期月份 格式:MM。 | "10" |
ECI | 字符串 | 2 | 电子商务交易类型。 | "12" - 定期交易(存储凭据) |
TokenFlag | 字符串 | 1 | 卡片令牌化。 | "Y" – 同意将用于支付的卡片详细信息存储到 PayMASTER 系统中, "N" – 不同意/FPX 支付 |
信息
定期支付响应消息用作对由商家服务器发起的请求消息的响应。该响应消息包含授权批准结果的结果。
商户服务器应检查响应代码 RespCode
以获取请求消息的处理结果。交易状态详细代码 TxnStatDetCde
将提供交易的补充信息/状态(如果可用)。
完成信用卡支付流程后,PayMaster 将根据完成状态将客户浏览器重定向回指定的返回 URL。
必填/有条件的字段
字段名称 | 类型 | 长度 | 描述 | 示例 |
---|---|---|---|---|
MerchantID | 字符串 | 15 | 商户ID。 注意: 与属性文件中的 MerchantID 相同的值。 | "000010000099939" |
MerchRefNo | 字符串 | 40 | 商户参考编号。 | "20230119110520FNX" |
TxnStatus | 字符串 | 2 | 交易状态。附录 3 | "00" |
SHAlgorithmType | 字符串 | 3 | 安全哈希算法类型。 | "SH2" |
SHValue | 字符串 | 64 | 安全哈希值。附录 1 | "..." |
CardNo | 字符串 | 19 | 条件字段 卡号。 | "545301XXXXXX5323" |
CardType | 字符串 | 3 | 条件字段 卡类型。 | "VSA" – Visa card, "MST" - Mastercard, "CUP" – China Union Pay |
ExpiryYear | 字符串 | 2 | 条件字段 卡到期年份。 | "27" |
ExpiryMth | 字符串 | 2 | 条件字段 卡到期月份。 | "10" |
AuthIDRespCode | 字符串 | 6 | 条件字段 授权ID响应代码。 注意: 仅在支付成功时可用。 | "397939" |
CVV2ResultCode | 字符串 | 1 | 条件字段 卡验证值2结果代码。 | "0" |
RetrievalRefNo | 字符串 | 12 | 条件字段 检索参考编号。 | "301930987112" |
OrigRespCode | 字符串 | 8 | 条件字段 原始响应代码。附录 3 注意: 仅在原始银行响应代码不超过8个字符时可用。 | "00" |
Token | 字符串 | 19 | 条件字段 存储的新卡的参考编号。 注意: 如果 TokenFlag 为"Y",则为必填项。 | "8801923000216577863" |
MaskCardNo | 字符串 | 19 | 条件字段 掩码卡号。 注意: 如果 TokenFlag 为"Y",则为必填项。 | "84415977423665" |
信息
CVV2ResultCode
和RetrievalRefNo
- 如果由收单方在响应消息中返回,则可用。MerchRefNo
、SHAlgorithmType
、OrderRefNo
、CardNo
、CardType
、ExpiryYear
、ExpiryMth
、TxnDtTm
、CurrCode
、TxnAmt
、ExpTxnAmt
、EcommMerchInd
、TokenFlag
、TokenShrtName
、MerchUserID
、MerchPromoCode
、MerchPromoAmt
、PromoAmtAcqCost
、PromoAmtMerchCost
、MerchHostID
、MerchSessionID
、TerminalID
和POSEnvFlag
- 与先前的支付请求中具有相同的值。
可选字段
字段名称 | 类型 | 长度 | 描述 | 示例 |
---|---|---|---|---|
TxnDtTm | 字符串 | 14 | 交易日期和时间。 格式:yyyymmddhhmmss | "20230119110544" |
TxnStatDetCde | 字符串 | 4 | 交易状态详细代码。 | "0000" |
TxnStatMsg | 字符串 | 256 | 交易状态消息。 | "SUCCESS" |
OrderRefNo | 字符串 | 34 | 订单参考编号。 | "OTMEGASTORE-20010831-ONLINE-007" |
TxnDtTm | 字符串 | 14 | 交易日期和时间。 格式:YYYYMMDDhhmmss。 | "20230119110544" |
CurrCode | 字符串 | 3 | 货币代码。 | "458" |
TxnAmt | 字符串 (数字) | 12 | 交易金额。 | "1280.99" |
ExpTxnAmt | 字符串 | 1 | 交易金额的指数。 | "2" |
PymtGwRefNo | 字符串 | 20 | 支付网关参考编号。 | "230119110548AC031FNX" |
EcommMerchInd | 字符串 | 1 | 电商商户指示器。 | "0" - 非电商商户, "1" - 电商 (3D Secure), "2" - 电商 (非 3D Secure/MOTO) |
TokenFlag | 字符串 | 1 | 卡令牌化。 | "Y" – 同意将用于支付的卡详细信息存储到 PayMaster 系统中, "N" – 不同意/FPX 支付 |
TokenShrtName | 字符串 | 20 | 档案参考名称。 | "fnxcard1" |
MerchUserID | 字符串 | 50 | 商户用户 ID。 | "guest-finexus" |
MerchPromoCode | 字符串 | 105 | 客户使用的商户促销代码。 | "CYBERSALES/GOODDAY/GIVEME" |
MerchPromoAmt | 字符串 (数字) | 64 | 客户使用的商户促销金额。 | "1.90/2.99/10.00" |
PromoAmtAcqCost | 字符串 (数字) | 12 | 收单方承担的促销金额成本。 | "0.90/0.99/5.00" |
PromoAmtMerchCost | 字符串 (数字) | 12 | 商户承担的促销金额成本。 | "0.90/0.99/5.00" |
MerchHostID | 字符串 | 8 | 商户主机标识符。 | "M2022121" |
MerchSessionID | 字符串 | 256 | 商户会话 ID。 | "20230113172620" |
TerminalID | 字符串 | 8 | 终端 ID。 注意: 少于 8 个位置的标识码必须左对齐,字段的其余空间必须填充。 | "T2022121" |
POSEnvFlag | 字符串 | 1 | POS 环境标志。 | "C" – 未安排的持卡人凭据, "I" – 分期, "R" – 循环支付 |
示例消息
- 请求
- 响应
CC Payment Authorization Request
curl -X GET "https://xxx.finexusgroup.com/upp/faces/ccpayment.xhtml?h001_MTI=0200&h002_VNO=06&h003_TDT=20230601&h004_TTM=18304600&f001_MID=00001XX00012XXX&f003_ProcCode=003000&f004_PAN=8815XX3000256377XXX&f005_ExpDate=2X1X&f006_TxnDtTm=20230601183046&f007_TxnAmt=000000000100&f008_POSCond=73&f010_CurrCode=458&f012_CVV2=&f014_3DXID=&f015_3DARC=&f016_3DCAVVLen=28&f017_3DCAVV=&f019_ExpTxnAmt=2&f022_ECI=12&f247_OrgTxnAmt=&f248_OrgCurrCode=&f249_TxnCh=WEB&f260_ServID=FNX&f261_HostID=&f262_SessID=&f263_MRN=20230601060646FNXPHP&f264_Locale=en&f265_RURL_CCPS=https%3A%2F%2Fwww.google.com%2Fpayment%2Fsuccess&f266_RURL_CCPU=https%3A%2F%2Fwww.google.com%2Fpayment%2Fdeclined&f267_RURL_CCPC=https%3A%2F%2Fwww.google.com%2Fpayment%2Fcancel&f268_CHName=&f269_IssName=&f270_ORN=&f271_ODesc=&f278_EMailAddr=&f279_HP=&f285_IPAddr=&f287_ExpOrgTxnAmt=&f288_IssCntrCde=&f350_CrdTyp=&f354_TID=&f352_AcqBank=&f353_IPPTenure=&f325_ECommMercInd=&f339_TokenFlg=Y&f340_MercPromoCde=&f341_MercPromoAmt=&f342_PromoAmtAcqCst=&f343_PromoAmtMercCst=&f344_MercCustId=&f347_TokenShrtNm=&f363_InvNum=&f364_Fee=&f365_POSEnvFlg=&t001_SHT=SH2&t002_SHV=25E942435XXXBC4EA97C3AXXX4A3BD52B18B8B969923DDXXXB4885D823374XXX" \
CC 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=000000128099&f009_RespCode=00&f010_CurrCode=458&f011_AuthIDResp=397939&f013_CVV2RsltCd=0&f019_ExpTxnAmt=2&f023_RRN=301930987112&f024_OrgRespCode=00&f257_PGRN=230119110548AC031FNX&f258_TxnStatDetCde=0000&f259_TxnStatMsg=SUCCESS&f261_HostID=M2022121&f262_SessID=20230113172620&f263_MRN=20230119110520FNX&f270_ORN=OTMEGASTORE-20010831-ONLINE-007&f325_ECommMercInd=1&f339_TokenFlg=Y&f340_MercPromoCde=&f341_MercPromoAmt=&f342_PromoAmtAcqCst=&f343_PromoAmtMercCst=&f344_MercCustId=guest-finexus&f346_Token=8801923000216577863&f347_TokenShrtNm=fnxcard1&f348_MaskPAN=84415977423665&f350_CrdTyp=MST&f354_TID=T2022121&f365_POSEnvFlg=R&t001_SHT=SH2&t002_SHV=0F3086E879F80EB6BFA8D0E3FFD2D489AE8F4DDFA7B8F8511151B0BE27CF3B79"