重定向頁面
合作商店需向LINE Pay提供使用LINE Pay Online API處理付款時,顧客完成LINE Pay認證或取消付款時顯示給顧客的頁面(confirmURL)。
商家提供的所有頁面必須使用受信任的憑證和HTTPS協定(建議),且憑證必須為TLS 1.2或更高版本。
如果此處所述的頁面的登錄控制是透過IP地址管理,則必須在每個付款服務作業環境的登錄允許清單中註冊以下IP位址或IP位址範圍。
- Sandbox伺服器(用於測試):
147.92.159.209
、147.92.159.21
、147.92.159.68
- 正式伺服器(用於實際服務):
211.249.40.1
~211.249.40.30
,147.92.220.5
~147.92.220.8
付款授權頁面
付款授權頁面是顧客為進行付款,在執行LINE Pay認證後跳轉到的頁面。請求付款授權頁面的URL進行付款請求時,請指定請求參數中body redirectUrls.confirmUrl
的欄位。呼叫此頁面或顧客在此頁面執行特定操作(點擊授權或確定等),可以授權付款進行剩餘操作。
LINE Pay伺服器在以下條件下呼叫該頁面。
- 協定: HTTP
- 方法:GET
- Connection逾時:5 秒
- Read逾時:20 秒
另外,當呼叫時,下面的查詢參數會一起傳遞。
參數 | 描述 | 是否包含 |
---|---|---|
orderId | 請求付款時輸入的訂單號碼(orderId ) | 始終 |
transactionId | 請求付款後,收到的付款交易 ID回應(info.transactionId )。根據平台的不同,交易ID可能需要被視為字串。詳細說明請參考交易ID (transaction ID)。 | 始終 |
請勿將上述參數作為查詢參數包含在付款授權頁面URL中。上述參數由LINE Pay自動新增。但是,
orderId
的值是由合作商店管理的數據,因此如果若該參數包含在URL中,則只能將剩餘參數增加到URL並且呼叫頁面。
以下是請求頁面的URL範例:
http://yourdomain.com/path/for/confirm?orderId=2018xxx1232132&trasactionId=201810281234567890
根據情況,也可以執行無confirmURL訊息付款。這時,即使顧客完成了LINE Pay認證,也不會向合作商店伺服器發送任何 HTTP 請求。
付款取消頁面
付款取消頁面是是顧客在執行LINE Pay認證過程中取消付款時進入的頁面。提出付款請求時,請在請求參數中的redirectUrls.cancelUrl
欄位中指定付款取消頁面URL。
使用付款取消頁面通知顧客付款已被取消或將他們引導至付款請求之前的頁面。
LINE Pay伺服器在以下條件下呼叫該頁面。
- 協定: HTTP
- 方法:GET
- Connection逾時:5秒
- Read逾時:20 秒
另外,當呼叫時,下面的查詢參數會一起傳遞。
參數 | 描述 | 是否包含 |
---|---|---|
orderId | 請求付款時輸入的訂單號碼(orderId ) | 有條件 |
transactionId | 請求付款後,收到的付款交易 ID回應(info.transactionId )。根據平台的不同,交易ID可能需要被視為字串。詳細說明請參考交易ID (transaction ID)。 | 有條件 |
請勿將上述參數作為查詢參數包含在付款取消頁面URL中。上述參數由LINE Pay自動新增。但是,
orderId
的值是由合作商店管理的數據,因此如果若該參數包含在URL中,則只能將剩餘參數增加到URL並且呼叫頁面。
以下是請求頁面的URL範例:
http://yourdomain.com/path/for/cancel?orderId=2018xxx1232132&trasactionId=201810281234567890