본문으로 건너뛰기

리다이렉션용 페이지

가맹점은 LINE Pay 온라인 API를 사용해 결제를 처리할 때 고객이 LINE Pay 인증을 완료하거나 결제를 취소할 때 고객에게 보여주는 페이지(리다이렉션 URL)를 LINE Pay에 제공해야 합니다.

가맹점이 제공하는 페이지는 모두 신뢰할 수 있는 인증서와 HTTPS 프로토콜(권고)을 사용해야 하며, 인증서는 TLS 1.2 버전 이상이어야 합니다.

만약, 결제 요청 시 redirectUrls.confirmUrl 필드를 SERVER로 설정했다면, 결제 서비스 작동 환경별로 아래와 같은 IP 주소 또는 IP 주소 범위를 접근 허용 목록에 등록해야 합니다.

  • 샌드박스 서버(테스트용): 147.92.159.209, 147.92.159.21, 147.92.159.68, 147.92.216.167
  • 프로덕션 서버(실서비스용): 211.249.40.1~211.249.40.30, 147.92.220.5~147.92.220.8

결제 승인용 페이지​

결제 승인용 페이지는 고객이 결제를 처리하기 위해 LINE Pay 인증을 완료한 후 이동되는 페이지입니다. 결제 승인용 페이지의 URL을 결제를 요청할 때 요청 파라미터 중 본문 redirectUrls.confirmUrl 필드에 명시하세요. 이 페이지가 호출되거나 고객이 이 페이지에서 특정 동작(승인 또는 확인 버튼을 누르는 등)을 하면 결제를 승인해 남은 작업을 진행할 수 있습니다.

LINE Pay 서버는 아래와 같은 조건으로 페이지를 호출합니다.

  • 프로토콜: HTTP
  • 메서드: GET
  • Connection 타임아웃: 5 초
  • Read 타임아웃: 20 초

또한, 호출할 때 아래와 같은 쿼리 파라미터를 함께 전달합니다.

파라미터설명포함 여부
orderId결제를 요청할 때 입력했던 주문 번호(orderId)항상
transactionId결제를 요청한 후 응답으로 받은 결제 트랜잭션 ID(info.transactionId). 트랜잭션 ID는 플랫폼에 따라 문자열로 처리해야 할 수 있습니다. 자세한 설명은 트랜잭션 ID를 참고하세요.항상

결제 승인용 페이지 URL에 위 파라미터를 쿼리 파라미터로 포함시키지 마세요. 위 파라미터는 LINE Pay에 의해 자동으로 추가됩니다. 단, orderId 파라미터의 값은 가맹점에서 관리하는 데이터이므로 이 파라미터가 URL에 포함돼 있다면 나머지 파라미터만 URL에 추가해 페이지를 호출합니다.

다음은 페이지가 요청되는 URL 예입니다.

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

상황에 따라 리다이렉션 URL 정보 없이 결제를 구현할 수도 있습니다. 이때, LINE Pay 서버는 사용자가 LINE Pay 인증을 마치더라도 가맹점 서버로 어떤 HTTP 요청도 보내지 않습니다.

결제 취소용 페이지​

결제 취소용 페이지는 고객이 LINE Pay 인증 과정에서 결제를 취소하면 이동되는 페이지입니다. 결제 취소 페이지 URL은 결제 요청 시 요청 파라미터 중 본문 redirectUrls.cancelUrl 필드에 명시하세요. 결제 취소용 페이지를 이용해 결제가 취소됐음을 고객에게 안내하거나 결제 요청 전 페이지로 이동하게 합니다.

LINE Pay 서버는 아래와 같은 조건으로 페이지를 호출합니다.

  • 프로토콜: HTTP
  • 메서드: GET
  • Connection 타임아웃: 5초
  • Read 타임아웃: 20초

또한, 호출할 때 아래와 같은 쿼리 파라미터를 함께 전달합니다.

파라미터설명포함 여부
orderId결제를 요청할 때 입력했던 주문 번호(orderId)조건부
transactionId결제 요청한 후 응답으로 받은 결제 트랜잭션 ID(info.transactionId). 트랜잭션 ID는 플랫폼에 따라 문자열로 처리해야 할 수 있습니다. 자세한 설명은 트랜잭션 ID를 참고하세요.조건부

결제 취소 페이지 URL에 위 파라미터를 쿼리 파라미터로 포함시키지 마세요. 위 파라미터는 LINE Pay에 의해 자동으로 추가됩니다. 단, orderId 파라미터의 값은 가맹점에서 관리하는 데이터이므로 이 파라미터가 URL에 포함돼 있다면 나머지 파라미터만 URL에 추가해 페이지를 호출합니다.

다음은 페이지가 요청되는 URL 예입니다.

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