Reversal

Method GET

URL

https://xxx.finexusgroup.com/upp/faces/reversal0400.xhtml?

Request Parameters

Mandatory Fields

Field Name	Type	Length	Description	Example
h001_MTI	String	4	Message type identifier.	0400
h002_VNO	String	2	Version number.	06
h003_TDT	String	8	Transmission date (YYYYMMDD).	20010831
h004_TTM	String	8	Transmission time.	12432905
f001_MID	String	15	Merchant number (MID).	120567801561128
f003_ProcCode	String	6	Processing code. Use 220000 for reversal of normal sales.	220000
f006_TxnDtTm	String	14	Transaction date & time (YYYYMMDDhhmmss).	20010831124329
f007_TxnAmt	String	12	Transaction amount (same as original).	000000057080
f008_POSCond	String	2	POS condition code (same as original).	59
f010_CurrCode	String	3	Currency code.	458
f019_ExpTxnAmt	String	1	Exponent of transaction amount.	2
f260_ServID	String	3	Service ID.	FNX
f263_MRN	String	1–40	Merchant reference number.	2012121912345
t001_SHT	String	3	Secure hash algorithm type.	SH2
t002_SHV	String	64	Secure hash value. Appendix 1	61936D1EF085FF70CA9682234B7D9159

Optional Fields

Field Name	Type	Length	Description	Example
f004_PAN	String	12–19	Conditional. Card/account number. Required when original payment used message 0200.	4966230077888877
f011_AuthIDResp	String	6	Conditional. Required for reversal of previously approved txn (f003 pos 1–2 = 22). Omitted for timeout (29).	12882J
f023_RRN	String	12	Conditional. Retrieval reference number if returned by acquirer.	102812345678
f257_PGRN	String	20	Conditional. Required for approved txn reversal; omitted for timeout.	AJ789EG07S0012012022
f261_HostID	String	8	Optional. Merchant host ID.	AAMWEB02
f262_SessID	String	1–256	Optional. Merchant session ID.	2012121956789
f264_Locale	String	2–5	Optional. Language locale.	en
f270_ORN	String	2–34	Optional. Order reference number.	ECT-01-20010830-00380
f272_RURL_CCR	String	1–512	Optional. Reversal return URL. If omitted, response returns to the same session.	https://xxx/reversal.jsp
f354_TID	String	8	Optional. Terminal ID.	10001112

Response Parameters

Mandatory Fields

Field Name	Type	Length	Description	Example
h001_MTI	String	4	Message type identifier.	0410
h002_VNO	String	2	Version number.	06
h003_TDT	String	8	Transmission date.	20010831
h004_TTM	String	8	Transmission time.	12432905
f001_MID	String	15	Merchant number (same as request).	120567801561128
f003_ProcCode	String	6	Processing code (same as request).	220000
f004_PAN	String	12–19	Primary account number.	4966230077888877
f006_TxnDtTm	String	14	Transaction date & time.	20010831124329
f007_TxnAmt	String	12	Transaction amount.	000000057080
f009_RespCode	String	2	Response code.	00
f010_CurrCode	String	3	Currency code.	458
f011_AuthIDResp	String	6	Conditional. Authorization ID response.	12882J
f019_ExpTxnAmt	String	1	Exponent of transaction amount.	2
f257_PGRN	String	20	Conditional. Payment gateway reference number.	AJ789EG07S0012012022
f258_TxnStatDetCde	String	4	Transaction status detail code.	0000
f260_ServID	String	3	Service ID.	FNX
f263_MRN	String	1–40	Merchant reference number.	20230119110520FNX
t001_SHT	String	3	Secure hash algorithm type.	SH2
t002_SHV	String	64	Secure hash value. Appendix 1	...

Optional Fields

Field Name	Type	Length	Description	Example
f259_TxnStatMsg	String	1–256	Transaction status message.	Approved
f261_HostID	String	8	Merchant host ID.
f262_SessID	String	1–256	Merchant session ID.
f270_ORN	String	2–34	Order reference number.

f258_TxnStatDetCde — common values

Code	Category	Meaning
0000	Success	Reversal approved by acquirer
0021	Success	Transaction already previously reversed
0076	Success	Reversal for non-existing transaction acknowledged
0022	Retry	Reversal in progress — query or retry later
0091	Retry	Resources temporarily unavailable at acquirer
0096	Retry	Resources temporarily unavailable at PayMaster
0013	Fatal	Invalid reversal amount
0014	Fatal	Authorization ID unmatched
0030	Fatal	Invalid message format
0090	Fatal	Acquirer rejected reversal

Example Message

Request

UPP 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=15050500&f001_MID=D1022012123&f003_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"

Response

UPP 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