Payment Parameters
Method : GET
URL : https://xxx.finexusgroup.com/upp/faces/reversal0400.xhtml?
- Request Parameters
- Response Parameters
info
Payment Reversal Request Message can be used to:
- reverse an earlier timeout transaction, or
- reverse the charge on the cardholder due to merchant failed to deliver the goods or services.
Other conditions:
- Merchant Server is not able to reverse the transaction amount greater than earlier approved amount.
- Partial amount reversal is not supported and will be rejected.
- Subjected to acquirer system whether supports online reversal message.
- Subjected to acquirer settlement cut-off time of the transaction. Reversal request will be rejected by acquirer if the previous approved transaction is already settled.
Mandatory Fields
Field Name | Type | Length | Description | Example |
---|---|---|---|---|
PaymentID | String | 3 | Payment method / function. | "C15" |
MerchRefNo | String | 40 | Unique merchant reference number. | "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" |
info
Payment Reversal Response Message is generated by PayMASTER for Merchant Server to indicate the outcome of Reversal Request.
Upon completion of the Card payment process, PayMaster shall redirect the customer browser back to the specified return URL per the completion status.
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