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.
Parameter | Description | Included |
---|---|---|
orderId | Order ID (orderId ) entered when requesting payment | Always |
transactionId | The 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.
Parameter | Description | Included |
---|---|---|
orderId | Order ID (orderId ) entered when requesting payment | Conditional |
transactionId | The 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