Refund

Process the payment refund. This API implement is necessary.

Request

Header

Item	Mandatory	Data Type	Sample	Description
Method	YES	String(5)	31800	Fill in 31800 (EasyCard transaction)
ServiceType	YES	String	Refund	Selected Scan2Pay Service type
MchId	YES	String	Account0001	Merchant ID provided by intella
TradeKey	YES	String	sha256...hash	Marchant password provided by intella, this password must be encoded by SHA256
CreateTime	YES	String	20180101120000	Request time, the format is "yyyyMMddHHmmss"

Data

Item	Mandatory	Data Type	Sample	Description
DeviceId	YES	String	01301234	Terminal (reader) number
Retry	YES	String	0	Retry Times, Fill in 0
Amount	YES	String	10	Refund amount, has to match the transaction amount of the original order
StoreOrderNo	YES	String	PO180101001	Original order number
RefundKey	YES	String	sha256...hash	Refund password (encoded by sha256)

Response

Header

Item	Data Type	Sample	Description
StatusCode	String(4)	0000	Transaction Status Code
StatusDesc	String	Success	Description of transaction status
Method	String(5)	31800	Payment method code (EasyCard payment is 31800)
ServiceType	String	Refund	Selected Scan2Pay Service type
MchId	String	Account0001	Merchant ID
ResponseTime	String	20180101120000	Transaction response time, the format is “yyyyMMddHHmmss”

Data

Item	Data Type	Sample	Description
EZCardID	String	934528053	Internal card number
EZCardType	String	00
PersonalProfile	String	00
CardNumberForPrint	String	934528053
Amount	String	10	Payment amount
Balance	String	4000	Balance after payment
BeforeTXNBalance	String	3990	Balance before payment
TerminalTXNNumber	String	231741
HostSerialNumber	String	231741
Time	String	231741
Date	String	20180612
ExpiryDate	String	20191230
CPUPurseVersion	String	00
BankCode	String	00
AreaCode	String	01
AutoTopUpAmount	String	0
TXNResult	String	Success	Transaction result
Retry	String	0
ErrorCode	String	000000	Transaction Status Code
DongleDeviceID	String	08100DE0A57E
RRNumber	String	18061223174102
TXNType	String	Refund
NewAESKey	String	38e5c9f5...b830
DeviceNumber	String	0830000001304104
request	JSON

API Example

Request

{
  "Header": {
    "Method": "31800",
    "ServiceType": "Refund",
    "MchId": "myMchId",
    "TradeKey": "9af15b336e6a9619928537df30b2e6a2376569fcf9d7e773eccede65606529a0",
    "CreateTime": "20180715104821"
  },
  "Data": "{\"DeviceId\":\"01304187\",\"Retry\":\"0\",\"Amount\":\"10\",\"StoreOrderNo\":\"PO-20180715-005\",\"RefundKey\":\"9af15b336e6a9619928537df30b2e6a2376569fcf9d7e773eccede65606529a0\"}"
}

Response

{
  "Header": {
    "StatusCode": "0000",
    "StatusDesc": "STATUS_SUCCESS",
    "Method": "31800",
    "ServiceType": "Refund",
    "MchId": "myMchId",
    "ResponseTime": "20180715104826"
  },
  "Data": {
    "EZCardID": "1917740208",
    "EZCardType": "08",
    "PersonalProfile": "00",
    "CardNumberForPrint": "1917740208",
    "Amount": "10",
    "Balance": "472",
    "BeforeTXNBalance": "462",
    "TerminalTXNNumber": "104822",
    "HostSerialNumber": "104822",
    "Time": "104822",
    "Date": "20180715",
    "ExpiryDate": "20250810",
    "CPUPurseVersion": "00",
    "BankCode": "32",
    "AreaCode": "01",
    "AutoTopUpAmount": "0",
    "request": {
      "Amount": "10",
      "Retry": "0",
      "BatchNumber": "18071511",
      "SameCard": "0",
      "ServiceType": "Refund",
      "TerminalID": "09900000",
      "DeviceID": "01304187",
      "TerminalTXNNumber": "104822",
      "HostSerialNumber": "104822",
      "Time": "104822",
      "Date": "20180715",
      "AESKey": "574660f677ee8314812ad829a6b48bf7"
    },
    "TXNResult": "Success",
    "Retry": "0",
    "ErrorCode": "000000",
    "DongleDeviceID": "5B100DE00F97",
    "RRNumber": "18071510482289",
    "TXNType": "Refund",
    "NewAESKey": "afdf360efd1b506300ad6a76229fd03f",
    "DeviceNumber": "0990000001304187"
  }
}