소비자 간 직접 결제 (D2C) 제공업체 워크플로 통합

이 워크플로에 따라 D2C 결제 제공업체를 인앱 구매 (IAP)와 통합하여 IAP 상품을 사용자에게 제공하고 판매하는 방법과 위치를 제어할 수 있습니다.

읽는 시간 2분

최근 업데이트: 11일 전

이 가이드는 D2C 결제 제공업체를 Unity IAP(인앱 구매)와 연동하기 위한 종합적인 워크플로를 간략하게 설명합니다. 워크플로는 Unity Dashboard를 통해 스토어를 구성하는 방법부터 필요한 클라이언트 측 및 서버 측 로직을 구현하는 방법까지 플랫폼 외 거래를 용이하게 하는 데 필요한 필수 단계에 대해 설명합니다. 이 순서를 따라 플레이어에게 일관된 구매 환경을 제공할 수 있으며, UGS(Unity Gaming Services) 환경과 선택한 결제 게이트웨이 간에 안전한 커뮤니케이션을 유지할 수 있습니다. 이 연동은 MoR(레코드 판매자) 역할을 하는 D2C 결제 제공업체를 사용합니다. 즉, 결제 제공업체는 세금 준수 지원, 부정 행위 방지, 분쟁, 고객 지원 등을 포함하여 결제 처리에 대한 법적 책임을 져야 합니다. 결제 제공업체를 MoR로 활용하면 오프 플랫폼 거래의 운영 오버헤드와 규정 준수 부담을 크게 줄일 수 있습니다. D2C 결제 제공업체와 Unity IAP(인앱 구매)를 연동하려면 다음 단계를 완료하십시오.

Unity 에디터에서 환경 설정
원격 카탈로그 만들기
시작 시퀀스를 처리하기 위한 서비스 초기화
원격 카탈로그 페치하기
구매 이행을 위한 웹후크 또는 Cloud Code 모듈 구성(선택 사항)
지급 공급자 구성
로드 라우팅 규칙 설정
전체 구매
연동 테스트

중요

Apple과 Google은 현재 일부 지역에서 외부 웹 링크와 타사 결제를 지원합니다. 자격 요건, 수수료, 기술 요구 사항은 플랫폼과 지리적 시장에 따라 다르기 때문에 플랫폼과 지역별 요구 사항을 준수해야 합니다.

필수 조건

D2C 결제 제공업체를 IAP와 연동하려면 다음 요구 사항을 충족해야 합니다.

