Payment Parameters
Method : GET
URL : https://xxx.finexusgroup.com/upp/faces/ccpayment.xhtml?
- Request Parameters
- Response Parameters
Recurring Payment Request Message is used to request approval from card issuers to transfer the funds from cardholder account to merchant account.
In return, Merchant Server shall expect the corresponding response message from PayMaster within stipulated timeout value.
Mandatory Fields
Field Name | Type | Length | Description | Example |
---|---|---|---|---|
PaymentID | String | 3 | Payment method / function. | "C04" |
MerchRefNo | String | 40 | Unique merchant reference number. | "2021061414062021072" |
CurrCode | String | 3 | ISO 4217 currency numeric code. | "458" |
TxnAmt | String (Numeric) | 12 | Transaction amount with two decimals and thousand symbols. Note: Maximum value is 12 digits; which includes the digit(s) after the decimal place. | "1280.99" |
ExpTxnAmt | String | 1 | Exponent of transaction amount. | "2" |
CardNo | String | 19 | Token number. | "8815023000256377XXX" |
ExpiryYear | String | 2 | Card expiry year Format: YY. | "27" |
ExpiryMth | String | 2 | Card expiry month Format: MM. | "10" |
ECI | String | 2 | Ecommerce transaction type. | "12" - Recurring Transaction(Stored Credential) |
TokenFlag | String | 1 | Card tokenization. | "Y" – Agree to store the card details used for the payment into PayMASTER system, "N" – Disagree/FPX payment |
Recurring Payment Response Message is used to response to the Recurring Payment Request Message originated by Merchant Server. Recurring Payment Response Message contains the outcome of the authorization approval outcome.
Merchant Server shall examine the Response Code RespCode
for the processing outcome of the Request Message. Transaction Status Detail Code TxnStatDetCde
will provide the supplementary information/status of the transaction (if available).
Upon completion of the Card payment process, PayMaster shall redirect the customer browser back to the specified return URL per the completion status.
Mandatory / Conditional Fields
Field Name | Required | Type | Length | Description | Example |
---|---|---|---|---|---|
MerchantID | Yes | String | 15 | Merchant ID. Note: Same value of MerchantID stored in properties file. | "000010000099939" |
MerchRefNo | Yes | String | 40 | Merhant Reference Number. | "20230119110520FNX" |
TxnStatus | Yes | String | 2 | Transaction status. Appendix 3 | "00" |
SHAlgorithmType | Yes | String | 3 | Secure Hash Algorithm type. | "SH2" |
SHValue | Yes | String | 64 | Secure Hash Value. Appendix 1 | "0F3086E879F80EB6BFA8D0E3FFD2D489AE8F4DDFA7B8F8511151B0BE27CF3B79" |
TxnStatDetCde | Optional | String | 4 | Transaction status detail code. | "0000" |
TxnStatMsg | Optional | String | 256 | Transaction status message. | "SUCCESS" |
OrderRefNo | Optional | String | 34 | Order reference number. | "OTMEGASTORE-20010831-ONLINE-007" |
CardNo | Conditional | String | 19 | Card number. | "545301XXXXXX5323" |
CardType | Conditional | String | 3 | Card type. | "VSA" – Visa card, "MST" - Mastercard, "CUP" – China Union Pay |
ExpiryYear | Conditional | String | 2 | Card expiry year. | "27" |
ExpiryMth | Conditional | String | 2 | Card expiry month. | "10" |
TxnDtTm | Optional | String | 14 | Transaction date and time. Format: YYYYMMDDhhmmss. | "20230119110544" |
CurrCode | Optional | String | 3 | Currency code. | "458" |
TxnAmt | Optional | String (Numeric) | 12 | Transaction amount. | "1280.99" |
ExpTxnAmt | Optional | String | 1 | Exponent of transaction amount. | "2" |
AuthIDRespCode | Conditional | String | 6 | Authorization ID response code. Note: Available for successful payment. | "397939" |
CVV2ResultCode | Conditional | String | 1 | Card Verification Value 2 result code. | "0" |
RetrievalRefNo | Conditional | String | 12 | Retrieval reference number. | "301930987112" |
OrigRespCode | Conditional | String | 8 | Original response code. Appendix 3. Note: Available if the original bank response code is not larger than 8 characters. | "00" |
PymtGwRefNo | Optional | String | 20 | Payment Gateway reference number. | "230119110548AC031FNX" |
EcommMerchInd | Optional | String | 1 | Ecommerce merchant indicator. | "0" - Non-E-Commerce merchant, "1" - E-Commerce (3D Secure), "2" - E-Commerce (Non-3D Secure/MOTO) |
TokenFlag | Optional | String | 1 | Card tokenization. | "Y" – Agree to store the card details used for the payment into PayMaster system, "N" – Disagree/FPX payment |
TokenShrtName | Optional | String | 20 | Profile reference name. | "fnxcard1" |
Token | Conditional | String | 19 | Reference number of new card stored. Note: Mandatory if TokenFlag is "Y". | "8801923000216577863" |
MaskCardNo | Conditional | String | 19 | Masked card number. Note: Mandatory if TokenFlag is "Y". | "84415977423665" |
MerchUserID | Optional | String | 50 | Merchant user ID. | "guest-finexus" |
MerchPromoCode | Optional | String | 105 | Merchant promotion code used by customer. | "CYBERSALES |
MerchPromoAmt | Optional | String (Numeric) | 64 | Merchant promotion amount used by customer. | "1.90 |
PromoAmtAcqCost | Optional | String (Numeric) | 12 | Promotion amount cost borne by Acquirer. | "0.90 |
PromoAmtMerchCost | Optional | String (Numeric) | 12 | Promotion amount cost borne by Merchant. | "0.90 |
MerchHostID | Optional | String | 8 | Merchant host identifier. | "M2022121" |
MerchSessionID | Optional | String | 256 | Merchant session ID. | "20230113172620" |
TerminalID | Optional | String | 8 | Terminal ID. Note: An identification code of fewer than 8 positions must be left-justified and the remainder of the field space-filled. | "T2022121" |
POSEnvFlag | Optional | String | 1 | POS environment flag. | "C" – Unscheduled credential on file, "I" – Installment, "R" – Recurring |
CVV2ResultCode
andRetrievalRefNo
- Available if returned by Acquirer in the response message.MerchRefNo
,SHAlgorithmType
,OrderRefNo
,CardNo
,CardType
,ExpiryYear
,ExpiryMth
,TxnDtTm
,CurrCode
,TxnAmt
,ExpTxnAmt
,EcommMerchInd
,TokenFlag
,TokenShrtName
,MerchUserID
,MerchPromoCode
,MerchPromoAmt
,PromoAmtAcqCost
,PromoAmtMerchCost
,MerchHostID
,MerchSessionID
,TerminalID
andPOSEnvFlag
- Same value as in prior payment request.
Example Message
- Request
- Response
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" \
"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"