기술 자료

​
​

Development

User Acquisition

Monetization

산업 분야

In-App Purchasing

IAP 클라이언트 API

IAP SDK API

웹숍 관리자 API

웹숍 클라이언트 API

In-App Purchasing

LiveOps
​
​
시작하기
  • 개요
  • IAP 소개
  • IAP v5의 새로운 사항
  • IAP v4에서 v5로 업그레이드
소비자 (D2C)에 대한 직접 결제
  • 소비자 (D2C) 결제 제공업체에게 직접 제공
    • D2C 결제 공급자 워크플로 통합
      • Create Remote Catalog
      • Initialize services to handle the start up sequence
      • Fetch Remote Catalog
      • Configure a webhook or Cloud Code module for purchase fulfillment
      • Configure your payment provider
      • Add a routing rule
      • Fulfill purchases
      • Test your integration
    • 구매 시작
    • Apple 및 Google 외부 구매 요구 사항 준수
    • 딥 링크 성공 URL 예시
웹숍
  • 개요
  • 시작하기
  • 빌드 및 퍼블리시
  • 구성
  • 게임에 연결
  • 관리자
  • 웹숍 문제 해결
플랫폼 네이티브 스토어
  • 플랫폼 네이티브 스토어에 대한 IAP 설정
  • 코드리스 IAP
카탈로그 및 스토어 관리
  • 제품 카탈로그 생성
  • 지원되는 스토어
  • 레퍼런스
Purchases
  • 구매 관리 및 이행
IAP 성능 모니터링
  • 개요
  • IAP 수익 성과
  • D2C 성능
개인정보
  • 개인정보 보호 및 동의
  1. Unity 인앱 구매
  2. 소비자에게 직접 결제하는 (D2C) 제공업체

원격 카탈로그 가져오기

결제 제공업체 스토어의 원격 카탈로그를 가져옵니다.
읽는 시간 2분
최근 업데이트: 2달 전

배포한 원격 카탈로그를 명시적으로 가져오기 위해
StoreController
에 연결되는 스크립트를 생성해야 합니다. 이 스크립트를 초기화 스크립트와 동일한 게임 오브젝트에 연결합니다.
결제 제공업체 스토어의 원격 카탈로그를 가져오려면
RemoteCatalogProvider
을 인스턴스화한 다음
FetchRemoteCatalog
를 호출하여 Unity IAP 백엔드에서 제품을 가져와야 합니다.
그런 다음
RemoteCatalogProvider
를 사용하여 직접
FetchProducts
를 호출하거나
IProductService
또는
StoreController
에서 제품 목록을
FetchProducts
에 전달할 수 있습니다.

레퍼런스 정보

다음 요소는 결제 제공업체의 원격 카탈로그를 가져올 때 관련이 있습니다.

파라미터

설명

RemoteCatalogProvider
IAP와 함께 사용할 원격 카탈로그를 가져오는 데 사용되는 클래스입니다. 원격 카탈로그는 IAP 백엔드에서 얻습니다.
UnityIAPServices
IAP와의 커뮤니케이션을 위한 시작점입니다. 다음 서비스가 필요합니다.
  • StoreService
  • ProductService
  • PurchaseService
StoreController
이것은
UnityIAPServices
에 래퍼입니다. 단일 클래스와 상호작용하는 것을 선호하는 경우, 생성자에
storeName
를 전달합니다.
PaymentProvider.Name
이 식별자는
UnityIAPServices
및
StoreController
에서 D2C(Direct-to-Consumer) 결제 제공업체를 등록하는 데 사용됩니다. 이 필드는 구성 목적으로 사용되며 제공자의 표시 이름을 반환하지 않습니다.
중요
RemoteCatalogProvider
에 통화를 할 때 정확한 상점 이름을 지정해야 합니다. D2C 결제 제공업체의 경우
PaymentProvider.Name
입니다.

원격 카탈로그 가져오기 예제 스크립트

다음 예제 스크립트를 참고하십시오.
using System.Collections.Generic;using System.Threading.Tasks;using UnityEngine;using UnityEngine.Purchasing;public class PurchaseManager : MonoBehaviour{ StoreController m_StoreController; // Called by the ServiceOrchestrator after Auth is complete public async Task InitializeIAP() { m_StoreController = UnityIAPServices.StoreController(PaymentProvider.Name); m_StoreController.OnPurchasePending += OnPurchasePending; await m_StoreController.Connect(); m_StoreController.OnProductsFetched += OnProductsFetched; // 1. RemoteCatalogProvider 초기화 RemoteCatalogProvider catalogProvider = new RemoteCatalogProvider(); // 2. 결제 제공업체에 대해 명시적으로 카탈로그를 가져옵니다. var fetchRemoteCatalogResult = await catalogProvider.FetchRemoteCatalog(); if (!fetchRemoteCatalogResult.Success) fetchRemoteCatalogResult.Exception!;을 발생시킵니다. // 3. 원격 정의를 StoreController에 전달합니다. var productDefinitions = catalogProvider.GetProducts(); m_StoreController.FetchProducts(productDefinitions); } private void OnPurchasePending(PendingOrder 순서) { // Handle purchase validation and rewarding before confirming the order Debug.Log($"Order pending: {order.Info}"); } void OnProductsFetched(List<Product> products) { // Handle fetched products (e.g., populate UI) Debug.Log("Fetched products:"); foreach(제품의 각 제품) { Foreach (produ.catalogListings.Values의 var catalogListing) { Debug.Log($"ID: {catalogListing.definition.id} - Price: {catalogListing.metadata.localizedPriceString}"); } } }}

다음 단계

이 페이지는 IAP를 사용하여 D2C 결제 제공업체를 설정하는 워크플로의 일부입니다. 이 워크플로를 계속하려면 다음 옵션 중 하나를 선택합니다.
Integrate D2C payment providers
Integrate D2C payment providers with IAP 워크플로 페이지로 돌아갑니다.
Configure a webhook for purchase fulfillment
워크플로의 다음(선택) 단계로 이동하여 D2C 결제 제공업체를 설정합니다.

Copyright © 2026 Unity Technologies
법률 정보개인정보 처리방침쿠키Documentation Terms of Use개인 정보 판매 또는 공유 금지개인정보 보호 선택(쿠키 설정)

'Unity', Unity 로고 및 기타 Unity 상표는 미국 및 기타 지역 내 Unity Technologies 또는 그 계열사의 상표 또는 등록상표입니다(자세한 내용은 여기에서 확인하세요). 기타 명칭 또는 브랜드는 해당 소유자의 상표입니다.

일부 페이지는 편의를 위해 기계 번역되었으며 부정확한 내용이 있을 수 있습니다. 정보가 상충되는 경우, 영어 버전을 우선으로 참조하세요.

  • 보고 있는 페이지
    • 레퍼런스 정보

    • 원격 카탈로그 가져오기 예제 스크립트

    • 다음 단계


이 페이지의 문제 보고