리디렉션 구성 방법

개요

결제를 완료한 사용자를 다른 페이지로 리디렉션하려면 관리자 페이지 또는 API를 통해 리디렉션을 구성할 수 있습니다. 결제 상태(결제 성공 또는 취소)에 따라 다음과 같이 리디렉션을 구성할 수 있습니다:

• 자동 — 설정된 지연 시간에 리디렉션.
• 수동 — 사용자가 리디렉션 버튼을 클릭한 후 적용되는 리디렉션.

자동 리디렉션과 수동 리디렉션을 동시에 구성할 수 있습니다. 사용자는 여전히 리디렉션 버튼을 클릭하여 애플리케이션으로 돌아갈 수 있습니다. 버튼을 클릭하지 않아도 설정된 지연 시간이 끝나면 자동으로 리디렉션됩니다.

• user_id - 사용자 ID
• foreigninvoice - external_id 매개 변수에서 전달된 트랜잭션 ID
• invoice_id - 트랜잭션 ID
• status - 트랜잭션 상태. 다음 값일 수 있습니다.

사용자가 리디렉션되는 URL의 예시: {Return URL}?user_id=[value]&foreignInvoice=[value]&invoice_id=[value]&status=done

사용자가 결제를 완료하기 전에 결제 UI 탭을 닫으면 {Return URL}?user_id=[value]&invoice_id= 형식으로 지정된 리디렉션 URL로 리디렉션됩니다. 페이 스테이션 임베드로 결제 UI가 열리면 결제 UI를 닫을 때 위젯이 닫히고 사용자가 게임으로 돌아가게 됩니다.

자동 리디렉션 구성

자동 리디렉션 구성 방법:

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

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

2. 반환 URL 필드에 결제 후 사용자가 리디렉션되는 URL 주소 또는 경로(딥 링크)를 입력합니다. 사용자가 게임 모바일 애플리케이션에서 결제 UI를 열 때의 사용자 경험을 개선하려면 딥 링크를 반환 URL로 지정하는 것이 좋습니다.
3. 드롭다운 목록에서 자동 리디렉션 조건을 선택합니다.
   • 없음 - 리디렉션하지 않음
   • 결제 성공 - 결제에 성공하면 리디렉션
   • 결제 성공 또는 취소 - 결제 성공 또는 취소 시 리디렉션
   • 모든 결제 - 모든 결제 상태에 대해 리디렉션
4. 지연 필드에서 리디렉션 제한 시간을 초 단위로 입력합니다.기본적으로 리디렉션은 0초 후에 활성화됩니다.
5. 리디렉션 버튼을 추가하지 않고 자동 리디렉션만 구성하려면 수동 리디렉션 조건 드롭다운 목록에서 없음 - 리디렉션하지 않음을 선택합니다.
6. 저장을 클릭합니다.

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

리디렉션을 구성하려면 토큰 생성 API 호출에서 다음 데이터를 전달합니다.

• settings.return_url - 결제 후 사용자가 리디렉션되는 URL 주소 또는 경로(딥 링크)입니다. 사용자가 게임 모바일 애플리케이션에서 결제 UI를 열 때의 사용자 경험을 개선하려면 딥 링크를 반환 URL로 지정하는 것이 좋습니다.
• settings.redirect_policy.redirect_conditions - 리디렉션 조건:
  • none - 리디렉션하지 않음
  • successful - 결제에 성공하면 리디렉션
  • successful_or_canceled - 결제 성공 또는 취소 시 리디렉션
  • any - 모든 결제 상태에 대해 리디렉션
• settings.redirect_policy.delay - settings.return_url 매개 변수에서 전달한 URL로 리디렉션이 활성화되는 시간(초)입니다. 기본적으로 리디렉션은 0초 후에 활성화됩니다.

수동 리디렉션 구성

수동 리디렉션 구성 방법:

• 관리자 페이지에서
• API 이용

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

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

