Refund Payment Parameters

Method POST

URL

https://xxx.finexusgroup.com/fnx-fintech/xxx/mqpos-host/thirdparty/refund

Request Parameters

Mandatory Fields

Field Name	Type	Length	Description	Example
MsgVer	String	20	Version number.	"1"
TxnID	String	50	Unique transaction ID assigned by caller application.	"2021061414062021072"
MID	String	15	Merchant ID.	"0000100000130XX"
LocalTxnDTTime	String	14	Local date and time which transactions takes place in YYYYMMDDhhmmss format.	"20200131091025"
AmtTxn	String	12	Transaction amount.	"100"
CrcyTxn	String	3	Original transaction currency numeric code.	"458"
OrgTxnID	String	20	Original transaction id, to retrieve the original transaction.	"2021061414062021072"
OrgHTR	String	20	Original HTR, to retrieve the original transaction.
sourceSystem	String	3	Channel/Source Name.	"mxx"
sequenceNo	String	16	A running message sequence number which unique within system on a calendar day and shall restart from 1 every day.	"2022091511262180"
signedMessage	String	2048	The signature value is generated from other fileds, then signed by RSA private key. Please refer to Appendix 1.	"..."

Optional Fields

Field Name	Type	Length	Description	Example
Description	String	256	Order description	Coffee

Response Parameters

Mandatory / Conditional Fields

Field Name	Type	Length	Description	Example
MsgVer	String	20	Version number.	"1"
TxnID	String	50	Unique transaction ID assigned by caller application.	"2021061414062020000"
ResultCode	String	2	Result code responded by mPOS. Please refer to Appendix 3 for details.	"00"
RespCd	String	2	Conditional field Response returned from acquiring host. Please refer to Appendix 2 for details.	"00"
OrgRespCd	String	2	Conditional field Original response code from issuer/bank.	"00"
RRN	String	12	Conditional field A retrieval reference number generated by the acquirer host.	"307219058382"
STAN	String	6	Conditional field Returned by host, set in result Intent. System Trace Audit Number of the original transaction.	"58382"
AuthIdResp	String	16	Conditional field Authorization code from issuer/bank for approved transaction only. The consumer should use this code as the reference to the approved payment transaction.	"484684"
HTR	String	20	Conditional field Host Transaction Reference A unique transaction reference number generated by ACQ host.
AdvMsg	String	256	Included by Host to ease the support and problem diagnostic.
sourceSystem	String	3	Channel/Source Name.	"mxx"
sequenceNo	String	16	A running message sequence number which unique within system on a calendar day and shall restart from 1 every day.	"2022091511262180"
signedMessage	String	2048	The signature value is generated from other fileds, then signed by RSA private key. Please refer to Appendix 1.	"..."

Example Message

Request

POST Request

curl -X POST
"https://xxx.xxx.com/xxx/xxx/mqpos-host/thirdparty/refund" \
 -H "Accept: application/json" \
 -H "Content-Type: application/json" \
 -d '{
        MsgVer:"1"
        TxnID:"2021061414062021072"
        MID:"0000100000130XX"
        LocalTxnDTTime:"20200131091025"
        AmtTxn:"100""
        CrcyTxn:"458"
        OrgTxnID:"2021061414062021072"
        OrgHTR:"123"
        sourceSystem:"mxx"
        sequenceNo:"2022091511262180"
        signedMessage:""
    }'

Response

POST Response

{
    "MsgVer":"1",
    "TxnID":"2021061414062020000",
    "ResultCode":"00",
    "RespCd":"00",
    "OrgRespCd":"00",
    "RRN":"307219058382",
    "STAN":"58382",
    "AuthIdResp":"484684",
    "HTR":"",
    "AdvMsg":"",
    "sourceSystem":"mxx",
    "sequenceNo":"2022091511262180",
    "signedMessage":"..."
}