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

자동 리디렉션과 수동 리디렉션을 동시에 구성할 수 있습니다. 사용자는 여전히 리디렉션 버튼을 클릭하여 애플리케이션으로 돌아갈 수 있습니다. 버튼을 클릭하지 않아도 설정된 지연 시간이 끝나면 자동으로 리디렉션됩니다.
제한 사항:
- API를 통해 전달된 리디렉션 구성은 관리자 페이지에서 설정한 구성보다 우선합니다.
- 자동 리디렉션 구성은 수동 리디렉션에 설정한 구성보다 우선합니다. 예를 들어, 수동 리디렉션과 지연 시간이 0초인 자동 리디렉션이 모두 결제 성공에 대해 구성되어 있는 경우 자동 리디렉션이 수행됩니다.
- 토큰에 settings.ui.mode: “user_account” 매개 변수를 전달하려는 경우, 리디렉션 버튼이 결제 UI에 표시되지 않습니다. 결제 수단을 저장한 후 사용자를 리디렉션하려면 자동 리디렉션을 구성해야 합니다.
GET 매개 변수가 사용자가 리디렉션되는 URL에 자동으로 추가됩니다.user_id- 사용자 ID.foreigninvoice- external_id 매개 변수에서 전달된 트랜잭션 ID.invoice_id- 트랜잭션 ID.status- 트랜잭션 상태. 다음 값일 수 있습니다.
| 트랜잭션 상태 | 설명 |
|---|---|
done | 결제가 성공적으로 완료되었습니다. |
invoice | 결제에 대한 인보이스가 생성되었습니다. |
delivering | 엑솔라 측에서 결제를 차리하고 있습니다. |
troubled | 결제를 처리하는 동안 또는 환불을 처리하는 동안 오류가 발생했습니다. |
full_change | 결제가 엑솔라 잔액으로 진행됐습니다. |
사용자가 리디렉션되는 URL의 예시: {Return URL}?user_id=[value]&foreignInvoice=[value]&invoice_id=[value]&status=done
사용자가 결제를 완료하기 전에 결제 UI 탭을 닫으면 {Return URL}?user_id=[value]&invoice_id= 형식으로 지정된 리디렉션 URL로 리디렉션됩니다. 페이 스테이션 임베드로 결제 UI가 열리면 결제 UI를 닫을 때 위젯이 닫히고 사용자가 게임으로 돌아가게 됩니다.
자동 리디렉션 구성
자동 리디렉션 구성 방법:
관리자 페이지에서 자동 리디렉션 구성
- 관리자 페이지에서 프로젝트를 열고 결제 > 결제 인터페이스 > 일반 설정 섹션으로 이동합니다.
- 리디렉션 정책 섹션으로 이동합니다.
- 반환 URL 입력란에 사용자가 결제 후 리디렉션되는 URL 주소 또는 경로(딥 링크)를 입력합니다. 사용자가 게임 모바일 애플리케이션에서 결제 UI를 열었을 때 사용자 경험을 개선하려면 딥 링크를 반환 URL로 지정하는 것이 좋습니다.
- 드롭다운 목록에서 자동 리디렉션 조건을 선택합니다:
- 없음 - 리디렉션되지 않음.
- 결제 성공 - 결제가 성공하면 리디렉션됨.
- 결제 성공 또는 취소 - 결제가 성공하거나 취소되면 리디렉션됨.
- 모든 결제 - 모든 결제 상태의 경우 리디렉션됨.
- 지연 입력란에 리디렉션 제한 시간(초)을 입력합니다. 기본적으로 리디렉션은 0초 후에 활성화됩니다.
- 리디렉션 버튼을 추가하지 않고 자동 리디렉션만 구성하려는 경우, 수동 리디렉션 조건 드롭다운 목록에서, 없음 - 리디렉션하지 않음을 선택하십시오.
- 변경 사항 저장을 클릭합니다.
API를 통한 자동 리디렉션 구성
리디렉션을 구성하려면 토큰 생성 API 호출에서 다음 데이터를 전달합니다.
| 매개 변수 | 설명 |
|---|---|
settings.return_url | 결제 후 사용자를 리디렉션하는 URL 주소 또는 경로(딥 링크)입니다. 사용자가 게임 모바일 애플리케이션에서 결제 UI를 열었을 때 사용자 경험을 개선하려면 딥 링크를 반환 URL로 지정하는 것이 좋습니다. |
settings.redirect_policy.redirect_conditions | 리디렉션 조건:
|
settings.redirect_policy.delay | settings.return_url 매개 변수에 전달된 URL로의 리디렉션이 활성화될 때의 시간 제한(초)입니다. 기본적으로 리디렉션은 0초 후에 활성화됩니다. |
수동 리디렉션 구성
수동 리디렉션 구성 방법:
관리자 페이지에서 수동 리디렉션 구성
- 관리자 페이지에서 프로젝트를 열고 결제 > 결제 인터페이스 > 일반 설정 섹션으로 이동합니다.
- 리디렉션 정책 섹션으로 이동합니다.
- 반환 URL 입력란에 사용자가 결제 후 리디렉션되는 URL 주소 또는 경로(딥 링크)를 입력합니다. 사용자가 게임 모바일 애플리케이션에서 결제 UI를 열었을 때 사용자 경험을 개선하려면 딥 링크를 반환 URL로 지정하는 것이 좋습니다.
- 수동 리디렉션만 구성하려면 자동 리디렉션 조건 드롭다운 목록에서 없음 - 리디렉션되지 않음을 선택하십시오.
- 지연 입력란을 빈 상태로 남겨두세요.
- 수동 리디렉션 조건운 목록에서 리디렉션 버튼이 표시될 때 결제 상태를 다음과 같이 선택합니다:
- 없음 - 리디렉션되지 않음.
- 결제 성공 - 결제가 성공하면 리디렉션됨.
- 결제 성공 또는 취소 - 결제가 성공하거나 취소되면 리디렉션됨.
- 모든 결제 - 모든 결제 상태의 경우 리디렉션됨.
- 리디렉션 버튼 캡션 입력란에 사용자를 반환 URL로 리디렉션할 버튼의 사본을 입력합니다.
- 변경 사항 저장을 클릭합니다.
기본적으로 리디렉션 버튼 사본은 게임으로 돌아가기입니다. 이는 모든 페이 스테이션 언어로 현지화되어 있습니다.
귀하의 프로젝트가 여러 언어를 지원한다면 각각의 필드에 각 언어용으로 리디렉션 버튼 사본을 입력할 수 있습니다.
사용자 역시 결제 UI를 닫으면 지정된 반환 URL로 리디렉션 됩니다.
API를 통한 수동 리디렉션 구성
리디렉션을 구성하려면 토큰 생성 API 호출에서 다음 데이터를 전달합니다.
| 매개 변수 | 설명 |
|---|---|
settings.return_url | 결제 후 사용자를 리디렉션하는 URL 주소 또는 경로(딥 링크)입니다. 사용자가 게임 모바일 애플리케이션에서 결제 UI를 열었을 때 사용자 경험을 개선하려면 딥 링크를 반환 URL로 지정하는 것이 좋습니다. |
settings.redirect_policy.manual_redirection_action | 닫기 버튼 또는 돌아가기 버튼을 클릭하여 사용자가 트리거하는 결제 UI 동작:
|
settings.redirect_policy.redirect_button_caption | 사용자를 반환 URL로 리디렉션하는 버튼의 사본입니다. |
settings.redirect_policy.status_for_manual_redirection | 리디렉션 버튼이 표시될 때의 결제 상태:
|
settings.ui.desktop.header.close_button 매개 변수가 true로 설정되었다면 postmessage 이벤트만 사용자가 닫기 아이콘을 클릭했을 때 전송됩니다. 이는 귀하가 이벤트를 처리하고 결제 UI를 닫을 수 있게 해 주며 사용자는 결제를 시작한 페이지에 머무를 수 있습니다.리디렉션 구성 예시
관리자 페이지에서 3초 지연으로 자동 리디렉션을 구성했습니다. 이 동작은 모바일 및 데스크톱 버전의 결제 UI에 모두 적용됩니다. 관리자 페이지에서 설정한 구성은 다음과 같습니다.
게임의 모바일 애플리케이션에서 결제 UI를 열기 위한 설정을 업데이트해야 하는 경우, 즉 리디렉션 버튼을 추가하고 반환 URL로 딥 링크를 지정하려면 토큰에서 전달된 설정을 업데이트해야 합니다.
| 매개 변수 | 값 |
|---|---|
settings.return_url | 사용자를 게임 애플리케이션으로 리디렉션하는 딥 링크입니다. |
settings.redirect_policy.redirect_conditions | any |
settings.redirect_policy.manual_redirection_action | redirect |
settings.redirect_policy.redirect_button_caption | 리디렉션 버튼의 사본입니다. |
- json
1{
2 "user": {
3 "country": {
4 "value": "US"
5 },
6 "id": {
7 "value": "1234abCd"
8 },
9 "name": {
10 "value": "John Smith"
11 }
12 },
13 "settings": {
14 "currency": "USD",
15 "project_id": 123456,
16 "language": "en",
17 "return_url": "myapp://payment/successful",
18 "ui": {
19 "desktop": {
20 "header": {
21 "visible_logo": true
22 }
23 }
24 },
25 "redirect_policy": {
26 "redirect_conditions": "any",
27 "redirect_button_caption": "Back to Store",
28 "manual_redirection_action": "redirect",
29 "status_for_manual_redirection": "any"
30 },
31 "external_id": "1a2b3c"
32 },
33 "custom_parameters": {
34 "timestamp": 1234512345123,
35 "sku": "testSKU",
36 "amount": "10"
37 },
38 "purchase": {
39 "virtual_items": {
40 "items": [
41 {
42 "sku": "testSKU",
43 "amount": 1
44 }
45 ]
46 }
47 }
48}
오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.