본문으로 건너뛰기

리다이렉션용 페이지

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

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

여기서 설명하는 페이지의 접근 제어를 IP 주소로 관리한다면, 결제 서비스 작동 환경별로 아래와 같은 IP 주소 또는 IP 주소 범위를 접근 허용 목록에 등록해야 합니다.

  • 샌드박스 서버(테스트용): 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을 결제를 요청할 때 요청 파라미터 중 본문 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