Refund Payment Parameters
Action request URL for REFUND : com.finexuscards.yippiepos.xxx.REFUND
The action VOID is applicable for transactions before settlement or on the same day.
The action REFUND is applicable for transactions after settlement or beyond one day.
DuitNow QR payments are eligible for REFUND only.
- Request Parameters
- Response Parameters
Mandatory / Conditional Fields
| Field Name | Type | Length | Description | Example |
|---|---|---|---|---|
MsgVer | String | 20 | Version number. | "1.0" |
CallerDeviceType | String | 20 | Caller device type. | "01" – Mobile Device "03" – Self-service Kiosk |
CallerDeviceVer | String | 20 | Application version number of the caller device. | "2.0.1" |
RefundTxnID | String | 50 | Unique transaction ID assigned by caller application. Note: Caller app, may generate a random UUID for this purpose. | "C5460ED3C5574F71AEFD63C1FDE495E5" |
OriTxnID | String | 50 | Original transaction ID The transaction of the payment to be refund. | "C5460ED3C5574F71AEFD63C1FDE495E5" |
LocalTxnDTTime | Int | 16 | Local date and time in which the refund transaction takes place in. Format: YYYYMMDDhhmmss Note: Refer to LocalTxnDTTime field in Sales Response Parameters. | "20200131091025" |
Email | String | 100 | User email address to login. | "wyongkeat@email.com" |
Pwd | String | 16 | User password to login. | "ABCD1234" |
RefundAmt | Number | 12 | Refund amount No decimal point appears in this field; the decimal place is implied in Exponent of Transaction Amount according to CrcyTxn defined in ISO 4217 numeric currency code. | "000000010000" |
CrcyTxn | Int | 3 | ISO 4217 numeric currency code of this transaction. | "458" |
OptInPmtAckmnt | String | 1 | Opt-in payment acknowledgement feature. | "Y" - Payment acknowledgement will be showed if payment successful. "N" - Payment acknowledgement will not be showed if payment successful. Default is "Y" |
Mandatory / Conditional Fields
| Field Name | Type | Length | Description | Example |
|---|---|---|---|---|
MsgVer | String | 20 | Version number. | "1.0" |
RefundTxnID | String | 20 | Refund Transaction ID is same value from the request. | "79112E72300E440891F60E14039C2DFD" |
ResultCode | String | 3 | Result code specified by mQPOS or mPOS device. It is the resultCode parameter in onActivityResult() 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" |
HTR | String | 20 | Conditional field Host Transaction Reference. A unique transaction reference number generated by ACQ host. | |
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" |