這次主題帶到了Request API、Confirm API、Capture API、Check Payment Status API,那其實LINE PAY還有提供很多其他的API,這邊就列出額外3隻API功能文件,就沒有實作囉,有興趣可以再自行實作看看喔!
Void API:
本API針對授權階段的交易資料進行無效處理。因此,透過Confirm API完成授權的交易,將會被取消授權 Void API僅對已授權的交易產生影響,如是已請款的交易,需使用Refund API進行退款
API Spec(規格)
Void API 提供的url為:
POST /v3/payments/authorizations/{transactionId}/void
Request Body:
無。
發送API後LINE PAY回應的Response:
Return Codes
Code Description
0000 成功
1101 買家不是LINE Pay的用戶
1102 買方被停止交易
1104 此商家不存在
1105 此商家無法使用LINE Pay
1106 標頭(Header)資訊錯誤
1150 交易記錄不存在
1155 該交易序號有誤
1165 該交易已經被取消授權且無效
1170 使用者帳戶的餘額有變動
1198 API重覆呼叫,或者授權更新過程中,呼叫了CaptureAPI(請幾分鐘後重試一下)
1199 內部請求錯誤
1900 發生暫時錯誤,請稍後重試
1902 發生暫時錯誤,請稍後重試
1999 跟已發出的請求資訊不同
9000 內部錯誤
Refund API:
本 API 用以取消已付款(購買完成)的交易,並可支援部分退款。呼叫時需要帶入該筆付款的 LINE Pay 原始交易序號(transactionId)
API Spec(規格)
Refund API 提供的url為:
POST /v3/payments/{transactionId}/refund
Request Body:
發送API後LINE PAY回應的Response:
Return Codes
Code Description
0000 成功
1101 買家不是LINE Pay的用戶
1102 買方被停止交易
1104 此商家不存在
1105 此商家無法使用LINE Pay
1106 標頭(Header)資訊錯誤
1124 金額有誤(scale)
1150 交易記錄不存在
1155 交易編號不符合退款資格
1163 可退款期限已過無法退款
1164 退款金額超過限制金額
1165 已經退款而關閉的交易
1179 無法處理的狀態
1198 API呼叫重複
1199 內部請求錯誤
1264 一卡通MONEY通相關錯誤
9000 內部錯誤
Payment Details API:
本API查詢LINE Pay中的交易記錄。您可以查詢授權和購買完成狀態的交易。使用"fields"設定,可以按交易或訂單資訊,選擇查出交易記錄。
API Spec(規格)
Payment Details API 提供的url為:
POST /v3/payments
Request Parameter:
發送API後LINE PAY回應的Response:
Return Codes
Code Description
0000 成功
1104 此商家不存在
1105 此商家無法使用 LINE Pay
1106 標頭(Header)資訊錯誤
1150 交易記錄不存在
1177 超過允許查詢的交易數目 (100筆)
9000 內部錯誤
LINE PAY官方文件:https://pay.line.me/th/developers/apis/onlineApis?locale=zh_TW
這邊補充額外3隻非必要但蠻有趣的API給大家,有興趣的話可以再自行去玩看看喔!