Refund

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 993000 – Refund by RRN.	993000
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
f023_RRN	String	12	Retrieval reference number of the original transaction.	102812345678
f260_ServID	String	3	Service ID.	FNX
f263_MRN	String	1–40	Merchant reference number. Provide a new MRN for Refund by RRN (993000).	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. Authorization ID response from the original transaction.	12882J
f257_PGRN	String	20	Conditional. Payment gateway reference number.	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. Return URL. If omitted, response returns to the same session.	https://xxx/refund.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).	993000
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	Refund approved by acquirer
0021	Success	Transaction already previously refunded / reversed
0076	Success	Refund for non-existing transaction acknowledged
0022	Retry	Refund in progress — query or retry later
0091	Retry	Resources temporarily unavailable at acquirer
0096	Retry	Resources temporarily unavailable at PayMaster
0013	Fatal	Invalid refund amount
0014	Fatal	Authorization ID unmatched
0030	Fatal	Invalid message format
0090	Fatal	Acquirer rejected refund

Example Message

Request

DuitNow Pay Refund 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=120567801561128&f003_ProcCode=993000&f006_TxnDtTm=20230526112551&f007_TxnAmt=000000000100&f008_POSCond=59&f010_CurrCode=458&f019_ExpTxnAmt=2&f023_RRN=102812345678&f260_ServID=FNX&f263_MRN=20230526150505001&f264_Locale=en&f272_RURL_CCR=http%3A%2F%2Flocalhost%2Fclient%2F&t001_SHT=SH2&t002_SHV=E73CEDA9D9A8D1AAF59BDB919EF7C82D52671A4B457CE816BCE91AFF31485259"

Response

DuitNow Pay Refund Response

https://xxx.finexusgroup.com/payment/refund?h001_MTI=0410&h002_VNO=06&h003_TDT=20230526&h004_TTM=09192100&f001_MID=120567801561128&f003_ProcCode=993000&f006_TxnDtTm=20230526091921&f007_TxnAmt=000000001000&f009_RespCode=00&f010_CurrCode=458&f019_ExpTxnAmt=2&f023_RRN=102812345678&f257_PGRN=&f258_TxnStatDetCde=0000&f259_TxnStatMsg=Approved&f260_ServID=FNX&f263_MRN=20230526150505001&t001_SHT=SH2&t002_SHV=0F3086E879F80EB6BFA8D0E3FFD2D489AE8F4DDFA7B8F8511151B0BE27CF3B79