卡片退款

Refund - 進行購貨退款

此API為必要串接

Request

欄位

必填

型別

範例

說明

Method

YES

String(5)

31800

支付方式, 悠遊卡使用31800

ServiceType

YES

String

Refund

服務代碼

MchId

YES

String

Account0001

特店帳號

TradeKey

YES

String

sha256...hash

交易密碼(sha256編碼)

CreateTime

YES

String

20180101120000

建立日期, yyyyMMddHHmmss

Data

欄位

必填

型別

範例

說明

DeviceId

YES

String

01301234

終端機(讀卡機)編號

Retry

YES

String

0

重試次數, 請帶入0

Amount

YES

String

10

退款金額, 必須與原訂單交易金額一致

StoreOrderNo

YES

String

PO180101001

原交易的訂單編號

RefundKey

YES

String

sha256...hash

退款密碼(sha256編碼)

Response

Header

欄位

型別

範例

說明

StatusCode

String(4)

0000

交易結果代碼

StatusDesc

String

交易成功

交易結果代碼說明

Method

String(5)

31800

支付方式, 悠遊卡使用31800

ServiceType

String

Refund

服務代碼

MchId

String

Account0001

特店帳號

ResponseTime

String

20180101120000

交易回應時間, yyyyMMddHHmmss

Data

欄位

型別

範例

說明

EZCardID

String

934528053

卡號(隱碼)

EZCardType

String

00

PersonalProfile

String

00

CardNumberForPrint

String

934528053

Amount

String

10

退款金額

Balance

String

4000

扣款後金額

BeforeTXNBalance

String

3990

扣款前金額

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

交易結果

Retry

String

0

ErrorCode

String

000000

交易結果代碼

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"
}
}