API change log

本頁提供LINE Pay API的變更日誌，從最近的更新開始列出。

2025年11月

在台灣，由主管機關許可經營「代理收付實質交易款項」、「收受儲值款項」、「辦理國內外小額匯兌」等業務的業者被稱為電子支付機構（EPI），並且均受到《電子支付機構管理條例》在法律和制度上的規範。根據此，除了現有的Online API v3與Offline API v2之外，下列API已加入：

• Online API v4
• Offline API v4
• Offline API v2.4

若只想在Offline API v2中套用與EPI相關的變更，請使用Offline API v2.4。若要在Offline API v2中使用Offline API v4，則必須變更認證方式。詳細說明請參考事前準備。

LINE Pay提供新的v2.4及v4 API，主要目的是讓商家在交易完成的當下，透過API結果得知該交易將由哪間公司清算及撥款：

• "TSP": 第三方支付公司,即現行提供LINE Pay台灣服務的公司
• "EPI": 電子支付機構

如果商家在交易過程中，不需要即時從交易結果得知清算及撥款單位的話，可繼續使用既有的API。

從現在開始(May 2025)，新版API皆可以在sandbox環境中測試規格。但是sandbox環境的線上交易流程並不支援模擬EPI交易,所以Online API中的paymentProvider會固定回傳"TSP"。

如果想測試為EPI的交易，請使用以下提供的我的條碼產生器。

• EPI的信用卡條碼
  • https://sandbox-web-pay.line.me/web/sandbox/payment/oneTimeKey?countryCode=TW&paymentMethod=card&preset=18
• EPI的帳戶條碼
  • https://sandbox-web-pay.line.me/web/sandbox/payment/oneTimeKey?countryCode=TW&paymentMethod=balance&preset=3

以下是每個API的更新摘要：

• Online API v4改動
• Offline API v4改動
• Offline API v2.4改動

Online API v4改動

• 為提供EPI資訊、新增info.paymentProvider欄位於以下API的回應主體內：
  • 付款授權(POST /v4/payments/{transactionId}/confirm)
  • 請款(POST /v4/payments/authorizations/{transactionId}/capture)
  • 查詢付款明細(GET /v4/payments)
  • 預先授權付款請求(POST /v4/payments/preapprovedPay/{regKey}/payment)
• 付款請求(POST /v4/payments/request)的請求主體新增與預先授權付款相關的options.regPayRequest欄位。

Offline API v4改動

• 在HTTP請求標頭中應用了新的認證方法(HMAC)（與Online API v3、v4 相同）。
• 移除驗證伺服器允許的清單(allowlist)的設定。
• 付款請求(POST /v4/payments/oneTimeKeys/pay)API的請求主體欄位改變。
• 為提供EPI資訊、新增info.paymentProvider欄位於以下API的回應主體內：
  • 付款請求(POST /v4/payments/oneTimeKeys/pay)
  • 查詢付款狀態(GET /v4/payments/orders/{orderId}/check)
  • 查詢授權訊息(GET /v4/payments/authorizations)
  • 請款(POST /v4/payments/orders/{orderId}/capture)
  • 查詢付款明細(GET /v4/payments)

Offline API v2.4改動

• 為提供EPI資訊、新增info.paymentProvider欄位於以下API的回應主體內：
  • 付款請求(POST /v2.4/payments/oneTimeKeys/pay)
  • 查詢付款狀態(GET /v2.4/payments/orders/{orderId}/check)
  • 查詢授權訊息(GET /v2.4/payments/authorizations)
  • 請款(POST /v2.4/payments/orders/{orderId}/capture)
  • 查詢付款明細(GET /v2.4/payments)

2025年5月

由於LINE Pay日本服務的終止，下列內容已被移除：

• 僅限日本使用的Deposit API不再提供。
• Online API與Offline API中，與部分日本專用欄位相關的說明也不再提供。