1. 반환 URL 필드에 결제 후 사용자가 리디렉션되는 URL 주소 또는 경로(딥 링크)를 입력합니다. 사용자가 게임 모바일 애플리케이션에서 결제 UI를 열 때의 사용자 경험을 개선하려면 딥 링크를 반환 URL로 지정하는 것이 좋습니다.
2. 수동 리디렉션만 구성하려면 자동 리디렉션 조건 드롭다운 목록에서 없음 - 리디렉션하지 않음을 선택합니다.
3. 지연 필드는 비워 둡니다.
4. 수동 리디렉션 조건 드롭다운 목록에서 리디렉션 버튼이 나타날 때의 결제 상태를 선택합니다.
   • 없음 - 리디렉션하지 않음
   • 결제 성공 - 결제 성공 시 리디렉션
   • 결제 성공 또는 취소 - 결제 성공 또는 취소 시 리디렉션
   • 모든 결제 - 모든 결제 상태에 대해 리디렉션
5. 리디렉션 버튼 캡션 필드에서 사용자를 반환 URL로 리디렉션할 버튼의 사본을 입력합니다.
6. 저장을 클릭합니다.

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

리디렉션을 구성하려면 토큰 생성 API 호출에서 다음 데이터를 전달합니다.

• settings.return_url - 결제 후 사용자가 리디렉션되는 URL 주소 또는 경로(딥 링크)입니다. 사용자가 게임 모바일 애플리케이션에서 결제 UI를 열 때의 사용자 경험을 개선하려면 딥 링크를 반환 URL로 지정하는 것이 좋습니다.
• settings.redirect_policy.manual_redirection_action - 사용자가 닫기 버튼 또는 반환 버튼을 클릭하여 트리거되는 결제 UI 동작:
  • redirect(기본값) - 사용자가 반환 URL로 리디렉션됩니다.
  • postmessage - 닫기 아이콘을 클릭하면 close-widget 이벤트 전송이 시작되고 반환 버튼을 클릭하면 return 이벤트가 발생합니다. 이 경우 사용자는 반환 URL로 리디렉션되지 않습니다. 결제 UI를 닫거나 리디렉션하려면 이벤트 처리를 구성해야 합니다. 이 설정은 API를 사용할 때만 사용할 수 있습니다.
• settings.redirect_policy.redirect_button_caption - 사용자를 반환 URL로 리디렉션하게 될 버튼의 복사본입니다.
• settings.redirect_policy.status_for_manual_redirection - 리디렉션 버튼이 나타날 때의 결제 상태:
  • none - 리디렉션하지 않음
  • successful - 결제 성공 시 리디렉션합
  • successful_or_canceled - 결제 성공 또는 취소 시 리디렉션
  • any - 모든 결제 상태에 대해 리디렉션

리디렉션 구성 예시

관리자 페이지에서 3초 지연으로 자동 리디렉션을 구성했습니다. 이 동작은 모바일 및 데스크톱 버전의 결제 UI에 모두 적용됩니다. 관리자 페이지에서 설정한 구성은 다음과 같습니다.

게임의 모바일 애플리케이션에서 결제 UI를 열기 위한 설정을 업데이트해야 하는 경우, 즉 리디렉션 버튼을 추가하고 반환 URL로 딥 링크를 지정하려면 토큰에서 전달된 설정을 업데이트해야 합니다.

{
    "user": {
        "country": {
            "value": "US"
        },
        "id": {
            "value": "1234abCd"
        },
        "name": {
            "value": "John Smith"
        }
    },
    "settings": {
        "currency": "USD",
        "project_id": 123456,
        "language": "en",
        "return_url": "myapp://payment/successful",
        "ui": {
            "desktop": {
                "header": {
                    "visible_logo": true
                }
            }
        },
        "redirect_policy": {
            "redirect_conditions": "any",
            "redirect_button_caption": "Back to Store",
            "manual_redirection_action": "redirect",
            "status_for_manual_redirection": "any"
        },
        "external_id": "1a2b3c"
    },
    "custom_parameters": {
        "timestamp": 1234512345123,
        "sku": "testSKU",
        "amount": "10"
    },
    "purchase": {
        "virtual_items": {
            "items": [
                {
                    "sku": "testSKU",
                    "amount": 1
                }
            ]
        }
    }
}