Unity 에디터 2022.3 이상이 설치되어 있습니다(Unity 6.0 이상 권장), 타겟 플랫폼용 빌드 지원 모듈(예:
- Android 빌드 지원
- iOS 빌드 지원
Unity 프로젝트에 연결된 클라우드 프로젝트입니다.

다음 패키지가 설치되어 있어야 합니다.

Install IAP v5.4.
- 자세한 내용은 IAP 버전 5로 업그레이드를 참고하십시오.
플레이어 ID를 관리할 수 있도록 Unity Authentication을 설치하고 구성합니다.
제품 카탈로그를 배포하려면 배포 패키지를 설치합니다.

중요

익명 로그인은 세션 토큰이 손실된 후 구매를 유지하지 않기 때문에 익명 로그인을 인증 방법으로 사용하지 않는 것이 좋습니다. 마찰이 없는 플랫폼별 공급자가 앱에서 실현할 수 없는 경우 애니메이션 인증 및 연결을 참조하십시오.

Unity 에디터 환경 설정

Unity 에디터 설정한 환경은 코드로 Unity Gaming Services를 초기화한 후 Unity IAP가 실행되는 위치를 정의합니다. 환경을 설정하려면 다음 단계를 따르십시오.

Unity 에디터에서 Edit > Project Settings > Services > Environments를 선택합니다.
IAP를 실행할 타겟 환경을 선택합니다. 개발, 스테이징 또는 생산

원격 카탈로그 생성

결제 제공업체를 사용하려면 Unity IAP 원격 카탈로그 서비스에 제품 카탈로그를 업로드해야 합니다. Remote Catalog 서비스를 사용하면 새 버전을 설치할 필요 없이 최신 제품을 사용자에게 제공할 수 있습니다. 원격 카탈로그를 생성하려면 다음을 수행합니다.

Unity IAP 상품 카탈로그를 생성합니다.
카탈로그를 Remote Catalog 서비스에 업로드합니다.

자세한 내용은 원격 카탈로그 생성을 참고하십시오.

서비스를 초기화하여 시작 시퀀스를 처리합니다.

IAP의 시작 시퀀스를 처리하기 위해 UGS(Unity Gaming Services)를 초기화하는 스크립트를 생성합니다. 이 시작 스크립트는 UGS를 초기화하고, 인증 이벤트를 처리하고, 플레이어를 로그인한 다음 IAP 초기화를 트리거합니다. 자세한 내용과 코드 예제는 시작 시퀀스를 처리하기 위한 서비스 초기화를 참고하십시오.

원격 카탈로그 가져오기

배포한 원격 카탈로그를 명시적으로 페치하려면

StoreController

에 연결되는 스크립트를 생성해야 합니다. 이 스크립트를 초기화 스크립트와 동일한 게임 오브젝트에 연결합니다. 자세한 내용과 코드 예제는 원격 카탈로그 페치를 참조하십시오.

구매 이행을 위한 Webhook 또는 Cloud Code 모듈 구성(선택 사항)

Unity IAP는 Apple과 Google이 해당 스토어의 자격을 처리하는 방식과 유사하게 오프 플랫폼 결제 제공업체의 자격을 관리합니다. 백엔드와 구매를 동기화하거나 서버 권한 부여 권한을 사용해야 하는 경우, 필요에 따라 구매 이벤트를 수신하도록 웹후크 또는 Cloud Code 모듈을 구성할 수 있습니다. 자세한 내용은 구매 이행을 위해 웹후크 또는 Cloud Code 모듈 설정을 참고하십시오.

결제 제공업체 구성

가격 책정 모델 또는 콘텐츠 유형과 같은 비즈니스 요구 사항에 따라 IAP에 사용할 지원 결제 제공업체를 선택할 수 있습니다. 외부 결제 제공업체와의 가격 책정 관리 및 계약을 담당합니다. 콘텐츠 유형 및 제한 사항에 대한 자세한 내용은 특정 결제 제공업체에 대한 기술 자료를 참고하십시오.

자세한 내용은 지급 공급자 설정을 참고하십시오.

라우팅 규칙 구성

결제 제공업체를 활성화하려면 공급자 라우팅 규칙을 정의해야 합니다. 라우팅을 사용하면 특정 플레이어 속성을 타게팅하여 각 플레이어에게 제공하는 결제 제공업체와 표시 순서를 결정할 수 있습니다. 자세한 내용은 레벨 추가를 참고하십시오.

구매 수행

플레이어가 구매를 완료하면 Unity IAP가 주문을 생성하고 해당 이행 상태를 트래킹합니다. 플레이어에게 구매를 허용한 후 구매를 확인(수행)해야 합니다.

중요

본인의 백엔드 시스템에서 자격을 관리하더라도 항상 Unity IAP로 주문을 이행된 것으로 표시해야 합니다. 소모품 제품의 경우 Unity IAP는 플레이어가 이전 주문이 이행될 때까지 동일한 아이템을 다시 구매하지 못하도록 방지합니다.

다음과 같은 방법으로 주문을 이행으로 표시할 수 있습니다.

메서드	사용 시	솔루션 결과
SDK를 통해	게임에서 클라이언트 측 권한을 부여하고 서버 권한이 우선 순위가 아닙니다.	게임 클라이언트가 구매 클라이언트 측에서 확인하고 IAP 서비스를 사실 소스로 사용합니다.
SDK와 함께 서버 확인	게임에는 서버 측 확인이 필요하지만, 웹후크를 관리하지 않으려는 경우가 있습니다.	백엔드는 클라이언트의 주문 ID를 사용하여 주문을 완료하기 전에 Unity IAP `GET API` 에서 구매 상태를 직접 가져옵니다.
백엔드 API를 통해	게임이 서버 권한 권한을 사용합니다.	백엔드는 웹후크 이벤트를 수신하고 시스템에서 권한을 부여하고, API 호출하여 주문이 충족된 것으로 표시합니다.
Cloud Code 모듈을 통해	게임은 자체 백엔드 인프라를 관리하지 않고도 자격과 이행에 서버 측 로직을 사용합니다.	게임은 Cloud Code 모듈과 엔드포인트를 사용하여 서버 측에서 구매 이벤트를 처리합니다.

SDK를 통한 구매 수행

Apple 및 Google 구매와 동일한 방법으로 게임 클라이언트에서 구매를 확인합니다. 플레이어에게 해당 권한을 부여한 후 클라이언트 코드가 각 주문에 대해

OnPurchasePending

콜백과 호출

ConfirmPurchase

를 처리해야 합니다. 이렇게 하면 순서가 확인되고 종료됩니다. 자세한 내용은 Unity IAP 구매 기술 자료를 참고하십시오.

중요

결제 제공업체의 경우

UnityIAPServices

또는

StoreController

에 호출할 때 상점 이름(

PaymentProvider.Name

)을 지정해야 합니다.

PaymentProvider.Name

는 직접 소비자 간 제공업체 통합을 지정하고 제공업체의 표시 이름을 반환하지 않습니다.

SDK와 서버 측 확인을 모두 사용하여 구매 수행

IAP SDK를 사용하여 구매를 수행하는 경우에도 백엔드 API 호출하여 구매 확인을 수행하여 서버 권한이 있는 워크플로를 구현할 수 있습니다. 자세한 내용은 SDK와 함께 서버 측 확인 사용을 참고하십시오.

백엔드 API 통해 구매 수행

게임에서 서버 권한 권한을 사용하는 경우 백엔드 시스템을 구현하여 권한을 관리하고 구매를 수행합니다. 자세한 내용은 백엔드 API를 통해 구매 완료를 참고하십시오.

Cloud Code 모듈을 사용하여 구매 수행

게임에서 서버 권한 권한을 사용하는 경우 Cloud Code 모듈을 사용하여 구매 이벤트를 확인하고 구매를 이행하고 주문 API 호출할 수 있습니다. 자세한 내용은 구매를 위해 Cloud Code 모듈 사용을 참고하십시오.

연동 테스트

연동이 제대로 작동하고 유저 구매를 성공적으로 수행할 수 있는지 테스트합니다. 자세한 내용은 통합 테스트를 참고하십시오.

외부 구매의 플랫폼 규정 준수

Unity는 Apple 또는 Google 플랫폼을 대신하여 규정 준수를 수행하지 않습니다. 외부 구매를 전송하기 전에 자격을 결정하고 각 플랫폼의 요구 사항을 충족해야 합니다. Unity는 규정 준수 콜백(

SetComplianceCheck

)과 웹후크 트랜잭션 토큰을 제공하여 자체 플로를 구현할 수 있도록 지원합니다. 자세한 내용은 Apple 및 Google 외부 구매 요구 사항 준수를 참고하십시오.

기능 지원

IAP는 현재 다음 기능을 지원하지 않습니다.

D2C 결제 제공업체를 통한 구독
D2C 거래에 대한 Unity 애널리틱스 지원
네이티브 Apple 및 Google 구매를 위한 관리되는 권한입니다.
사용자를 위한 대체 과금 옵션입니다.

기술 자료

Development

User Acquisition

Monetization

산업 분야