Skip to main content

Redirection pages

When using the LINE Pay Online API to process payments, merchants must provide LINE Pay with redirection URLs where customers are directed after completing authentication or canceling a payment.

All pages must use a trusted certificate and the HTTPS protocol (recommended), with support for TLS 1.2 or higher.

If you control access to the pages described here with IP addresses, you need to register the following IP addresses or IP address ranges in your access allowlist for each payment service operating environment.

  • Sandbox server (for tests): 147.92.159.209, 147.92.159.21, 147.92.159.68
  • Production server (for actual service): 211.249.40.1~211.249.40.30, 147.92.220.5~147.92.220.8

Payment confirmation page

The payment confirmation page is where customers are redirected after completing LINE Pay authentication to proceed with the payment process. Specify the URL of this page in the redirectUrls.confirmUrl field in the body of the payment request. Once the customer lands on this page or performs an action on it (e.g., clicking an "approve" or "confirm" button), you can confirm the payment to proceed with the remaining steps.

The LINE Pay server calls the page under the following conditions.

  • Protocol: HTTP
  • Method: GET
  • Connection timeout: 5 seconds
  • Read timeout: 20 seconds

Additionally, the following query parameters are delivered together during the call.

ParameterDescriptionIncluded
orderIdOrder ID (orderId) entered when requesting paymentAlways
transactionIdThe payment transaction ID (info.transactionId) returned in the response. You may need to treat this as a string depending on the platform. See Transaction ID for more details.Always

Do not manually include these parameters in the payment confirmation page URL. LINE Pay will automatically append them. However, since the orderId is managed by the merchant, if it is already embedded in the URL, LINE Pay will only append the remaining parameters when calling the page.

The following is an example of the URL requesting the page.

http://yourdomain.com/path/for/confirm?orderId=2018xxx1232132&trasactionId=201810281234567890

In some cases, you can implement payments without specifying a redirection URL. When doing so, the LINE Pay server does not send any HTTP requests to the merchant server, even after the customer completes LINE Pay authentication.

Payment cancellation page

The payment cancellation page is where customers are redirected when they cancel a payment during the LINE Pay authentication process. Specify this page's URL in the redirectUrls.cancelUrl field of the request body when requesting payment. Use the payment cancellation page to inform customers that the payment was canceled or to redirect them to the page before the payment request.

The LINE Pay server calls the page under the following conditions.

  • Protocol: HTTP
  • Method: GET
  • Connection timeout: 5 seconds
  • Read timeout: 20 seconds

Additionally, the following query parameters are delivered together during the call.

ParameterDescriptionIncluded
orderIdOrder ID (orderId) entered when requesting paymentConditional
transactionIdThe payment transaction ID (info.transactionId) returned in the response. You may need to treat this as a string depending on the platform. See Transaction ID for more details.Conditional

Do not manually include these parameters in the payment confirmation page URL. LINE Pay will automatically append them. However, since the orderId is managed by the merchant, if it is already embedded in the URL, LINE Pay will only append the remaining parameters when calling the page.

The following is an example of the URL requesting the page.

http://yourdomain.com/path/for/cancel?orderId=2018xxx1232132&trasactionId=201810281234567890