Payment Parameters
Method GETURL
https://xxx.finexusgroup.com/upp/faces/reversal0400.xhtml?
- Request Parameters
- Response Parameters
The Payment Reversal Request Message can be used in the following scenarios:
- Reverse an Earlier Timeout Transaction: To undo a transaction that did not complete due to a timeout.
- Reverse a Charge Due to Non-Delivery: To reverse the charge if the merchant failed to deliver the goods or services.
Other conditions:
- Reversal Amount Limitations: The merchant's server cannot reverse an amount greater than the initially approved amount.
- Partial Amount Reversal: Partial reversals are not supported and will be rejected.
- Acquirer System Support: The ability to process online reversals depends on whether the acquirer system supports such messages.
- Settlement Cut-Off Time: The reversal request may be rejected if the previously approved transaction has already been settled, in accordance with the acquirer’s settlement cut-off time.
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" |
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