리디렉션 구성 방법

결제 완료 후 사용자를 다른 페이지로 리디렉션하는 용으로 구성할 수 있는 두 가지 유형의 리디렉션:

  • 자동 — 설정된 지연 시간 안의 리디렉션.
  • 수동 — 사용자가 결제 UI를 닫거나 리디렉션 버튼을 클릭한 후의 리디렉션.

알림
여러 결제 상태용으로 여러 유형의 리디렉션을 구성할 수 있습니다.

자동 리디렉션 구성

자동 리디렉션 구성 방법:

  • 관리자 페이지에서
  • API 이용
  • 주의
    API를 통해 전달된 리디렉션 구성은 관리자 페이지에서 설정된 것보다 우선순위를 갖습니다.

    관리자 페이지에서 자동 리디렉션 구성

    1. 관리자 페이지에서 프로젝트를 열고 페이 스테이션 > 설정 > 리디렉션 정책으로 이동합니다.

    1. 반환 URL 필드에서 결제 후 사용자가 리디렉션될 URL 주소 또는 경로를 입력합니다.
    2. 드롭다운 목록에서 자동 리디렉션 조건을 선택합니다.
      • 없음 — 리디렉션하지 않습니다.
      • 결제 성공 — 결제가 성공적일 때 리디렉션합니다.
      • 결제 성공 또는 취소됨 — 결제가 성공적이거나 취소되었을 때 리디렉션합니다.
      • 모든 결제 — 모든 결제 상태에서 리디렉션합니다.
    3. 지연 필드에서 초 단위의 리디렉션 타임아웃을 입력합니다.
    4. 저장을 클릭합니다.

    주의
    기본적으로 리디렉션은 0초 안에 활성화됩니다.

    API를 통한 자동 리디렉션 구성

    리디렉션 구성은 토큰 생성 엔드포인트의 return_url 매개 변수 및 redirect_policy 매개 변수 그룹에서 지정되었습니다.

    1. return_url 매개 변수에서 결제 후 사용자가 리디렉션될 URL 주소 또는 경로를 전달합니다.
    2. autoredirect_from_status_page 매개 변수를 true로 설정합니다.
    3. delay 매개 변수에서 초 단위의 리디렉션 타임아웃을 전달합니다.
    4. redirect_conditions 매개 변수에서 리디렉션이 활성화되었을 때의 조건을 전달합니다.
      • none — 리디렉션하지 않습니다.
      • successful — 결제가 성공적일 때 리디렉션합니다.
      • successful_or_canceled — 결제가 성공적이거나 최소되었을 때 리디렉션합니다.
      • any — 모든 결제 상태에서 리디렉션합니다.

    다음 GET 매개변수가 링크에 자동으로 추가됩니다.

    • user_id - 사용자 ID
    • foreigninvoice - external_id 매개변수에서 전달된 트랜잭션 ID
    • invoice_id - 트랜잭션 ID
    • status - 트랜잭션 상태

    수동 리디렉션 구성

    수동 리디렉션 구성 방법:

    주의
    API를 통해 전달된 리디렉션 구성은 관리자 페이지에서 설정된 것보다 우선순위를 갖습니다.

    관리자 페이지에서 수동 리디렉션 구성

    1. 관리자 페이지에서 프로젝트를 열고 페이 스테이션 > 설정 > 리디렉션 정책으로 이동합니다.

    1. 반환 URL 필드에서 사용자가 결제 후 리디렉션될 URL 주소 또는 경로를 입력합니다.
    2. 드롭다운 목록에서 자동 리디렉션 조건을 선택합니다.
      • 없음 — 리디렉션하지 않습니다.
      • 결제 성공 — 결제가 성공적일 때 리디렉션합니다.
      • 결제 성공 또는 취소됨 — 결제가 성공적이거나 취소되었을 때 리디렉션합니다.
      • 모든 결제 — 모든 결제 상태에서 리디렉션합니다.
    3. 지연 필드를 비워둡니다.
    4. 수동 리디렉션 조건 드롭다운 목록에서 리디렉션 버튼이 표시될 때의 결제 상태를 선택합니다.
    5. 리디렉션 버튼 캡션 필드에서 반환 URL로 사용자를 리디렉션할 버튼 사본을 입력합니다.
    6. 저장을 클릭합니다.

    주의

    기본적으로 리디렉션 버튼 사본은 게임으로 돌아가기입니다. 이는 모든 페이 스테이션 언어로 현지화되어 있습니다.

    귀하의 프로젝트가 여러 언어를 지원한다면 각각의 필드에 각 언어용으로 리디렉션 버튼 사본을 입력할 수 있습니다.

    사용자 역시 결제 UI를 닫으면 지정된 반환 URL로 리디렉션 됩니다.

    API를 통한 수동 리디렉션 구성

    리디렉션 구성은 토큰 생성 엔드포인트의 return_url 매개 변수 및 redirect_policy 매개 변수 그룹에서 지정되었습니다.

    1. return_url 매개 변수에서 결제 후 사용자가 리디렉션될 URL 주소 또는 경로를 전달합니다.
    2. redirect_conditions 매개 변수에서 리디렉션이 활성화되었을 때의 조건을 전달합니다.
      • none — 리디렉션하지 않습니다.
      • successful — 결제가 성공적일 때 리디렉션합니다.
      • successful_or_canceled — 결제가 성공적이거나 취소되었을 때 리디렉션합니다.
      • any — 모든 결제 상태에서 리디렉션합니다.
    3. manual_redirection_action 매개 변수에서 사용자의 닫기 버튼 또는 반환 버튼 클릭으로 트리거된 결제 UI 행동을 전달합니다.
      • redirect(기본) — 사용자가 반환 URL로 리디렉션됩니다.
      • postmessage — 닫기 아이콘 클릭은 close-widget 이벤트 전송을 시작하게 하며 반환 버튼 클릭은 return 이벤트 전송을 시작하게 합니다. 이러한 경우 사용자는 반환 URL로 리디렉션되지 않습니다. 결제 UI 닫기 또는 리디렉션용 이벤트 처리를 구성해야 합니다.
    4. redirect_button_caption 매개 변수에서 사용자를 반환 URL로 리디렉션할 버튼 사본을 전달합니다.
    5. status_for_manual_redirection 매개 변수에 리디렉션 버튼이 표시될 때의 결제 상태를 전달합니다.
      • none — 리디렉션하지 않습니다.
      • successful — 결제가 성공적일 때 리디렉션합니다.
      • successful_or_canceled — 결제가 성공적이거나 취소되었을 때 리디렉션합니다.
      • any — 모든 결제 상태에서 리디렉션합니다.

    다음 GET 매개변수가 링크에 자동으로 추가됩니다.

    • user_id - 사용자 ID
    • foreigninvoice - external_id 매개변수에서 전달된 트랜잭션 ID
    • invoice_id - 트랜잭션 ID
    • status - 트랜잭션 상태

    주의
    결제 UI가 iframe에서 열렸고 ui.desktop.header.close_button 매개 변수가 true로 설정되었다면 postmessage 이벤트만 사용자가 닫기 아이콘을 클릭했을 때 전송됩니다. 이는 귀하가 이벤트를 처리하고 결제 UI를 닫을 수 있게 해 주며 사용자는 결제를 시작한 페이지에 머무를 수 있습니다.

    리디렉션 구성 예시

    예시 1

    관리자 페이지의 같은 프로젝트를 여러 플랫폼의 결제 처리에 사용한다면 브라우저에서 처리된 결제용 기본 리디렉션과 모바일 장치용으로 맞춤 설정된 리디렉션을 구성할 수 있습니다.

    기본 리디렉션을 구성하려면 return_url 매개 변수에서 결제 후 사용자가 리디렉션 될 URL 주소 또는 경로를 전달합니다. 3초 지연된 맞춤 설정된 자동 리디렉션은 다음과 같습니다.

    Copy
    Full screen
    Small screen

      {
          "redirect_policy": {
          "redirect_conditions": "successful",
          "autoredirect_from_status_page": true,
          "delay": 3
        }
      }

      예시 2

      웹 사이트에서 아이템을 판매하면서 게임 런처도 이용한다면 관리자 페이지에서 웹 사이트용 리디렉션을 구성하고 토큰에서 런처용 리디렉션 구성을 맞춤 설정할 수 있습니다.

      Copy
      Full screen
      Small screen

        {
          "redirect_policy": {
            "redirect_conditions": "successful_or_canceled",
            "status_for_manual_redirection": "successful_or_canceled",
            "manual_redirection_action": "postmessage"
          }
        }

        이 기사가 도움이 되었나요?
        감사합니다!
        개선해야 할 점이 있을까요? 메시지
        유감입니다
        이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
        의견을 보내 주셔서 감사드립니다!
        메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
        이 페이지 평가
        이 페이지 평가
        개선해야 할 점이 있을까요?

        답하기 원하지 않습니다

        의견을 보내 주셔서 감사드립니다!
        마지막 업데이트: 2023년 10월 10일

        오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.

        문제 보고
        콘텐츠를 항상 검토합니다. 여러분의 피드백은 콘텐츠를 개선에 도움이 됩니다.
        후속 조치를 위해 이메일을 제공해 주세요
        의견을 보내 주셔서 감사드립니다!