Payment Parameters
Method : GET
URL : https://xxx.finexusgroup.com/upp/faces/ccpayment.xhtml?
- Request Parameters
- Response Parameters
info
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 |
info
Recurring Payment Response Message is used as response to the request message originated by Merchant Server. This 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 | Type | Length | Description | Example |
|---|---|---|---|---|
MerchantID | String | 15 | Merchant ID. Note: Same value of MerchantID stored in properties file. | "000010000099939" |
MerchRefNo | String | 40 | Merhant Reference Number. | "20230119110520FNX" |
TxnStatus | String | 2 | Transaction status. Appendix 3 | "00" |
SHAlgorithmType | String | 3 | Secure Hash Algorithm type. | "SH2" |
SHValue | String | 64 | Secure Hash Value. Appendix 1 | "..." |
CardNo | String | 19 | Conditional field Card number. | "545301XXXXXX5323" |
CardType | String | 3 | Conditional field Card type. | "VSA" – Visa card, "MST" - Mastercard, "CUP" – China Union Pay |
ExpiryYear | String | 2 | Conditional field Card expiry year. | "27" |
ExpiryMth | String | 2 | Conditional field Card expiry month. | "10" |
AuthIDRespCode | String | 6 | Conditional field Authorization ID response code. Note: Available for successful payment. | "397939" |
CVV2ResultCode | String | 1 | Conditional field Card Verification Value 2 result code. | "0" |
RetrievalRefNo | String | 12 | Conditional field Retrieval reference number. | "301930987112" |
OrigRespCode | String | 8 | Conditional field Original response code. Appendix 3 Note: Available if the original bank response code is not larger than 8 characters. | "00" |
Token | String | 19 | Conditional field Reference number of new card stored. Note: Mandatory if TokenFlag is "Y". | "8801923000216577863" |
MaskCardNo | String | 19 | Conditional field Masked card number. Note: Mandatory if TokenFlag is "Y". | "84415977423665" |
info
CVV2ResultCodeandRetrievalRefNo- 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,TerminalIDandPOSEnvFlag- Same value as in prior payment request.
Optional Fields
| Field Name | Type | Length | Description | Example |
|---|---|---|---|---|
TxnDtTm | String | 14 | Transaction date and time. Format: yyyymmddhhmmss | "20230119110544" |
TxnStatDetCde | String | 4 | Transaction status detail code. | "0000" |
TxnStatMsg | String | 256 | Transaction status message. | "SUCCESS" |
OrderRefNo | String | 34 | Order reference number. | "OTMEGASTORE-20010831-ONLINE-007" |
TxnDtTm | String | 14 | Transaction date and time. Format: YYYYMMDDhhmmss. | "20230119110544" |
CurrCode | String | 3 | Currency code. | "458" |
TxnAmt | String (Numeric) | 12 | Transaction amount. | "1280.99" |
ExpTxnAmt | String | 1 | Exponent of transaction amount. | "2" |
PymtGwRefNo | String | 20 | Payment Gateway reference number. | "230119110548AC031FNX" |
EcommMerchInd | String | 1 | Ecommerce merchant indicator. | "0" - Non-E-Commerce merchant, "1" - E-Commerce (3D Secure), "2" - E-Commerce (Non-3D Secure/MOTO) |
TokenFlag | String | 1 | Card tokenization. | "Y" – Agree to store the card details used for the payment into PayMaster system, "N" – Disagree/FPX payment |
TokenShrtName | String | 20 | Profile reference name. | "fnxcard1" |
MerchUserID | String | 50 | Merchant user ID. | "guest-finexus" |
MerchPromoCode | String | 105 | Merchant promotion code used by customer. | "CYBERSALES/GOODDAY/GIVEME" |
MerchPromoAmt | String (Numeric) | 64 | Merchant promotion amount used by customer. | "1.90/2.99/10.00" |
PromoAmtAcqCost | String (Numeric) | 12 | Promotion amount cost borne by Acquirer. | "0.90/0.99/5.00" |
PromoAmtMerchCost | String (Numeric) | 12 | Promotion amount cost borne by Merchant. | "0.90/0.99/5.00" |
MerchHostID | String | 8 | Merchant host identifier. | "M2022121" |
MerchSessionID | String | 256 | Merchant session ID. | "20230113172620" |
TerminalID | 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 | String | 1 | POS environment flag. | "C" – Unscheduled credential on file, "I" – Installment, "R" – Recurring |
Example Message
- Request
- Response
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"
