# 重試交易(悠遊卡) {% hint style="info" %} 此API為必要串接 {% endhint %} 當交易進行的過程中, 如果有些步驟已經完成, 但還有步驟未完成前就被中斷 (例如扣款過程中卡片在交易進行程序中被取走), 就會導致交易不完整, 導致錯帳或其他問題。 此時, 就必須依照下面指示步驟進行重試交易, 讓交易完成． {% hint style="danger" %} 交易過程發生回應資料中的Retry值是1(含)以上時 (錯誤碼可能為000125或是0462xx), 就必須呼叫重試交易API, 否則會出現錯帳 {% endhint %} {% hint style="warning" %} 重試交易前, 需要先排除原先交易失敗的因素, 例如取走的卡片需要放回讀卡機上. {% endhint %} {% hint style="warning" %} 重試交易需要重試三次，第三次重試(發送Retry = 3)若失敗該筆交易就視為無法完成, 不能再進行重試. 該筆交易需反應給悠遊卡公司. {% endhint %} ## Request ### Header | 欄位 | 必填 | 型別 | 範例 | 說明 | | ----------- | --- | --------- | -------------- | ---------------------------------------- | | Method | YES | String(5) | 31800 | 支付方式, 悠遊卡使用31800 | | ServiceType | YES | String | *Payment* | 填入發生錯誤的交易的Response的Header.ServiceType中的值 | | MchId | YES | String | Account0001 | 填入發生錯誤的交易的Response的Header.MchId | | TradeKey | YES | String | sha256...hash | 交易密碼 | | CreateTime | YES | String | 20180101120000 | 建立日期, yyyyMMddHHmmss | ### Data | 欄位 | 必填 | 型別 | 範例 | 說明 | | ----------------- | ----- | ------ | ------------- | ------------------------------------------------------------ | | Retry | YES | String | 1 | 填入發生錯誤的交易的Response的Data.Retry中的值 (note: 非Data.request.Retry) | | DeviceId | YES | String | 01301234 | 填入發生錯誤的交易的Response的Data.request.DeviceID中的值 | | Amount | YES | String | 50 | 填入發生錯誤的交易的Response的Data.request.Amount中的值 | | StoreOrderNo | YES | String | PO12345678 | 填入發生錯誤的交易的Response的Data.OrderId中的值 | | TerminalTXNNumber | YES | String | 091212 | 填入發生錯誤的交易的Response的Data.request.TerminalTXNNumber中的值 | | HostSerialNumber | YES | String | 091212 | 填入發生錯誤的交易的Response的Data.request.HostSerialNumber中的值 | | RefundKey | (YES) | String | sha256...hash | 退款密碼, 當ServiceType為Refund/Cancel/EZCRefund時需帶入此欄位 | | ActionType | (YES) | String | | 當ServiceType為Cancel時需要帶入, 由發生錯誤的交易的Response中取得. | ## Response ### Header | 欄位 | 必填 | 型別 | 範例 | 說明 | | ------------ | --- | ------ | --------------- | ---------------------------------------------------- | | StatusCode | YES | String | 0000 | [交易結果代碼](/scan2pay/appendix/scan2pay-error-codes.md) | | StatusDesc | YES | String | STATUS\_SUCCESS | 交易結果代碼說明 | | Method | YES | String | 31800 | 支付方式, 悠遊卡使用31800 | | ServiceType | YES | String | *Payment* | 服務代碼, 同Request所傳入的ServiceType | | MchId | YES | String | Account0001 | 特店帳號 | | ResponseTime | YES | String | 20180101120000 | 交易回應時間, yyyyMMddHHmmss | ### Data | 欄位 | 必填 | 型別 | 範例 | 說明 | | --------- | --- | ----------- | ---------- | ---------------------------------------------------- | | request | YES | JSON String | | request所傳入的data參數 | | TXNResult | YES | String | Success | 交易結果 | | Retry | YES | String | 0 | 下次request的Retry參數值 | | ErrorCode | YES | String | 000000 | [交易結果代碼](/scan2pay/appendix/easycard-error-codes.md) | | OrderId | YES | String | PO12345678 | 訂單編號 | | NewAESKey | NO | String | | 內部交易使用 | {% hint style="warning" %} Data中的欄位會依據交易結果與類型而有不同, 請參照各交易(如Payment/Refund)的回應參數表 {% endhint %} ## API Example ### 發生重試錯誤的交易(扣款交易) ### Request ``` { "Header": { "Method": "31800", "ServiceType": "Payment", "MchId": "Acoount0001", "TradeKey": "9af15b336e6a..........65606529a0", "CreateTime": "20180920152226" }, "Data": "{\"DeviceId\":\"01304108\",\"Retry\":\"0\",\"Amount\":\"1\",\"StoreOrderNo\":\"PO123456\",\"Body\":\"9af15b336e6a..........65606529a0\"}" } ``` ### Response ``` { "Header": { "StatusCode": "0000", "StatusDesc": "STATUS_SUCCESS", "Method": "31800", "ServiceType": "Payment", "MchId": "Account0001", "ResponseTime": "20180920152235" }, "Data": { "request": { "Amount": "1", "Retry": "0", "BatchNumber": "18092000", "SameCard": "0", "ServiceType": "Payment", "TerminalID": "08300000", "DeviceID": "01301234", "TerminalTXNNumber": "152226", "HostSerialNumber": "152226", "Time": "152226", "Date": "20180920", "AESKey": "ae83eef21d....f18a2644" }, "TXNResult": "Fail", "Retry": "1", "ErrorCode": "000125", "OrderId": "PO123456", "NewAESKey": "" } } ``` ### 第一次重試交易(失敗) ### Request ``` { "Header": { "Method": "31800", "ServiceType": "Payment", "MchId": "Account0001", "TradeKey": "9af15b336e6a96199......606529a0", "CreateTime": "20180920152531" }, "Data": "{\"DeviceId\":\"01304108\",\"Retry\":\"1\",\"Amount\":\"1\",\"StoreOrderNo\":\"PO123456\",\"RefundKey\":\"9af15b336e6a..........65606529a0\",\"ActionType\":\"\",\"TerminalTXNNumber\":\"152226\",\"HostSerialNumber\":\"152226\"}" } ``` ### Response ``` { "Header": { "StatusCode": "0000", "StatusDesc": "STATUS_SUCCESS", "Method": "31800", "ServiceType": "Payment", "MchId": "Acoount0001", "ResponseTime": "20180920152538" }, "Data": { "request": { "Amount": "1", "Retry": "1", "BatchNumber": "18092000", "SameCard": "1", "ServiceType": "Payment", "TerminalID": "08300000", "DeviceID": "01301234", "TerminalTXNNumber": "152226", "HostSerialNumber": "152226", "Time": "152531", "Date": "20180920", "AESKey": "ae83eef21d482......18a2644" }, "TXNResult": "Fail", "Retry": "2", "ErrorCode": "000125", "OrderId": "PO123456", "NewAESKey": "" } } ``` ### 第二次重試交易(成功) ### Request ``` { "Header": { "Method": "31800", "ServiceType": "Payment", "MchId": "Account0001", "TradeKey": "9af15b336e6a96199......5606529a0", "CreateTime": "20180920152636" }, "Data": "{\"DeviceId\":\"01301234\",\"Retry\":\"2\",\"Amount\":\"1\",\"StoreOrderNo\":\"PO123456\",\"RefundKey\":\"9af15b336e6a..........65606529a0\",\"ActionType\":\"\",\"TerminalTXNNumber\":\"152226\",\"HostSerialNumber\":\"152226\"}" } ``` ### Response ``` { "Header": { "StatusCode": "0000", "StatusDesc": "STATUS_SUCCESS", "Method": "31800", "ServiceType": "Payment", "MchId": "Account0001", "ResponseTime": "20180920152640" }, "Data": { "EZCardID": "949104293", "EZCardType": "00", "PersonalProfile": "00", "CardNumberForPrint": "949104293", "Amount": "1", "Balance": "1917", "BeforeTXNBalance": "1918", "TerminalTXNNumber": "152226", "HostSerialNumber": "152226", "Time": "152226", "Date": "20180920", "ExpiryDate": "20191230", "CPUPurseVersion": "00", "BankCode": "00", "AreaCode": "01", "AutoTopUpAmount": "0", "request": { "Amount": "1", "Retry": "2", "BatchNumber": "18092000", "SameCard": "1", "ServiceType": "Payment", "TerminalID": "08300000", "DeviceID": "01301234", "TerminalTXNNumber": "152226", "HostSerialNumber": "152226", "Time": "152637", "Date": "20180920", "AESKey": "ae83eef....bf18a2644" }, "TXNResult": "Success", "Retry": "0", "ErrorCode": "000000", "OrderId": "PO123456", "DongleDeviceID": "0C100DE0A57E", "RRNumber": "18092015222676", "TXNType": "Payment", "NewAESKey": "b9007bf485....9523d9783", "DeviceNumber": "0830000001301234" } } ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://intella.gitbook.io/scan2pay/api-specification/easycard-api/retry.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.