Payment Parameters
Method GETURL
https://xxx.finexusgroup.com/upp/faces/reversal0400.xhtml?
- Request Parameters
- Response Parameters
Mandatory Fields
Field Name | Type | Length | Description | Example |
---|---|---|---|---|
PaymentID | String | 3 | Payment method / function. Note: PaymentID = "C15" applicable for transactions before settlement or within the same day. PaymentID = "C05" applicable for transactions after settlement or beyond one day. DuitNow QR payments are eligible for PaymentID = "C05" only. | "C05" - E-Commerce Transaction Refund, "C15" - Reversal for E-Commerce Transaction |
MerchRefNo | String | 40 | Unique merchant reference number. Note: Provide the MerchRefNo of the transaction that requires a reversal if PaymentID = "C15". | "2021061414062020000" |
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" |
RetrievalRefNo | String | 12 | Retrieval Reference Number. Note: Applicable to PaymentID = "C05" only. | "306274008021" |
Mandatory Fields
Field Name | Type | Length | Description | Example |
---|---|---|---|---|
MerchantID | String | 15 | Merchant ID. Note: Same value of MerchantID stored in properties file. | "000010000012639" |
TxnStatus | String | 2 | Transaction status | "00" |
MerchRefNo | String | 40 | Merhant Reference Number. | "20230119110520FNX" |
Optional Fields
Field Name | Type | Length | Description | Example |
---|---|---|---|---|
TxnStatDetCde | String | 4 | Transaction status detail code. | "0000" |
TxnStatMsg | String | 256 | Transaction status message. | "Approved" |
Example Message
- Request
- Response
CC Payment Reversal Request
curl -X GET
"https://xxx.finexusgroup.com/upp/faces/reversal0400.xhtml?h001_MTI=0400&h002_VNO=06&h003_TDT=20230526&h004_TTM=150505000&f001_MID=D1022012123f003_ProcCode=220000&f004_PAN=&f006_TxnDtTm=20230526112551&f007_TxnAmt=000000000100&f008_POSCond=59&f010_CurrCode=458&f011_AuthIDResp=&f019_ExpTxnAmt=2&f023_RRN=&f257_PGRN=&f260_ServID=FNX&f261_HostID=&f262_SessID=&f263_MRN=2021061414062021072&f264_Locale=en&f270_ORN=&f272_RURL_CCR=http%3A%2F%2Flocalhost%2Fclient%2F&t001_SHT=SH2&t002_SHV=E73CEDA9D9A8D1AAF59BDB919EF7C82D52671A4B457CE816BCE91AFF31485259" \
CC Payment Reversal Response
https://xxx.finexusgroup.com/payment/reversal?h001_MTI=0410&h002_VNO=06&h003_TDT=20230526&h004_TTM=09192100&f001_MID=000010000012639&f003_ProcCode=220000&f004_PAN=545301XXXXXX5323&f006_TxnDtTm=20230526091921&f007_TxnAmt=000000001000&f009_RespCode=00&f010_CurrCode=458&f011_AuthIDResp=&f019_ExpTxnAmt=2&f257_PGRN=&f258_TxnStatDetCde=0000&f259_TxnStatMsg=Approved&f260_ServID=FNX&f261_HostID=&f262_SessID=&f263_MRN=20230119110520FNX&f270_ORN=&t001_SHT=SH2&t002_SHV=0F3086E879F80EB6BFA8D0E3FFD2D489AE8F4DDFA7B8F8511151B0BE27CF3B79