iT邦幫忙

2023 iThome 鐵人賽

DAY 29
0

這次主題帶到了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
https://ithelp.ithome.com.tw/upload/images/20230929/20160220DdR7APceGI.png
Request Body:
無。
發送API後LINE PAY回應的Response:
https://ithelp.ithome.com.tw/upload/images/20230929/20160220rK1kyKvg9C.png
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	內部錯誤

https://ithelp.ithome.com.tw/upload/images/20230929/201602205irijHnGhX.png
Refund API:
本 API 用以取消已付款(購買完成)的交易,並可支援部分退款。呼叫時需要帶入該筆付款的 LINE Pay 原始交易序號(transactionId)
API Spec(規格)
Refund API 提供的url為:
POST /v3/payments/{transactionId}/refund
https://ithelp.ithome.com.tw/upload/images/20230929/20160220GFjI1VOIR2.png
Request Body:
https://ithelp.ithome.com.tw/upload/images/20230929/20160220KAWZyYIw7A.png
發送API後LINE PAY回應的Response:
https://ithelp.ithome.com.tw/upload/images/20230929/20160220kbcVTJLPOX.png
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
https://ithelp.ithome.com.tw/upload/images/20230929/20160220hrGtVd9qXE.png
Request Parameter:
https://ithelp.ithome.com.tw/upload/images/20230929/201602207O7O77r2q7.png
發送API後LINE PAY回應的Response:
https://ithelp.ithome.com.tw/upload/images/20230929/20160220FiQbXlEp4S.png
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給大家,有興趣的話可以再自行去玩看看喔!


上一篇
Day28 - 使用RestTemplate 發送API!(補充)
下一篇
Day30 – LINE PAY APIs總結!
系列文
就算是初學者也能實作成功的使用java + spring 實現串接Line Pay APIs!30
圖片
  直播研討會
圖片
{{ item.channelVendor }} {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言