支付参数
方法: 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 | "0F3086E879F80EB6BFA8D0E3FFD2D489AE8F4DDFA7B8F8511151B0BE27CF3B79" |
TxnStatDetCde | 可选 | 字符串 | 4 | 交易状态详细代码。 | "0000" |
TxnStatMsg | 可选 | 字符串 | 256 | 交易状态消息。 | "SUCCESS" |
OrderRefNo | 可选 | 字符串 | 34 | 订单参考编号。 | "OTMEGASTORE-20010831-ONLINE-007" |
CardNo | 条件性 | 字符串 | 19 | 卡号。 | "545301XXXXXX5323" |
CardType | 条件性 | 字符串 | 3 | 卡类型。 | "VSA" – Visa 卡, "MST" - 万事达卡, "CUP" – 中国银联 |
ExpiryYear | 条件性 | 字符串 | 2 | 卡到期年份。 | "27" |
ExpiryMth | 条件性 | 字符串 | 2 | 卡到期月份。 | "10" |
TxnDtTm | 可选 | 字符串 | 14 | 交易日期和时间。 格式：YYYYMMDDhhmmss。 | "20230119110544" |
CurrCode | 可选 | 字符串 | 3 | 货币代码。 | "458" |
TxnAmt | 可选 | 字符串（数字） | 12 | 交易金额。 | "1280.99" |
ExpTxnAmt | 可选 | 字符串 | 1 | 交易金额的指数。 | "2" |
AuthIDRespCode | 条件性 | 字符串 | 6 | 授权 ID 响应代码。 注意： 仅在支付成功时可用。 | "397939" |
CVV2ResultCode | 条件性 | 字符串 | 1 | CVV2 结果代码。 | "0" |
RetrievalRefNo | 条件性 | 字符串 | 12 | 检索参考编号。 | "301930987112" |
OrigRespCode | 条件性 | 字符串 | 8 | 原始响应代码。附录 3 注意： 如果原始银行响应代码不超过 8 个字符。 | "00" |
PymtGwRefNo | 可选 | 字符串 | 20 | 支付网关参考编号。 | "230119110548AC031FNX" |
EcommMerchInd | 可选 | 字符串 | 1 | 电子商务商户指示器。 | "0" - 非电子商务商户, "1" - 电子商务（3D 安全）, "2" - 电子商务（非 3D 安全/MOTO） |
TokenFlag | 可选 | 字符串 | 1 | 卡令牌化。 | "Y" – 同意将用于支付的卡详细信息存储到 PayMaster 系统中， "N" – 不同意/FPX 支付 |
TokenShrtName | 可选 | 字符串 | 20 | 档案参考名称。 | "fnxcard1" |
Token | 条件性 | 字符串 | 19 | 存储的新卡的参考编号。 注意： 如果 TokenFlag 为 "Y" 则为必填项。 | "8801923000216577863" |
MaskCardNo | 条件性 | 字符串 | 19 | 掩码化的卡号。 注意： 如果 TokenFlag 为 "Y" 则为必填项。 | "84415977423665" |
MerchUserID | 可选 | 字符串 | 50 | 商户用户 ID。 | "guest-finexus" |
MerchPromoCode | 可选 | 字符串 | 105 | 客户使用的商户促销代码。 | "CYBERSALES |
MerchPromoAmt | 可选 | 字符串（数字） | 64 | 客户使用的商户促销金额。 | "1.90 |
PromoAmtAcqCost | 可选 | 字符串（数字） | 12 | 收单方承担的促销金额成本。 | "0.90 |
PromoAmtMerchCost | 可选 | 字符串（数字） | 12 | 商户承担的促销金额成本。 | "0.90 |
MerchHostID | 可选 | 字符串 | 8 | 商户主机标识符。 | "M2022121" |
MerchSessionID | 可选 | 字符串 | 256 | 商户会话 ID。 | "20230113172620" |
TerminalID | 可选 | 字符串 | 8 | 终端 ID。 注意： 少于 8 个位置的标识代码必须左对齐，其余部分填充字段空间。 | "T2022121" |
POSEnvFlag | 可选 | 字符串 | 1 | POS 环境标志。 | "C" – 非计划凭证文件, "I" – 分期, "R" – 定期 |
以下是中文翻译：
信息
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- 与先前的付款请求中具有相同的值。
示例消息
- 请求
- 响应
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"
